帮你快速理解、总结文档立即下载
文档中心>负载均衡>模型路由>用户指南>AI 工具接入>Claude code

Claude code

最近更新时间：2026-08-26 17:45:45
我的收藏

本页目录：

Claude Code 是一款运行在终端中的 AI 编程工具，可以通过自然语言辅助开发者编码、调试和管理代码。本文介绍如何在 Claude Code 中配置使用腾讯云模型路由 CMR。

安装 Claude Code

根据本地环境安装 Claude Code。操作详情请参见 Claude Code 文档。如果已安装 Claude Code，可以跳过此步骤。
安装完成后，执行以下命令查看版本。终端显示版本号，表示安装成功。
claude --version

获取 API Key

登录 模型路由 控制台，创建模型路由 API Key。操作详情请参见 创建模型路由访问密钥。
注意：
创建完成后，请您务必复制并妥善保管 API Key，关闭创建成功弹窗后，将无法再次查看完整的 API Key。

配置 Claude Code

跳过登录验证

编辑或新建 ~/.claude.json（Windows 路径：C:\\Users\\<用户名>\\.claude.json），将 hasCompletedOnboarding 设为 true，跳过 Anthropic 官方登录验证。
{
  "hasCompletedOnboarding": true
}

创建配置文件

1. 编辑或新增 settings.json 文件，不同系统的配置文件路径不同，具体可参考：
MacOS/Linux 对应路径为： ~/.claude/settings.json
Windows 对应路径为： 用户目录/.claude/settings.json
若 settings.json 文件不存在，可使用文本编辑器（如 VSCode、记事本等）手动创建，或在终端中执行以下命令创建：
macOS 或 Linux
Windows
执行以下命令，创建用户级配置文件：
mkdir -p ~/.claude && touch ~/.claude/settings.json

Running Environment

Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: GNU bash, version 5.2.21(1)-release (x86_64-pc-linux-gnu)
配置文件路径为 ~/.claude/settings.json。
在 PowerShell 中执行以下命令，创建用户级配置文件：
New-Item -ItemType Directory -Force -Path "$HOME\\.claude" | Out-Null; New-Item -ItemType File -Force -Path "$HOME\\.claude\\settings.json" | Out-Null
配置文件路径为 $HOME\\.claude\\settings.json。
2. 在 settings.json 中写入以下配置，并将 <USER_API_KEY> 和 <用户域名> 替换为当前模型路由实例的实际信息。
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://<用户域名>",
    "ANTHROPIC_AUTH_TOKEN": "<USER_API_KEY>",
    "ANTHROPIC_MODEL": "ModelRouter/auto",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "ModelRouter/auto",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "ModelRouter/auto",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "ModelRouter/auto",
    "CLAUDE_CODE_SUBAGENT_MODEL": "ModelRouter/auto",
    "ENABLE_TOOL_SEARCH": "false"
  }
}
环境变量
是否必填
说明
ANTHROPIC_BASE_URL
是
Claude Code 请求的 API 网关地址。
ANTHROPIC_AUTH_TOKEN
是
用于鉴权的 API Key，需替换为您在 CMR 控制台创建的真实 API Key。请妥善保管，避免泄露。
ANTHROPIC_MODEL
是
Claude Code 默认调用的模型名，本文以 ModelRouter/auto 为例。
ANTHROPIC_DEFAULT_OPUS_MODEL
否
Claude Code 中 Opus 档位（高复杂度任务）映射到的模型。
ANTHROPIC_DEFAULT_SONNET_MODEL
否
Claude Code 中 Sonnet 档位（默认日常任务）映射到的模型。
ANTHROPIC_DEFAULT_HAIKU_MODEL
否
Claude Code 中 Haiku 档位（轻量/快速任务）映射到的模型。
CLAUDE_CODE_SUBAGENT_MODEL
否
Claude Code 创建子任务（subagent）时使用的模型。
ENABLE_TOOL_SEARCH
否
是否启用 Claude Code 内置的原生 web search 工具。
说明：
ANTHROPIC_BASE_URL 填写模型路由实例域名，不需要追加 /v1/messages。Claude Code 会自动拼接 Anthropic Messages 请求路径。
ModelRouter/auto 表示按照 L1 模型路由策略选择可用模型。您也可以将各模型变量替换为当前实例已关联的模型名称或意图路由名称。
将 Opus、Sonnet、Haiku 和子代理模型设置为同一值，可以避免 Claude Code 在不同任务中切换到未配置的模型。
Claude Code 禁止第三方模型使用内置原生搜索工具，因此将 ENABLE_TOOL_SEARCH 设置为 false。如需联网搜索，可以按需配置搜索 MCP 服务。
3. 保存配置后，关闭当前终端并打开新的终端窗口，使配置生效。

验证配置

1. 在终端中进入需要使用 Claude Code 的项目目录。
cd <项目目录>
2. 执行以下命令，启动 Claude Code。
claude
3. 启动成功后，输入 /status 并按 Enter 键，检查当前配置。

当 Anthropic base URL 显示模型路由实例域名，且 Model 显示 ModelRouter/auto 或您配置的模型名称时，表示配置已生效。
4. 确认配置生效后，即可开始对话。


中国站