Skip to main content
Claude Code 是 Anthropic 官方的命令行编码助手。它默认连 api.anthropic.com，通过 ANTHROPIC_BASE_URL 环境变量可以直接改成 RuAPI 的地址 https://www.ruapi.ai，无需任何代理层。这样用不需要 Anthropic 的订阅，也不用登录 Anthropic 账号。
本页讲 直接配 RuAPI。如果你想用图形界面管理多个 provider，看 CC Switch。

​
前置条件

1

RuAPI 账号 + API key

没注册的先去 www.ruapi.ai 注册、用 USDT 充值。控制台 → 令牌管理 → 添加令牌 拿到一把 sk-...。详见 充值指南 和 API key 与安全。
2

Node.js ≥ 22（用 npm 安装时需要）

用 npm 安装需要 Node.js 22 或更新版本。检查：
没装或版本太旧的话，去 nodejs.org 下载 LTS 版本，或者 macOS 用 Homebrew：
用下面的官方安装脚本则完全不需要 Node.js。

​
安装 Claude Code

用 npm：
或者用官方安装脚本（不需要 Node.js）：
装完确认版本：
如果你的网络打不开 claude.ai 的官方安装脚本，就用 npm 安装，效果一样。

​
把 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_API_KEY 也能用（RuAPI 两种请求头都认），但用它的话，Claude Code 第一次启动会问你要不要用这把 key——一不小心选了「否」，请求就不走 RuAPI 了。用 ANTHROPIC_AUTH_TOKEN 不会有这个提问。旧变量 ANTHROPIC_SMALL_FAST_MODEL 官方已弃用，请改用 ANTHROPIC_DEFAULT_HAIKU_MODEL。

​
方法二：环境变量

如果你只是临时试试，直接 export：
想永久生效，加进 ~/.zshrc 或 ~/.bashrc。

​
方法三：用 CC Switch

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

​
第一次验证

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

​
切换模型

会话内随时切：
可用模型列表见 价格页面。

​
常见问题

  • ANTHROPIC_AUTH_TOKEN 应该是你的 RuAPI 令牌（sk-...），不是 Anthropic 官方的 sk-ant-...。
  • 复制时小心末尾的空格或换行。
  • 在 RuAPI 控制台 → 令牌管理 确认这把 key 没被禁用，当前模型也没被这把 key 的「模型限制列表」排除（如果设置了的话）。
  • 模型 ID 拼错。Claude 模型在 RuAPI 上的命名和 Anthropic 官方一致，具体可用名见 价格页面。
  • 不要给 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：默认开启，无需额外配置。
更多 Claude Code 玩法看 官方文档。