与 Claude Code 集成

本页介绍如何用 cc-router 应用内置的 settings.json 编辑器，一键把 Claude Code 接入你聚合好的 model-opus / model-sonnet / model-haiku 等虚拟模型。

与快速开始里”手动复制 env 片段粘到配置文件”的做法相比，这里是 cc-router 原生的方式：在 app 里点一下按钮就把 cc-router 字段写进 ~/.claude/settings.json，最稳、不依赖 shell 环境，已存在的用户配置也会被尊重。

前置要求

已按快速开始安装并配置好 cc-router，至少绑定了一个虚拟模型
已安装 Claude Code
cc-router 正在运行，本机代理监听 127.0.0.1:23456（以「接入指南」页顶部显示的「代理监听地址」为准）

第一步：打开「接入指南 → Claude Code」

打开 cc-router，左侧切到 接入指南，顶部标签页选 Claude Code。

页面顶部的 代理监听地址 会显示当前端口与运行状态（例如 127.0.0.1:23456 · 运行中）。下方的 settings.json 编辑器 直接读写 ~/.claude/settings.json，右上角的「已同步」表示编辑器内容与磁盘文件一致。

cc-router 接入指南中的 Claude Code settings.json 编辑器

第二步：点「插入 cc-router 推荐配置」

点编辑器下方的 插入 cc-router 推荐配置 按钮，cc-router 会按需把自己需要的字段填进 JSON：

如果文件里已经有你自己的配置（如 effortLevel、enabledPlugins 等），不会被覆盖——只补齐 cc-router 相关的 env 字段。
token、端口都按当前实际运行值填入，无需手抄。

填入的核心 env 字段如下（值以 app 实际生成的为准）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:23456",
    "ANTHROPIC_AUTH_TOKEN": "app 自动填入的真实 token",
    "ANTHROPIC_MODEL": "model-opus",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "model-opus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "model-sonnet",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "model-haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL": "model-opus",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK": "1"
  }
}

model-opus、model-sonnet、model-haiku 就是你在 cc-router 里绑定的虚拟槽位名，app 会自动把它们转成真实模型名。

1M 上下文写法：如果某个槽位绑定的真实模型支持 1M 上下文，可以把模型名写成 model-opus[1m]，这是 Claude Code 支持的语法。

第三步：保存并重启 Claude Code

点保存，cc-router 就把改动一键写回 ~/.claude/settings.json（右上角恢复「已同步」）。如果你想看磁盘上的最新内容，点 重新加载 即可。

完整退出并重启 Claude Code，让新配置生效。之后 Claude Code 发出的请求都会经 127.0.0.1:23456 路由到你绑定的真实模型。

验证

在 cc-router 主界面左侧切到日志 → 请求日志，发起一次 Claude Code 对话，应能看到请求被记录下来，客户端 列显示 Claude Code，虚拟模型 与 真实模型 列显示对应的槽位与最终上游模型。

排错

改完没生效 —— settings.json 不会热加载，必须完整退出并重启 Claude Code。
端口被占用 / connection refused —— 默认端口 23456 被占用时 cc-router 会自动 +1。以「接入指南」页顶部「代理监听地址」显示的实际端口为准，重新点一次 插入 cc-router 推荐配置 即可同步最新端口。
401 Unauthorized —— cc-router 的 token 可能轮换过了。回到本页重新点 插入 cc-router 推荐配置，再保存，即可写入最新 token。
想手动配置 —— 如果你更习惯自己改文件，参考快速开始里的 env 片段，效果一致。

安全提示

ANTHROPIC_AUTH_TOKEN 是访问凭据，等同于直接调用你的所有上游 provider，勿外泄、勿提交到代码仓库。
仅在受信任的局域网中暴露 cc-router 端口；公网暴露需自行评估风险，并配合反向代理 + 鉴权层加固。