跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

Claude Code 是 Anthropic 官方的命令行编码助手。它默认连 api.anthropic.com，通过 ANTHROPIC_BASE_URL 环境变量可以直接改成 RuAPI 的端点，无需任何代理层。
本页讲 直接配 RuAPI。如果你想用图形界面管理多个 provider，看 CC Switch。

​
前置条件

1

RuAPI 账号 + API key

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

Node.js ≥ 18

Claude Code 需要 Node.js 18 以上。检查：
node --version
没装的话，去 nodejs.org 下载 LTS 版本，或者 macOS 用 Homebrew：
brew install node

​
安装 Claude Code

npm install -g @anthropic-ai/claude-code
装完确认版本：
claude --version

​
配置 RuAPI 端点

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

​
方法一：写入 settings.json（推荐）

编辑 ~/.claude/settings.json（macOS / Linux）或 %USERPROFILE%\.claude\settings.json（Windows）。文件不存在就新建： 
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.ruapi.ai",
    "ANTHROPIC_API_KEY": "sk-你的KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5"
  }
}
ANTHROPIC_BASE_URL 末尾 不要 加 /v1。Anthropic SDK 会自动拼接 /v1/messages，多写 /v1 会导致 404。
字段含义
ANTHROPIC_BASE_URLRuAPI 端点
ANTHROPIC_API_KEY你的 RuAPI 令牌（注意：不是 Anthropic 官方 key）
ANTHROPIC_MODEL默认用哪个 Claude 模型，claude-sonnet-4-6 是性价比最佳选择
ANTHROPIC_SMALL_FAST_MODELClaude Code 内部一些轻量任务（标题生成、文件路径解析）走的小模型，建议设成 claude-haiku-4-5 省钱

​
方法二：环境变量

如果你只是临时试试，直接 export： 
export ANTHROPIC_BASE_URL="https://www.ruapi.ai"
export ANTHROPIC_API_KEY="sk-你的KEY"
claude
想永久生效，加进 ~/.zshrc 或 ~/.bashrc。

​
方法三：用 CC Switch

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

​
第一次验证

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

​
切换模型

会话内随时切： 
/model claude-opus-4-7
/model claude-haiku-4-5
可用模型列表见 模型广场。

​
常见问题

  • ANTHROPIC_API_KEY 应该是你的 RuAPI 令牌（sk-...），不是 Anthropic 官方的 sk-ant-...。
  • 复制时小心末尾的空格或换行。
  • 在 RuAPI 控制台 → 令牌 确认这把 key 没被禁用，也没把当前模型从「可访问模型」白名单里漏掉。
  • 模型 ID 拼错。Claude 模型在 RuAPI 上的命名和 Anthropic 官方一致，常用：claude-sonnet-4-6、claude-opus-4-7、claude-haiku-4-5。
  • 不要给 ANTHROPIC_BASE_URL 加 /v1。
控制台首页看 USD 余额，去 充值 充点 USDT 进来。Claude Code 默认对话有 token 消耗，长上下文 + 工具调用比较烧 token，建议先充 5~10 USD 试用。
  • 检查能否 ping 通：curl -I https://www.ruapi.ai
  • 如果你在公司内网或者使用代理，确认 HTTPS_PROXY 环境变量没把请求引到不通的地方。
  • 不需要 VPN，直接走国内网络即可。
用 CC Switch 一键切，或者用 direnv 给不同项目目录绑定不同的环境变量。

​
进阶

  • MCP 服务器：Claude Code 的 MCP 配置和后端 API 无关，照常用即可。
  • 工具调用 / Function calling：RuAPI 默认全部转发给上游 Anthropic，行为完全一致。
  • 流式 / SSE：默认开启，无需额外配置。
更多 Claude Code 玩法看 官方文档。