接入 Claude Code

将 Claude Code 连接到 TokenCode，通过 Anthropic 兼容协议稳定调用 Claude、OpenAI、Gemini、DeepSeek 等模型。

适用场景

Claude Code 是 Anthropic 官方命令行编程助手，适合在终端里读代码、改文件、跑命令和处理开发任务。它原生使用 Anthropic Messages 协议，接入 TokenCode 时推荐使用 Anthropic 兼容端点。

安装 Claude Code

先确认已安装 Node.js，然后执行：

bash
npm install -g @anthropic-ai/claude-code
claude --version

Windows 用户建议在 WSL 或 Git Bash 中使用 Claude Code。

推荐方式：使用 TokenCode CLI 配置

安装 Claude Code 后，推荐先运行 TokenCode CLI 的交互式菜单向导：

bash
npm install -g @tokencode/tokencode
tokencode

在菜单中选择 Claude Code，按提示输入 TokenCode API Key 和默认模型即可。CLI 会自动写入 ~/.claude/settings.json。

如果你已经熟悉参数，也可以一键写入：

bash
npx @tokencode/tokencode cc -k sk-your-api-key -m claude-sonnet-4-6

CLI 会自动设置 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL 和 ANTHROPIC_MODEL，并保留你已有的其它 Claude Code 配置。

跳过首次登录

如果你只想使用 TokenCode 的 API Key，可以在 ~/.claude.json 中确认 hasCompletedOnboarding 为 true：

json
{
  "hasCompletedOnboarding": true
}

如果这个文件已经存在，请保留原有字段，只补充或确认这个字段即可。

手动配置

如果你不想使用 TokenCode CLI，也可以手动编辑配置文件。

编辑 ~/.claude/settings.json：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://tokencode.dev",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7"
  }
}
配置项 说明
ANTHROPIC_AUTH_TOKEN TokenCode API Key
ANTHROPIC_BASE_URL 固定为 https://tokencode.dev
ANTHROPIC_MODEL 默认模型 ID，可在模型列表中选择
ANTHROPIC_DEFAULT_*_MODEL Claude Code 内部按能力档位选择模型时使用

项目级配置也可以写到项目根目录的 .claude/settings.json，适合为不同项目指定不同模型。

验证配置

重新打开一个终端窗口，然后执行：

bash
claude "你好，请用一句话确认连接成功"

也可以在 Claude Code 中执行：

text
/status

重点检查 ANTHROPIC_BASE_URL 是否为 https://tokencode.dev，以及认证 token 是否已读取。

切换模型

你可以在启动时通过 --model 指定模型：

bash
claude --model claude-sonnet-4-6
claude --model gpt-5.5
claude --model gemini-2.5-pro
claude --model deepseek-chat

通过 TokenCode 调用非 Claude 模型时，平台会把 Claude Code 发出的 Anthropic Messages 请求转换为对应模型的协议，再把响应转换回 Claude Code 可识别的格式。

常见问题

启动后仍然连接 Anthropic 官方服务

通常是配置未生效。请检查：

  1. ~/.claude/settings.json 中是否使用了 ANTHROPIC_AUTH_TOKEN。
  2. ANTHROPIC_BASE_URL 是否为 https://tokencode.dev。
  3. 新终端窗口是否已重新打开。
  4. ~/.claude.json 中 hasCompletedOnboarding 是否为 true。

返回 401 或认证失败

请确认 API Key 完整、没有空格，并且当前账户仍有可用额度。Claude Code 读取的是 ANTHROPIC_AUTH_TOKEN，不是 OpenAI 协议里的 OPENAI_API_KEY。

模型不存在或无法调用

请到模型列表页确认模型 ID。若模型在其他客户端可用但 Claude Code 中失败，优先确认该模型是否适合通过 Anthropic 协议调用，或改用 Claude 原生模型排查。