Claude Code 接入腾讯云 Token Plan：配置步骤与实测

摘要： 在 Claude Code 中接入腾讯云 Token Plan，核心是改三个环境变量：ANTHROPIC_BASE_URL 填 https://tokenhub.tencentmaas.com/plan/anthropic、ANTHROPIC_AUTH_TOKEN 填 sk-tp 开头的 API Key、ANTHROPIC_MODEL 填套餐内模型 ID。配好后 claude 命令直接调用国产模型编码，按积分包月结算。

接入的本质，是把 Claude Code 默认指向的 Anthropic 官方网关，改指到腾讯云 Token Plan 的 Anthropic 兼容地址——改的只是 ~/.claude/settings.json 里的 env 字段，不碰你的官方 Anthropic 账号，也不改动任何代码逻辑。我的建议是优先用配置文件而非临时环境变量，这样重启终端、换项目都不会丢配置。配好后，claude 命令就跑在 Hy4 preview、DeepSeek、Kimi K3 等国产模型上，按月订阅、按积分计量，对于每天高频编码的人，这比官方按 token 计费更容易控制预算。

接入前要先准备什么

接入分两件事：一是有一个可用的 Token Plan 套餐和 API Key，二是本机装好 Claude Code。

Token Plan 是腾讯云大模型服务平台 TokenHub 面向个人的订阅套餐，分通用 Token Plan（集合 DeepSeek、GLM、Kimi、MiniMax、混元等国产模型）和 Hy Token Plan（腾讯自研混元模型）两个系列，各有 Lite / Standard / Pro / Max 四档，按月付费、按积分计量。两个套餐共用同一个 API Key，格式为 sk-tp-xxx。

API Key 在控制台的 Token Plan 页面点「生成密钥」获得。每个主账号只能生成一个 API Key，通用和 Hy 两套餐共用，重置后旧 Key 会在 5 分钟内失效，所以生成后请复制保存好。

Claude Code 通过 npm 安装，依赖 Node.js（建议 18 及以上版本）。Windows 用户还需要先装 WSL 或 Git for Windows。

安装 Claude Code 并确认版本

在终端执行安装命令：

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

装完后查看版本号，能正常输出版本即安装成功：

claude --version

修改 settings.json 完成接入

Claude Code 的模型配置放在 settings.json 的 env 字段里。不同系统的文件路径不同：

如果文件不存在，可以手动新建，或在终端执行创建命令。macOS / Linux：

mkdir -p ~/.claude && touch ~/.claude/settings.json

Windows（PowerShell）：

New-Item -ItemType Directory -Force -Path "$HOME\.claude" | Out-Null; New-Item -ItemType File -Force -Path "$HOME\.claude\settings.json" | Out-Null

接入 Token Plan 需要配置三个环境变量，含义如下：

在 settings.json 写入：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "<你的_API_KEY>",
        "ANTHROPIC_BASE_URL": "https://tokenhub.tencentmaas.com/plan/anthropic",
        "ANTHROPIC_MODEL": "<模型_ID>"
    }
}

模型 ID 必须用全小写，且要属于你订阅的套餐。这里有个实用的搭配建议：编码任务我优先推 kimi-k2.7-code（专为代码调优）和 deepseek-v4-pro-202606（复杂推理强），日常轻量改动用 glm-5.3-flash 更省积分；Hy Token Plan 则填 hy3 或 hy4-preview。最常见的翻车点，是把通用套餐的模型 ID 填进 Hy 套餐、或大小写写错——填了套餐不支持的模型 ID，调用会直接报错，而不是自动降级。

让 Claude Code 跳过引导直接可用

首次使用 Claude Code 会进入初始化引导。要让配置直接生效，需要新建或编辑 .claude.json，把 hasCompletedOnboarding 设为 true。

路径同样分系统：macOS / Linux 为 ~/.claude.json，Windows 为 C:\Users\<用户名>\.claude.json。写入：

{
  "hasCompletedOnboarding": true
}

保存后，务必打开一个新的终端窗口再执行后续命令，否则环境变量不会加载。

启动并实测调用是否生效

进入任意项目目录，执行 claude 启动：

cd my-project
claude

启动时选择 Yes, I trust this folder 信任当前目录。随后在对话框输入任意问题，例如「用 Python 写一个快速排序」，若能正常返回代码，说明 Token Plan 已接入成功、积分开始计量。

想确认请求确实走到了 Token Plan，可在 Claude Code 中输入 /status 查看。当 API Endpoint 显示为 Token Plan 的地址、Model 显示为你配置的模型时，即表示配置生效。

在 VS Code 里用 Claude Code

Claude Code 的 IDE 插件依赖 CLI，所以要先完成上面的安装和配置。之后在 VS Code 扩展市场搜索 Claude Code 安装，点右上角图标进入对话面板。切换模型时在对话框输入 /，选择 General config，在 Selected Model 里选你套餐支持的模型，新开窗口即可对话。

配置多个模型按档位切换

Claude Code 内部有 haiku / sonnet / opus 三个档位。可以给每个档位映射不同的套餐模型，日常用轻量模型、复杂任务用强模型：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<你的_API_KEY>",
    "ANTHROPIC_BASE_URL": "https://tokenhub.tencentmaas.com/plan/anthropic",
    "ANTHROPIC_MODEL": "kimi-k2.7-code",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.3-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.7-code",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro-202606"
  }
}

ANTHROPIC_MODEL 是启动默认模型，三个 DEFAULT_*_MODEL 分别对应三个档位别名。模型 ID 以 Token Plan 可用模型页面为准。

子代理报错时补一个变量

Claude Code 在代码检索、任务规划时会调用 Explore、Plan 等内置子代理。一般对话用不到，但若执行任务时出现 Model ... is not supported by TokenPlan、API Error: 403、API Error: 500 这类报错，在 env 里补上 CLAUDE_CODE_SUBAGENT_MODEL，值填一个套餐支持的模型 ID，建议与 ANTHROPIC_MODEL 一致：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<你的_API_KEY>",
    "ANTHROPIC_BASE_URL": "https://tokenhub.tencentmaas.com/plan/anthropic",
    "ANTHROPIC_MODEL": "<模型_ID>",
    "CLAUDE_CODE_SUBAGENT_MODEL": "<模型_ID>"
  }
}

改完重开终端或重启 Claude Code 生效。配置成功不会单独提示，可通过触发 Explore、Plan 子任务验证。

接入失败时的常见原因

遇到报错时，对照下面几种高频情况排查：

还有一点要注意：个人版 Token Plan 面向交互式使用，仅生成一个 API Key，且禁止账号共享、禁止把 Key 用于自动化脚本或应用后端的批量调用。在 Claude Code 里手动编码属于标准用法，放心使用。若你需要稳定的 API 批量调用能力，应选择 Token Plan 企业版。

完成本教程还需要什么

跑通 Claude Code 后，这几件事能让体验更完整：

• 选对模型：编码任务优先试 kimi-k2.7-code、deepseek-v4-pro-202606；追求低成本可用 glm-5.3-flash。
• 盯住积分：在控制台 Token Plan 页面看当前周期用量，积分按订阅月刷新，不结转。
• 选够档位：轻度体验选 Lite，日常高频编码选 Pro 或 Max，套餐只能升配不能降配。

想了解各档套餐的积分额度和适用场景，可前往腾讯云 Token Plan 页面查看并订阅：https://cloud.tencent.com/act/pro/tokenplan