跳转到主要内容
Claude Code 是 Anthropic 官方的命令行编码助手。它默认连 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 用 npm 安装,需要 Node.js 22 或更新版本。检查:
没装或版本太旧的话,去 nodejs.org 下载 LTS 版本,或者 macOS 用 Homebrew:
最快的办法是在控制台复制现成的配置。 打开 控制台 → 令牌管理,点 接入 Claude Code、Cline 等工具,选 Claude Code:RuAPI 地址和你的密钥都已经填好。按下面的步骤装好程序,「把 Claude Code 接到 RuAPI」一节可以跳过。
RuAPI 令牌管理页:地址 https://www.ruapi.ai 和「接入 Claude Code、Cline 等工具」按钮

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

RuAPI 控制台「接入工具」窗口里 Claude Code 的现成配置

「接入工具」窗口,选中 Claude Code:地址和密钥都已填好(截图里的密钥已打码)

安装 Claude Code

用 npm:
装完确认版本:
Claude Code 在 claude.ai 上的官方安装脚本(install.sh、install.ps1、install.cmd)在俄罗斯用不了:claude.ai 会跳到「本地区不可用」的页面(claude.com/app-unavailable-in-region)。请用 npm 安装:安装包和程序都从 registry.npmjs.org 下载,装出来的程序是一样的。2026-11-03 我们实测,这个地址在俄罗斯不开 VPN 也能访问。如果 Claude Code 提示改用原生安装(claude install),不要同意:它同样要从 claude.ai 下载。

把 Claude Code 接到 RuAPI

Claude Code 支持三种配置方式,按推荐度排列:

方法一:写入 settings.json(推荐)

编辑 ~/.claude/settings.json(macOS / Linux)或 %USERPROFILE%\.claude\settings.json(Windows)。文件不存在就新建,把下面内容粘进去、换上你自己的 key:
ANTHROPIC_BASE_URL 末尾 不要 加 /v1。Anthropic SDK 会自动拼接 /v1/messages,多写 /v1 会导致 404。
环境变量 ANTHROPIC_MODEL 也能设模型,但它比 model 字段优先:只要设了它,在 /model 里选的默认模型重启后就会被改回去。如果旧配置的 env 里还留着 ANTHROPIC_MODEL,删掉它。
ANTHROPIC_API_KEY 也能用(RuAPI 两种请求头都认),但用它的话,Claude Code 第一次启动会问你要不要用这把 key——一不小心选了「否」,请求就不走 RuAPI 了。用 ANTHROPIC_AUTH_TOKEN 不会有这个提问。旧变量 ANTHROPIC_SMALL_FAST_MODEL 官方已弃用,请改用 ANTHROPIC_DEFAULT_HAIKU_MODEL。

方法二:环境变量

如果你只是临时试试,直接 export:
这里的 ANTHROPIC_MODEL 只管这个窗口。想长期使用请用方式 1:如果把 ANTHROPIC_MODEL 写进 ~/.zshrc 或 ~/.bashrc,在 /model 里选的默认模型就存不住了。

方法三:用 CC Switch

如果你需要在 RuAPI 和官方账号之间反复切换,装 CC Switch 用 GUI 管理。

第一次验证

新开一个终端窗口(让环境变量生效),随便进一个目录:
进入交互界面后,问一句最简单的问题:
正常应该立刻得到 Claude 的回复,并且 RuAPI 控制台 → 使用日志 里能看到对应记录、扣了几个 token 的费用。
如果你想确认调用真的走了 RuAPI,去 RuAPI 控制台 → 使用日志 看时间戳最新的那条请求,模型名应该是你配置的模型。

用 /status 自查

在 Claude Code 里输入 /status:
  • Anthropic base URL 一行应该显示 https://www.ruapi.ai;
  • Auth token 一行应该是 ANTHROPIC_AUTH_TOKEN。
没有地址那一行,说明环境变量没生效:新开一个终端,或检查 settings.json。详见在俄罗斯用 Claude Code。

切换模型

会话内随时切:
除了 Claude,Claude Code 里也能用别家的模型:DeepSeek、GPT、Gemini、Kimi、GLM、Qwen、MiniMax 和 Grok。Claude Code 发的是 Anthropic Messages 格式的请求,RuAPI 会自己转成各家模型认的格式。每一家我们都用 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 省钱。

常见问题

有些版本的 Claude Code 第一次启动时会去连 api.anthropic.com,即使已经设了 ANTHROPIC_BASE_URL;在俄罗斯这个地址连不上。绕过的办法见在俄罗斯用 Claude Code。
  • ANTHROPIC_AUTH_TOKEN 应该是你的 RuAPI 令牌(sk-...),不是 Anthropic 官方的 sk-ant-...。
  • 复制时小心末尾的空格或换行。
  • 在 RuAPI 控制台 → 令牌管理 确认这把 key 没被禁用,当前模型也没被这把 key 的「模型限制列表」排除(如果设置了的话)。
  • 模型 ID 拼错。Claude 模型在 RuAPI 上的命名和 Anthropic 官方一致;所有模型的准确名字见 /model 菜单或 价格页。
  • 不要给 ANTHROPIC_BASE_URL 加 /v1。
控制台首页看 USD 余额,去 充值 充点 USDT 进来。长上下文 + 工具调用比较烧 token,建议先充 5~10 USD 试用。
  • 检查能否连通:curl -I https://www.ruapi.ai
  • 如果你在公司内网或者使用代理,确认 HTTPS_PROXY 环境变量没把请求引到不通的地方。
  • 不需要 VPN。
用 CC Switch 一键切,或者用 direnv 给不同项目目录绑定不同的环境变量。

进阶

  • MCP 服务器:Claude Code 的 MCP 配置和后端 API 无关,照常用即可。
  • 工具调用 / Function calling:RuAPI 原样转发 Anthropic 的工具调用,行为完全一致。
  • 流式 / SSE:默认开启,无需额外配置。
  • anthropic-version 和 anthropic-beta 请求头:Claude Code 发出的这两个请求头都支持。
  • 提示缓存:cache_control 标记会传给 Anthropic 接口,见提示缓存。
更多 Claude Code 玩法看 官方文档。