Claude Code

Claude Code 适合通过 TokenHub 的 Anthropic Claude Messages 兼容接口接入。TokenHub 的 Messages 地址是 https://us-api.tokenhub.com/v1/messages，但 Claude Code 会自己拼接接口路径，所以配置里的 Base URL 填 https://us-api.tokenhub.com，不要额外拼 /v1/messages。

本文以官方支持的用户级 ~/.claude/settings.json 为主。~/.claude.json 和 VS Code 插件环境变量可以作为可选补充，用于处理首次 onboarding 或插件没有继承 CLI 配置的情况。临时环境变量只用于快速验证和排错，不作为推荐的长期接入方式。

适合场景

Claude Code 更适合仓库级任务：阅读项目、修改代码、运行测试、解释报错和拆分开发计划。首次接入建议先在一个有 Git 管理的小仓库里验证，确认请求、模型和权限都正常后，再用于真实项目。

安装 Claude Code

先参考 Claude Code 官方安装文档。Claude Code 依赖 Node.js，建议使用 Node.js 18 或更新版本。

常见安装方式如下，任选与你环境匹配的一种：

# macOS / Linux，使用官方安装脚本
curl -fsSL https://claude.ai/install.sh | bash

# 或使用 npm 安装
npm install -g @anthropic-ai/claude-code

安装完成后确认命令可用：

claude --version

如果命令找不到，重开终端，或确认 npm/global bin、Homebrew bin 已经加入 PATH。Windows 用户建议在 WSL 或 Git Bash 中使用 Claude Code，并先确认 Node.js、Git 和网络代理配置正常。

准备 TokenHub 凭证

在 TokenHub 工作台创建 API Key，并在模型列表中选择一个 Claude 兼容模型。本文示例使用：

不要把 API Key 写入项目仓库。下面的配置文件位于用户主目录，只影响当前系统用户；如果是多人共用设备，建议为文件设置仅本人可读写权限。

配置 Claude Code CLI

1. 创建用户级 settings.json

创建或编辑 Claude Code 用户配置文件：

如果 .claude 目录不存在，先创建目录：

mkdir -p ~/.claude

在 settings.json 中写入 TokenHub 模型和环境变量：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4",
  "env": {
    "ANTHROPIC_BASE_URL": "__API_BASE_URL__",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "claude-sonnet-4",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-sonnet-4",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-3-5-haiku-latest"
  }
}

把 sk-... 换成 TokenHub API Key，把模型名换成 TokenHub 模型列表里真实可用的 Claude 兼容 Model ID。

字段含义如下：

这里使用 ANTHROPIC_AUTH_TOKEN，因为 TokenHub 的鉴权方式是 Bearer Token。不要在教程示例里同时写 ANTHROPIC_API_KEY；如果你本机已有旧的 Anthropic 官方 Key，启动前清理掉，避免 Claude Code 读取到旧配置。

如果你不想在文件里明文保存 Key，可以先用临时环境变量验证；长期使用时再结合系统钥匙串、密码管理器或团队密钥管理方案生成该文件。确认文件只在本机使用后，可以限制权限：

chmod 700 ~/.claude
chmod 600 ~/.claude/settings.json

2. 可选：处理首次 onboarding

如果 Claude Code 首次启动时要求登录 Anthropic 或卡在 onboarding，可以创建或编辑用户级 .claude.json：

写入：

{
  "hasCompletedOnboarding": true
}

这不是 TokenHub 网关的核心配置。已经能正常启动 claude 的用户可以跳过这一步。

3. 清理冲突环境变量

如果你之前使用过 Anthropic 官方服务，终端里可能残留旧变量。启动 Claude Code 前先检查：

env | grep ANTHROPIC

如果看到旧的 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY，需要删除或更新它们，避免覆盖 settings.json 中的 TokenHub 配置。

临时环境变量验证

如果只是排查网络、Key 或模型名，也可以在当前终端临时设置：

export TOKENHUB_API_KEY="sk-..."
export ANTHROPIC_BASE_URL="__API_BASE_URL__"
export ANTHROPIC_AUTH_TOKEN="$TOKENHUB_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-sonnet-4"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-3-5-haiku-latest"

这种方式只对当前终端有效，关闭窗口后会失效。教程和团队交付文档建议优先写配置文件。

启动 Claude Code

重新打开终端，进入项目目录后启动：

cd /path/to/your/repo
claude

首次进入项目时，如果 Claude Code 提示是否信任当前文件夹，选择信任后再继续。启动后可以执行：

/status

确认当前模型和环境变量已经指向 TokenHub。随后先使用只读问题：

请阅读 README，并用三句话总结这个项目。不要修改文件。

确认能正常回答后，再让 Claude Code 执行会修改文件或运行命令的任务。

在 VS Code 插件中使用

如果你使用 Claude Code 的 VS Code 插件，优先让插件复用 CLI 的 ~/.claude/settings.json。如果插件没有读取到 CLI 配置，可以在 VS Code 用户级 settings.json 中单独写环境变量。

打开 VS Code 设置，搜索 Claude Code 相关配置，或直接编辑用户级 settings.json，加入：

{
  "claudeCode.preferredLocation": "panel",
  "claudeCode.selectedModel": "claude-sonnet-4",
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "__API_BASE_URL__"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-..."
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "claude-sonnet-4"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "claude-sonnet-4"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "claude-3-5-haiku-latest"
    }
  ]
}

如果你从终端启动 VS Code：

code .

插件更容易继承当前 shell 的配置。若仍然不生效，先用终端版 claude 排除 TokenHub 配置问题，再检查 VS Code 用户设置和工作区设置是否互相覆盖。

验证请求是否走 TokenHub

你可以按这个顺序验证：

1. 检查 ~/.claude/settings.json 中的 Base URL、Key、模型名是否正确。
2. 重新打开终端后运行 claude。
3. 执行 /status，确认当前模型是 TokenHub 中配置的 Model ID。
4. 提出一个只读问题，例如总结 README。
5. 在 TokenHub 请求日志中确认请求目标模型、接口路径和用量。
6. 再测试文件读取、代码修改和测试命令。

常见问题