在 Claude Code 中通过 连连智枢 网关进行 AI 编程。

Claude Code 是 Anthropic 出品的官方终端原生编程 Agent,由 Claude 驱动。将 API 端点指向 连连智枢 的 Anthropic 兼容入口后,可使用控制台 Key 与统一模型目录。

安装 Claude Code

请参考 Claude Code 官方安装文档 完成安装。

接入前请在控制台创建推理 API Key(见 API 密钥),并从 模型列表 选取 id

配置 连连智枢 API

重要提示

配置前请清除可能指向 Anthropic 官方或其它代理的环境变量,避免覆盖配置文件:

unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_API_KEY
unset ANTHROPIC_BASE_URL

若上述变量写在 ~/.bashrc / ~/.zshrc 中,请同步删除对应行,否则新开终端会再次注入。

步骤 1 — 编辑配置文件(推荐)

1. 编辑 settings.json

编辑或创建 Claude Code 配置文件(macOS / Linux:~/.claude/settings.json;Windows:用户目录/.claude/settings.json)。

YOUR_ROUTERBRAIN_KEYYOUR_MODEL_ID 替换为你的 Key 与模型目录 id。Shell 中的 ANTHROPIC_AUTH_TOKENANTHROPIC_BASE_URL 优先级高于 配置文件。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://51kik.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_ROUTERBRAIN_KEY",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

说明:

变量作用
ANTHROPIC_BASE_URL网关 Anthropic 兼容根路径(不含 /v1
ANTHROPIC_AUTH_TOKEN连连智枢 推理 Key(亦可用 ANTHROPIC_API_KEY
ANTHROPIC_MODEL默认模型,取目录 id
ANTHROPIC_DEFAULT_*_MODELSonnet / Opus / Haiku 档位别名,建议与默认模型一致
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY/model 从网关拉取可选模型

2. 新增 onboarding 标记

编辑或创建 ~/.claude.json(Windows:用户目录/.claude.json),避免首次启动仍走官方登录流程:

{
  "hasCompletedOnboarding": true
}

步骤 2 — 启动 Claude Code

进入项目目录,在终端运行:

claude

步骤 3 — 信任工作目录

启动后选择 Trust This Folder(信任此文件夹),允许 Claude Code 读写当前目录中的文件。

验证配置生效

启动 claude 后,在 TUI 中输入:

/status
/model

预期结果:

  • /statusANTHROPIC_BASE_URL 指向 https://51kik.com/anthropic(渲染后为当前环境的真实网关地址)。
  • /model 显示你在配置中设置的 YOUR_MODEL_ID,或网关返回的模型列表。

也可在终端快速验证:

claude -p "只回复 ok"

工具与 MCP

ANTHROPIC_BASE_URL 指向第三方网关时,MCP tool search 默认关闭。若网关支持 tool_reference,可在 env 中增加:

"ENABLE_TOOL_SEARCH": "true"

MCP 服务器配置见 Claude Code 官方文档;网关 tools 能力见 Messages API

命令行 curl 验证(可选)

不启动 Claude Code 也可先验证 Key 与模型:

curl -sS "https://51kik.com/anthropic/v1/messages" \
  -H "x-api-key: YOUR_ROUTERBRAIN_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "max_tokens": 64,
    "messages": [{ "role": "user", "content": "只回复 ok" }]
  }'

常见问题

现象排查
仍请求 api.anthropic.com检查 shell 环境变量是否覆盖配置;VS Code 插件建议从已配置的终端启动 IDE
401 / 403使用 连连智枢 Key,非 Anthropic 官方 Key
模型不存在model 必须为目录 id
反复出现登录页确认 ~/.claude.jsonhasCompletedOnboarding: true

相关