Claude Code 配置

Claude Code 可以通过环境变量和 ~/.claude/settings.json 接入 Model Server。推荐在 API 密钥页面点击“使用密钥”，选择 Claude Code 后下载对应系统的一键配置文件。

1安装 Claude Code

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

如果命令提示找不到 npm，请先安装 Node.js LTS，然后重新打开终端。

2创建 API 密钥

打开 API 密钥页面，创建或找到准备使用的密钥。

打开 API 密钥页面

3下载并运行一键配置

找到密钥后，点击右侧的使用密钥。

选择“Claude Code”和当前操作系统，然后点击下载一键配置脚本。

在下载目录打开终端，然后运行：

sh model-server-claude-setup.sh

看图操作

Claude Code 配置流程图

按照真实控制台截图找到“使用密钥”，选择 Claude Code 后下载并运行一键配置；脚本不可用时也可以复制手动配置，最后重新打开 Claude Code 验证。

界面可能随版本变化

1
第 1 步
在令牌管理页点击“使用密钥”
1. 1
  点击目标密钥这一行右侧的“使用密钥”。
打开令牌管理页，在准备配置给 Claude Code 的密钥这一行点击“使用密钥”。密钥本身不会在这张截图中显示。
自行采集Model Server 控制台当前界面（自行截图，裁切聚焦）核验于 2026-08-29
2
第 2 步
选择 Claude Code 并完成配置
1. 1
  选择 Claude Code，弹窗会切换到 Anthropic Messages 配置。
2. 2
  选择自己的操作系统；截图中选中的是 macOS / Linux。
3. 3
  推荐点击“下载一键配置脚本”，让脚本自动写入所需配置。
4. 4
  下载后运行这里显示的终端命令；可点击右侧“复制”。
5. 5
  脚本不可用时，可以复制 settings.json 内容并写入对应文件；使用这一种方式即可。
6. 6
  也可以复制 claude-code.env，作为另一种配置方式；启动 Claude Code 前必须主动加载该文件。
先选择 Claude Code 和自己的操作系统。推荐下载一键配置脚本并运行图中给出的终端命令；只有脚本不可用时，才选择一种手动配置方式：可以复制 settings.json，也可以复制 claude-code.env。两种方式不需要同时配置；claude-code.env 不会被 macOS 或 Shell 自动读取，使用它时必须在启动 Claude Code 前由脚本或 Shell 主动加载。截图以 macOS / Linux 为例，API Key 已经遮盖；实际地址和密钥必须以当前页面复制内容为准。
自行采集Model Server 控制台当前界面（macOS / Linux 自行截图）核验于 2026-08-29
3
第 3 步
重新打开 Claude Code 并发送测试任务
1. 1
  这里显示刚提交的任务和执行状态。
2. 2
  在输入区继续发送一句测试消息。
此图从官方演示中截取并裁去示例用户路径。看到任务状态和输入区，表示客户端已经正常启动。
官方仓库Claude Code 官方演示当前界面核验于 2026-08-26查看来源 ↗

看不清时：点击图片可放大；配置值请复制页面中的文字，不要照着截图手工输入密钥或地址。

4重启并验证

关闭原来的客户端和终端窗口，重新打开终端后再启动客户端。

claude

能够正常返回内容，就表示配置成功。

一键配置文件包含你的 API 密钥。配置完成后请妥善保管或删除下载文件。

一键配置不可用时，查看手动配置

将示例中的 sk-your-api-key 替换为自己的 API Key。

~/.claude/settings.json

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

如何确认配置成功

重新打开终端，运行 claude 并发送一条简单消息。能够直接进入对话且正常返回内容，即表示配置成功。

如果客户端仍显示官方登录流程，通常是旧终端没有加载新环境变量。关闭所有 Claude Code 和终端窗口后重新打开，再运行 claude。

手动配置

如果不能运行一键配置，可以在 ~/.claude/settings.json（Windows 为 %USERPROFILE%\\.claude\\settings.json）写入：

json

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "<当前 API Base URL>",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

ANTHROPIC_BASE_URL 使用文档页面显示的 Base URL，不要重复添加 /v1。API Key 请替换为自己的完整密钥。

使用注意

不要同时在多个位置设置不同的 ANTHROPIC_BASE_URL。
项目目录内的 Claude 配置可能覆盖用户目录配置。
切换 API Key 后需要重新运行一键配置。
一键配置文件和 settings.json 都包含 API Key，请勿分享或提交到 Git 仓库。

更多错误处理方法见常见问题。

Claude Code 配置 ​

1安装 Claude Code

2创建 API 密钥

3下载并运行一键配置

在令牌管理页点击“使用密钥”

选择 Claude Code 并完成配置

重新打开 Claude Code 并发送测试任务

4重启并验证

如何确认配置成功 ​

手动配置 ​

使用注意 ​

Claude Code 配置

如何确认配置成功

手动配置

使用注意