api.anthropic.com,通过 ANTHROPIC_BASE_URL 环境变量可以直接改成 RuAPI 的地址 https://www.ruapi.ai,无需任何代理层。这样用不需要 Anthropic 的订阅,也不用登录 Anthropic 账号。
RuAPI 原生接收 Anthropic Messages 格式(/v1/messages),Claude Code 官方文档里,通过 ANTHROPIC_BASE_URL 接入的网关用的就是这种格式(见 LLM gateway protocol),所以不需要 claude-code-router、LiteLLM 这类转换工具。
更新于:2026-11-05
为什么在俄罗斯最好通过 RuAPI、而不是用 Anthropic 账号来用 Claude Code,简要说明见 www.ruapi.ai/claude-code-v-rossii;下面是具体设置步骤。
本页讲 直接配 RuAPI。如果你想用图形界面管理多个 provider,看 CC Switch。
前置条件
1
RuAPI 账号 + API key
没注册的先去 www.ruapi.ai 注册、用 USDT 充值。控制台 → 令牌管理 → 添加令牌 拿到一把
sk-...。详见 充值指南 和 API key 与安全。2
Node.js ≥ 22
最快的办法是在控制台复制现成的配置。 打开 控制台 → 令牌管理,点 接入 Claude Code、Cline 等工具,选 Claude Code:RuAPI 地址和你的密钥都已经填好。按下面的步骤装好程序,「把 Claude Code 接到 RuAPI」一节可以跳过。

控制台 → 令牌管理:「接入 Claude Code、Cline 等工具」按钮

「接入工具」窗口,选中 Claude Code:地址和密钥都已填好(截图里的密钥已打码)
安装 Claude Code
- macOS / Linux
- Windows
用 npm:装完确认版本:
把 Claude Code 接到 RuAPI
Claude Code 支持三种配置方式,按推荐度排列:方法一:写入 settings.json(推荐)
编辑 ~/.claude/settings.json(macOS / Linux)或 %USERPROFILE%\.claude\settings.json(Windows)。文件不存在就新建,把下面内容粘进去、换上你自己的 key:
为什么模型写在 model,不写 ANTHROPIC_MODEL
为什么模型写在 model,不写 ANTHROPIC_MODEL
环境变量
ANTHROPIC_MODEL 也能设模型,但它比 model 字段优先:只要设了它,在 /model 里选的默认模型重启后就会被改回去。如果旧配置的 env 里还留着 ANTHROPIC_MODEL,删掉它。为什么用 AUTH_TOKEN 而不是 ANTHROPIC_API_KEY
为什么用 AUTH_TOKEN 而不是 ANTHROPIC_API_KEY
ANTHROPIC_API_KEY 也能用(RuAPI 两种请求头都认),但用它的话,Claude Code 第一次启动会问你要不要用这把 key——一不小心选了「否」,请求就不走 RuAPI 了。用 ANTHROPIC_AUTH_TOKEN 不会有这个提问。旧变量 ANTHROPIC_SMALL_FAST_MODEL 官方已弃用,请改用 ANTHROPIC_DEFAULT_HAIKU_MODEL。方法二:环境变量
如果你只是临时试试,直接 export:- macOS / Linux (zsh / bash)
- Windows (PowerShell)
ANTHROPIC_MODEL 只管这个窗口。想长期使用请用方式 1:如果把 ANTHROPIC_MODEL 写进 ~/.zshrc 或 ~/.bashrc,在 /model 里选的默认模型就存不住了。方法三:用 CC Switch
如果你需要在 RuAPI 和官方账号之间反复切换,装 CC Switch 用 GUI 管理。第一次验证
新开一个终端窗口(让环境变量生效),随便进一个目录:用 /status 自查
在 Claude Code 里输入 /status:
Anthropic base URL一行应该显示https://www.ruapi.ai;Auth token一行应该是ANTHROPIC_AUTH_TOKEN。
settings.json。详见在俄罗斯用 Claude Code。
切换模型
会话内随时切:deepseek-flash、gpt-5.4-mini、gemini-3.8-flash、kimi-k3.1-pro、glm-5.3、qwen3.8-max、MiniMax-M3.1-Flash、grok-4.7:
/model 菜单会自动列出你这把 key 能用的这些模型;别家模型在菜单里带 anthropic/ 前缀(例如 anthropic/kimi-k3.1-pro),这是 Claude Code 的要求。/model 命令里带不带前缀都可以。完整列表和价格见 价格页。DeepSeek 有单独的教程:Claude Code 接 DeepSeek。
Claude Code 自带的联网搜索(WebSearch)用别家模型时不能用:这个工具不会传给它们。你自己的工具(运行命令、改文件、MCP)所有模型都能用。
怎么省钱
读代码、小改动、跑测试和日常问答,deepseek-flash 完全够用,价格只有 Claude Sonnet 的几分之一。把它设成主模型(settings.json 里写 "model": "deepseek-flash"),遇到难的任务(大重构、绕的 bug)再单独切换:
/model deepseek-flash 切回来;如果在 /model 菜单里把 Sonnet 设成了默认,记得在那里把默认改回 deepseek-flash,不然下次启动还是 Sonnet。最好在两个任务之间切,不要在一个任务中途切:每个模型的提示缓存是分开的,切换后长上下文第一次要按全价算。想让整个 Claude Code(包括后台小任务)都跑在 DeepSeek 上,看 Claude Code 接 DeepSeek;其他省钱办法见 Claude Code 和 Cline 省钱。
常见问题
Unable to connect to Anthropic services / Failed to connect to api.anthropic.com
Unable to connect to Anthropic services / Failed to connect to api.anthropic.com
有些版本的 Claude Code 第一次启动时会去连
api.anthropic.com,即使已经设了 ANTHROPIC_BASE_URL;在俄罗斯这个地址连不上。绕过的办法见在俄罗斯用 Claude Code。找不到模型(503)或 404
找不到模型(503)或 404
- 模型 ID 拼错。Claude 模型在 RuAPI 上的命名和 Anthropic 官方一致;所有模型的准确名字见
/model菜单或 价格页。 - 不要给
ANTHROPIC_BASE_URL加/v1。
403 / 余额不足
403 / 余额不足
控制台首页看 USD 余额,去 充值 充点 USDT 进来。长上下文 + 工具调用比较烧 token,建议先充 5~10 USD 试用。
连不上 / 网络超时
连不上 / 网络超时
- 检查能否连通:
curl -I https://www.ruapi.ai - 如果你在公司内网或者使用代理,确认
HTTPS_PROXY环境变量没把请求引到不通的地方。 - 不需要 VPN。
进阶
- MCP 服务器:Claude Code 的 MCP 配置和后端 API 无关,照常用即可。
- 工具调用 / Function calling:RuAPI 原样转发 Anthropic 的工具调用,行为完全一致。
- 流式 / SSE:默认开启,无需额外配置。
anthropic-version和anthropic-beta请求头:Claude Code 发出的这两个请求头都支持。- 提示缓存:
cache_control标记会传给 Anthropic 接口,见提示缓存。