配置 Claude Code

本页说明如何让 Claude Code CLI 或 Claude Code IDE 扩展通过 LLMAPI 调用 Messages API。请使用所属分组支持 Messages 的 API Key。

选择正确的 Key

普通 API Key 的分组决定是否能调用 Messages API。优先选择网页 API Key 页面中 使用密钥 窗口显示 Claude Code 选项的 Key：

• Anthropic 分组通常直接支持 Claude Code。
• OpenAI 分组只有在管理员启用 Messages 调度时才会显示 Claude Code 配置。
• 其他分组是否支持，以 使用密钥 窗口和实际模型列表为准。

不要把 Codex/OpenAI Key 的可用性等同于 Claude Code 可用性。

从网页 API Key 页面复制配置

1. 登录网站，进入 API Key 页面。
2. 找到要使用的普通 API Key，点击 使用密钥。
3. 选择 Claude Code，再选择 macOS/Linux、Windows CMD 或 PowerShell。
4. 复制网页生成的终端环境变量和用户级 settings.json。
5. 完全退出并重新启动 Claude Code 或 IDE 扩展。

网页生成内容使用当前服务的公开 Base URL，并且只在兼容的 Key 上显示 Claude Code 入口。若生成内容与下方示例不同，以网页内容为准。

如果已经安装 CC Switch，也可以通过网页 API Key 页面的 导入到 CCS 打开导入流程；确认导入后，还需在 CC Switch 中点击 启用。参见 配置 CC Switch。

持久配置

系统	文件位置
macOS / Linux	~/.claude/settings.json
Windows	%USERPROFILE%\.claude\settings.json

如果已经使用或配置过 Claude Code，~/.claude 通常已经存在，不需要重复创建。只有目录不存在、无法保存配置文件时，才运行 mkdir -p ~/.claude。

将以下内容保存到用户级 settings.json：

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

将 YOUR_API_KEY 替换为普通 API Key。ANTHROPIC_BASE_URL 使用服务根地址，不要追加 /v1/messages。

该文件包含 API Key，不要提交到 Git、发送到聊天或放进截图。如果已有 settings.json，请把 env 字段合并到现有 JSON，不要删除其他 Claude Code 设置。

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 会同时关闭自动更新、遥测、错误报告、版本信息、Gateway 模型发现和部分功能开关请求。如果需要这些功能，请删除这个变量，而不是只修改 Base URL 或 Key。

临时终端配置

临时环境变量只对当前终端会话生效，适合先验证 Key 和分组。

macOS / Linux：

export ANTHROPIC_BASE_URL="https://api.llmapi.site"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export CLAUDE_CODE_ATTRIBUTION_HEADER=0

PowerShell：

$env:ANTHROPIC_BASE_URL="https://api.llmapi.site"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
$env:CLAUDE_CODE_ATTRIBUTION_HEADER="0"

长期使用时优先保存用户级 ~/.claude/settings.json，不要把明文 Key 写进项目脚本。

VS Code / Cursor 扩展

Claude Code IDE 扩展会读取同一个用户级 ~/.claude/settings.json，不需要在编辑器设置中重复保存 API Key。为避免扩展再次显示登录提示，可以在编辑器的用户级 settings.json 中加入：

{
  "claudeCode.disableLoginPrompt": true
}

这是编辑器的用户级设置，不要保存到项目的 .vscode/settings.json。保存后运行命令面板中的 Developer: Reload Window。

验证配置

可以先直接验证 Messages API：

curl https://api.llmapi.site/v1/messages \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 64,
    "messages": [{ "role": "user", "content": "Reply with OK." }]
  }'

模型名必须对当前 Key 可用。然后按你实际使用的客户端验证，不需要为了验证 IDE 扩展而另外安装 Claude Code CLI。

Claude Code CLI

确认命令可执行：

claude --version

随后运行：

claude

Claude Code IDE 扩展

运行命令面板中的 Developer: Reload Window，打开 Claude Code 面板并发起一个新请求。配置正确时，扩展应直接使用 LLMAPI，不应要求进入官方账号登录流程。

常见问题

现象	处理
返回 401	检查 ANTHROPIC_AUTH_TOKEN 是否完整以及 Key 是否有效。
返回 404 或提示 Messages 不可用	当前 Key 的分组不支持 Messages API。更换为 使用密钥 窗口中显示 Claude Code 的普通 API Key。
提示模型不可用	使用当前 Key 查询模型列表并选择分组实际开放的 Claude 模型，不要直接照抄示例模型。
启动后仍进入官方登录	检查 ~/.claude/settings.json 路径与 JSON 格式；项目中的 .claude/settings.json 和 .claude/settings.local.json 优先级高于用户级配置，也要检查其中是否有冲突。然后完全退出 Claude Code 和 IDE 扩展后重新打开。
终端可用但 IDE 不可用	确认扩展可读取 ~/.claude/settings.json，在编辑器用户设置中加入 claudeCode.disableLoginPrompt，然后运行 Developer: Reload Window。

Claude Code IDE 扩展的第三方供应商配置说明见 Anthropic 官方文档，环境变量的完整行为见 Claude Code 环境变量参考。