一、安装 Claude Code
根据本地环境安装 Claude Code。操作详情请参见 Claude Code 文档。如果已安装 Claude Code，可以跳过此步骤。
安装完成后，执行以下命令查看版本。终端显示版本号，表示安装成功。
claude –version
二、获取 API Key
登录 模型路由 控制台，创建模型路由 API Key。操作详情请参见 模型路由访问密钥。
注意：创建完成后，请你务必复制并妥善保管 API Key，关闭创建成功弹窗后，将无法再次查看完整的 API Key。
三、跳过登录验证
编辑或新建 ~/.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 或 LinuxWindows
执行以下命令，创建用户级配置文件：
mkdir -p ~/.claude && touch ~/.claude/settings.json
五、Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64Runtime 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 工具。 |
注意：说明：
3. 保存配置后，关闭当前终端并打开新的终端窗口，使配置生效。
六、验证配置
1. 在终端中进入需要使用 Claude Code 的项目目录。
cd <项目目录>
2. 执行以下命令，启动 Claude Code。
claude
3. 启动成功后，输入 /status 并按 Enter 键，检查当前配置。
当 Anthropic base URL 显示模型路由实例域名，且 Model 显示 ModelRouter/auto 或你配置的模型名称时，表示配置已生效。
4. 确认配置生效后，即可开始对话。