Claude Code 配置

Claude Code 通常通过环境变量读取 Anthropic 兼容接入点和认证信息。Modelink 提供兼容接入能力时，可以将 Claude Code 的 Base URL 和 Token 指向 Modelink。

推荐：自动配置

推荐使用 qiniu-coding-helper 自动写入 Claude Code 配置。

npx qiniu-coding-helper

或重新写入 Claude Code 配置：

npx qiniu-coding-helper auth reload claude

配置完成后重启 Claude Code。

手动配置

Claude Code 官方 settings 文档确认，用户级配置位于 ~/.claude/settings.json，并支持通过 env 字段为每个 Claude Code 会话及其子进程注入环境变量。可在该文件中写入 Modelink Anthropic 兼容接入点：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.qnaigc.com",
    "ANTHROPIC_AUTH_TOKEN": "<your-api-key>",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

也可以在启动前通过 shell 环境变量传入。中国大陆接入点使用 https://api.qnaigc.com，海外接入点使用 https://api.modelink.ai。

export ANTHROPIC_BASE_URL="https://api.qnaigc.com"
export ANTHROPIC_AUTH_TOKEN="<your-api-key>"
claude

ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_API_KEY 通常选择其一即可，避免同时配置多个认证字段导致工具读取到旧值。模型相关变量可按团队策略设置，但模型 ID 应以 Modelink 控制台或模型广场展示为准。

配置检查

• 确认 ANTHROPIC_BASE_URL 指向 Modelink 接入点：中国大陆 https://api.qnaigc.com，海外 https://api.modelink.ai。
• 确认认证字段使用有效 API Key，且没有复制空格或换行。
• 如果 shell 中已有同名环境变量，可能会覆盖配置文件中的值。
• 修改配置后完全重启 Claude Code，并使用 /status 或工具内状态面板确认 Base URL、API Key 和模型是否生效。
• 如果仍然失败，可查看 Claude Code 项目日志或控制台请求日志，并用请求时间、模型、状态码反查请求 ID。

权限与敏感文件保护

建议在 Claude Code 权限配置中默认拒绝读取敏感文件，例如 .env、.env.*、密钥目录、生产配置和客户数据目录。涉及文件写入、命令执行、网络访问、发布或生产变更时，应使用人工确认或更严格的 allow / deny 策略。

通过 bypass 接口接入

如需使用 Anthropic 透传（bypass）接口，将 ANTHROPIC_BASE_URL 指向 bypass 路径即可，只需配置到 v1/messages 之前的部分，v1/messages 由 Claude Code 自动拼接（仅支持 Claude 系模型）：

ANTHROPIC_BASE_URL="https://api.modelink.ai/bypass/anthropic"

可通过 echo $ANTHROPIC_BASE_URL 验证。认证仍使用 ANTHROPIC_AUTH_TOKEN（Bearer token 鉴权）。切换模型有两种方式：在 CLI 中输入 /model {模型名} 直接切换，或配置 ANTHROPIC_MODEL 环境变量后通过 /model 命令切换。

如果出现连接失败，可查看本地 ~/.claude/tasks/{失败的任务} 中的内容，确定具体的请求 URL。

常见问题

启动时提示需要登录

在环境变量中直接配置 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 启动 Claude Code，不会提示登录；但配置 ANTHROPIC_API_KEY 会触发登录提示。

原因是 ANTHROPIC_API_KEY 在 Claude Code 中被视为 Claude 官方的 API Key，而 ANTHROPIC_AUTH_TOKEN 会被识别为第三方 Key，因此不会要求登录。接入 Modelink 时请使用 ANTHROPIC_AUTH_TOKEN。

报错 x-anthropic-billing-header is a reserved keyword

新版 Claude Code（> 2.1.15）可能出现如下报错：

The model returned the following errors: x-anthropic-billing-header is a reserved keyword and may not be used in the system prompt.

该报错由新版本引入的计费功能导致——此功能本为 Claude 官方 API 准备，自定义 API 调用时可能因此出错。解决方法是在 ~/.claude/settings.json 的 env 中将 CLAUDE_CODE_ATTRIBUTION_HEADER 设置为 0。方案参考 claude-code-router#1161。

导出请求用于排障（ccdump）

部分用户通过 Claude Code 调用 Modelink API 时，无法直接看到请求 ID 等关键信息，导致排查困难。ccdump 用于记录并打包一次完整运行过程：

npx ccdump

它会自动启动本机的 Claude Code，并把之后会话中的所有请求、响应及相关上下文整理成压缩包，方便分享给 Modelink 技术支持快速定位问题。生成的 har 文件可直接导入 Chrome 的 Network 面板进行分析。

参考

• Claude Code Settings