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 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 发起的请求。如果看不到,常见原因:

  1. ccr start 没起来,端口 3456 没监听 → 重启
  2. api_base_url 写错(少了 /v1)→ 改 config.json
  3. API Key 拼错或被禁用 → 控制台核对

常见问题

Q:CCR 进程后台跑还是前台跑? A:默认前台。生产开发想后台跑可以 nohup ccr start & 或用 pm2 守护。

Q:能同时配多个 provider 吗? A:可以。providers 是数组,可以同时配我们 + 官方 Anthropic + 本地 ollama。在 router 里指定不同任务路由到不同 provider。

Q:Claude Code 的内置工具(文件编辑 / Bash 执行)受影响吗? A:不受。CCR 只代理模型调用,工具调用完全在本地执行。