← 返回文章列表

READING MODE

Claude Code 国内安装（更新版·更简单·基于腾讯云 Token Plan）

·10 分钟
claude-codetutorialchina

这篇教程带你在国内装好 Claude Code 并接入国产模型。订阅腾讯云 Token Plan（¥7.9/月起），Claude Code 原生对接腾讯云的 Anthropic 兼容端点——一套订阅里 GLM-5.1、Kimi-K2.5、MiniMax 随便切。

预计耗时：10 分钟。全程不需要翻墙，不需要海外信用卡。

为什么选这条路？

  • 极简配置：只改两个 JSON 文件，启动命令就是原生 claude，改配置重启 claude 就生效，没有后台服务要管
  • 多模型一站式：一个订阅通吃 GLM-5.1、Kimi-K2.5、MiniMax，改一个字段就能切；还有 Auto 模式自动路由
  • 稳定省心：腾讯云主流 SaaS，账单清楚、有发票，适合团队或长期使用
  • 便宜入门：新用户 Lite 套餐首月 ¥7.9（正价 ¥39/月，3500 万 tokens）

想完全免费（但折腾一点）的方案，见 老版完全指南。

第一步：装好 Claude Code

Windows 和 Mac 都支持，下面分开讲。如果你已经装好 Node.js 和 Claude Code（claude --version 有版本号），跳到第二步。

Windows

1. 打开 PowerShell：按 Win 键 → 输入 PowerShell → 回车（不需要管理员权限）。

2. 装 Git（Claude Code 在 Windows 上依赖 Git）：先跑 git --version，没有就从 清华镜像 下 Git-*-64-bit.exe，一路 Next 即可。

3. 装 Node.js：node -v 没有就去 nodejs.org 下 Windows .msi 安装包（LTS 版）。

4. 如果 npm 报"禁止运行脚本"，解除限制：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

输入 Y 回车确认。

5. 装 Claude Code：

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

⚠️ 别用淘宝镜像（registry.npmmirror.com）装 Claude Code。镜像对 Claude Code 用的 "optional dependencies" 同步不完整，会出现 Native package claude-code-win32-x64 not found 错误，装出来的 claude.exe 无法运行。如果你的 npm 已经配了淘宝镜像，这条命令加上 --registry=https://registry.npmjs.org 走一次官方 registry：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmjs.org

官方 registry 国内访问会慢一些（几十秒到几分钟），但能拿到正确的原生二进制。

6. 关闭 PowerShell 重新打开，验证：

claude --version

看到版本号 = 成功。

Mac

1. 打开终端：Command + 空格 → 输入 终端 → 回车。

2. 检查 Git：git --version。没有的话，系统会自动弹窗让你装"命令行开发者工具"，点"安装"等几分钟即可。

3. 装 Node.js：node -v 没有就去 nodejs.org 下 macOS .pkg 安装包，或者 brew install node。

4. 装 Claude Code（二选一）：

方式一 · Homebrew（推荐，最稳）：

brew install --cask claude-code

方式二 · npm：

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

⚠️ 如果你的 npm 之前配过淘宝镜像，这里要走一次官方 registry——镜像同步 optional dependencies 不完整，会装出跑不起来的 claude。命令改成：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmjs.org

5. 关闭终端重新打开，验证：

claude --version

看到版本号 = 成功。如果提示 command not found，把 ~/.local/bin 加入 PATH：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

⚠️ 不管哪个平台，装完都先别运行 claude——它会要求登录 Anthropic 账号。下面三步用环境变量绕过登录，直连腾讯云。想要更细的安装说明和故障排查，可以参考 老版完全指南。

第二步：订阅腾讯云 Token Plan

Token Plan 是腾讯云为 AI 编程工具推出的订阅套餐，一套订阅里可以在 GLM、Kimi、MiniMax 等多家模型之间自由切换，还支持 Auto 模式自动路由。

套餐档位

档位价格月 tokens适合
Lite¥39（新用户首月 ¥7.9）3500 万入门尝鲜
Standard¥991 亿日常开发
Pro¥2993.2 亿高频编程
Max¥5996.5 亿重度生产

建议新用户先上 Lite（¥7.9 尝鲜价），3500 万 tokens 够写几千行代码，体验好再升级。

订阅 + 拿 API Key

  1. 打开 console.cloud.tencent.com/tokenhub/tokenplan
  2. 用腾讯云账号登录（微信/QQ 扫码都行；新账号需要实名认证）
  3. 选 Lite 档位订阅付款
  4. 订阅后进控制台生成 API Key，复制保存

Key 可以反复查看，忘了回控制台再看就行。

第三步：配置 ~/.claude/settings.json

这是 Claude Code 的全局配置文件，没有就创建一个：

Windows

New-Item -ItemType Directory -Path "$env:USERPROFILE\.claude" -Force
notepad "$env:USERPROFILE\.claude\settings.json"

Mac

mkdir -p ~/.claude
nano ~/.claude/settings.json

粘贴以下内容，把 your-tencent-key 换成第二步拿到的 Key：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lkeap.cloud.tencent.com/plan/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your-tencent-key",
    "ANTHROPIC_MODEL": "glm-5.1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

保存。Mac 上 nano 按 Ctrl+O 回车保存，Ctrl+X 退出。

字段说明

  • ANTHROPIC_BASE_URL：腾讯云的 Anthropic 兼容端点（固定值，别改）
  • ANTHROPIC_AUTH_TOKEN：你的腾讯云 Token Plan API Key（注意字段名是 AUTH_TOKEN 不是 API_KEY）
  • ANTHROPIC_MODEL：默认模型，可选 auto、glm-5、glm-5.1、kimi-k2.5、minimax-m2.5、minimax-m2.7。注意全部小写——腾讯云文档虽然用 GLM-5.1 这种显示名，但 API 只认小写，大写会返回 400 Invalid model
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC：关掉 Claude Code 给 Anthropic 的遥测请求，避免超时

第四步：创建 ~/.claude.json（别忘，腾讯云方案特有）

腾讯云这条路需要再建一个文件，告诉 Claude Code 跳过新用户引导，否则启动会弹登录提示：

Windows

notepad "$env:USERPROFILE\.claude.json"

Mac

nano ~/.claude.json

粘贴：

{
  "hasCompletedOnboarding": true
}

保存。注意这个是 .claude.json（文件名前一个点），和第三步的 .claude/settings.json 是两个不同的文件，别搞混。

第五步：启动

在终端里进入项目目录（或任意文件夹），直接运行：

claude

出现 claude> 提示符后，输入：

/status

看到 API Configuration 显示 api.lkeap.cloud.tencent.com = 成功。

试一把：

> 帮我写一个 Python 的 hello world 程序并保存到 hello.py

生成代码并创建文件 = 一切就绪。

切换模型（腾讯云方案的杀手锏）

因为一套订阅包含所有模型，切换只要改 settings.json 里的 ANTHROPIC_MODEL：

  • auto：系统根据任务自动路由（懒人首选）
  • glm-5.1：SWE-Bench Pro 58.4 分，2026 年国产编程能力之巅
  • kimi-k2.5：128K 超长上下文，适合大型代码库
  • minimax-m2.7：综合能力强，速度快

改完字段保存，退出 claude 重新运行即可生效——没有后台服务要 restart。

项目级覆盖

想在不同项目用不同模型？项目根目录建一个 .claude/settings.json，会覆盖全局配置。比如重构老代码用 Kimi-K2.5 看全貌，写新功能用 GLM-5.1。

⚠️ 重要限制

腾讯云 Token Plan 官方明确说明"仅限在 AI 工具中使用，禁止以 API 调用的形式用于自动化脚本"。正常跑 Claude Code、OpenCode、Cursor 等交互式工具完全没问题，但不要包装成后端服务给别人用，否则会被封号。

常见问题

启动 claude 还是要求登录 Anthropic

第四步的 ~/.claude.json 忘了建，或文件名写错（应该是 .claude.json，前面有点）。Windows 上确认路径是 C:\Users\你的用户名\.claude.json。

/status 显示的还是 Anthropic 官方端点

settings.json 路径不对或者 JSON 格式错了。路径应该是：

  • Windows：C:\Users\你的用户名\.claude\settings.json（注意 .claude 是文件夹，前面有点）
  • Mac：~/.claude/settings.json

JSON 有问题可以贴到 jsonlint.com 验证语法。常见错误是尾逗号和中文引号。

401 / 403 错误

Key 填错或者被填成了 ANTHROPIC_API_KEY——腾讯云只认 ANTHROPIC_AUTH_TOKEN 这个字段名。去 腾讯云控制台 重新查一下 Key。

400 错误：Invalid model

最常见原因是模型名大小写错了——腾讯云 Token Plan 的 API 只认小写。虽然官方文档里写成 GLM-5.1、Kimi-K2.5，但在 settings.json 的 ANTHROPIC_MODEL 里必须写 glm-5.1、kimi-k2.5。改成小写，退出 claude 重开就行。

如果确定是小写还被拒，可能是这个模型你的套餐还没开放——换成 auto 验证一下：auto 所有档位都支持。

claude.exe 报"不是此操作系统平台的有效应用程序"

npm 装了坏包（常见于失败的更新留下残骸）。清干净重装：

npm uninstall -g @anthropic-ai/claude-code
npm cache clean --force
npm install -g @anthropic-ai/claude-code

套餐 tokens 用完了

控制台可以直接升档（Lite → Standard → Pro），按月付费。单次请求价格按实际使用的模型算，auto 模式会自动挑便宜的——日常编程 Lite 3500 万够不少人用一个月。

想切回免费方案

把 ~/.claude/settings.json 的 env 字段整段删掉或注释掉（让它不覆盖其他工具的配置），然后参考 老版完全指南 即可。~/.claude.json 保留不影响使用，两套配置可以并存在同一台机器上。