Setting Up Claude Code (1): Claude Code Router
把 Anthropic 的 Claude Code CLI 接到 TT API:通过社区维护的 Claude Code Router (CCR) 转发层,编辑 ~/.claude-code-router/config.json 把 endpoint 指向 https://api.ttapi.cc/、apiKey 填本站 Key,Claude Code 就能走 TT API 调 Claude / GPT 等模型。本文给出完整配置步骤。
本文介绍 CCR 方案。系列文章的另一篇讲 CC Switch 方案。
谁适合用这种接入方式
- 已经习惯 Claude Code 的工作流,但想用我们网关的统一计费 / 多模型路由
- 想在 Claude Code 里用非 Anthropic 模型(如 GPT-5.5、DeepSeek、Gemini)
- 公司账户在我们这边,但开发者本地没有官方 Anthropic 账号
前置条件
- Node.js 18+
- Claude Code 已安装(
npm install -g @anthropic-ai/claude-code) - 一把我们平台的 API Key
安装 Claude Code Router
npm install -g claude-code-router
安装完成后会全局多出 ccr 命令。
创建配置文件
CCR 的配置文件位置:~/.claude-code-router/config.json。如果不存在就新建:
{
"providers": [
{
"name": "ttapi",
"api_base_url": "https://api.ttapi.cc/v1",
"api_key": "sk-...",
"models": [
"claude-4.7-opus",
"claude-4.6-sonnet",
"gpt-5.5",
"deepseek-v4-pro"
]
}
],
"router": {
"default": "ttapi,claude-4.6-sonnet",
"background": "ttapi,claude-4.5-haiku",
"think": "ttapi,claude-4.7-opus",
"long_context": "ttapi,gemini-2.5-pro"
}
}
字段含义:
| 字段 | 作用 |
|---|---|
providers[].api_base_url |
我们的 OpenAI 兼容入口 |
providers[].api_key |
在控制台「API Keys」生成的密钥 |
providers[].models |
你想暴露给 Claude Code 的模型列表 |
router.default |
默认编程任务用哪个模型 |
router.background |
后台轻量任务(如生成 commit message) |
router.think |
长思考 / 复杂推理任务 |
router.long_context |
长文档场景 |
启动
ccr start
CCR 会监听本地 http://127.0.0.1:3456(默认端口),作为 Claude Code 和我们网关之间的代理。
然后在另一个终端启动 Claude Code:
ccr code
这条命令等价于设置好环境变量后启动 claude,所有请求会经 CCR 转发到我们处理。
切换模型
在 Claude Code 会话中输入:
/model gpt-5.5
或:
/model deepseek-v4-pro
只要在 config.json 的 providers[].models 里声明过的模型都能切。
验证
回到我们的「调用日志」页面,应该能看到从 claude-code user-agent 发起的请求。如果看不到,常见原因:
ccr start没起来,端口 3456 没监听 → 重启api_base_url写错(少了/v1)→ 改 config.json- API Key 拼错或被禁用 → 控制台核对
常见问题
Q:CCR 进程后台跑还是前台跑?
A:默认前台。生产开发想后台跑可以 nohup ccr start & 或用 pm2 守护。
Q:能同时配多个 provider 吗?
A:可以。providers 是数组,可以同时配我们 + 官方 Anthropic + 本地 ollama。在 router 里指定不同任务路由到不同 provider。
Q:Claude Code 的内置工具(文件编辑 / Bash 执行)受影响吗? A:不受。CCR 只代理模型调用,工具调用完全在本地执行。