在 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_KEY、YOUR_MODEL_ID 替换为你的 Key 与模型目录 id。Shell 中的 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_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_*_MODEL | Sonnet / 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
预期结果:
/status中ANTHROPIC_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.json 中 hasCompletedOnboarding: true |