CC API

Claude Code 接入 CC API 教程

五分钟把官方 Claude Code 客户端接到 CC API:安装 Node.js 与客户端、创建令牌、在 settings.json 里填 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN,附常见报错排查。

开始之前

本教程全程使用官方 Claude Code 客户端,只把接入地址指向 CC API,约 5 分钟完成。需要准备:

  • Node.js 18 或更高版本(用 node -v 检查)。
  • 一个 CC API 令牌:在控制台 → 令牌页点「添加令牌」,「分组」选 满血稳定claude(主力线路,倍率 1.75)或 claude kiro,创建后复制 sk- 开头的完整密钥。
接口地址是 https://cc.yzzt.top,不带 /v1,也不用写端口号。此前使用的 https://cc.yzzt.top:2087 继续可用,已有配置无需修改。

第 1 步:安装 Node.js

已有 Node.js 18+ 可跳过。否则从 nodejs.org 下载 LTS 安装包,或用包管理器安装:

# macOS(Homebrew)
brew install node
# Ubuntu / Debian
sudo apt update && sudo apt install -y nodejs npm
# CentOS / RHEL / Fedora
sudo dnf install -y nodejs npm

Windows 用户建议另外安装 Git for Windows,在 Git Bash 里运行 Claude Code,路径和引号的处理更可靠。

第 2 步:安装 Claude Code 客户端

npm install -g @anthropic-ai/claude-code

安装后重启终端,claude 命令即可用。网络超时可改用国内镜像:

npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com

Linux 上如遇 EACCES 权限错误,可加 sudo,或把 npm 全局前缀配置到自己有权限的目录。

第 3 步:写入 settings.json

配置文件位置:macOS / Linux 为 ~/.claude/settings.json,Windows 为 C:\Users\<你的用户名>\.claude\settings.json。目录不存在时先运行一次 claude 让它自动创建(登录提示可直接 Ctrl+C 退出),然后写入:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cc.yzzt.top",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

把 YOUR_API_KEY 换成你的密钥。三个要点:

  • Base URL 不要加 /v1。
  • 只设置 ANTHROPIC_AUTH_TOKEN 一种认证方式,不要同时设置 ANTHROPIC_API_KEY 或 apiKeyHelper。
  • 该文件包含密钥,不要提交进代码仓库;macOS / Linux 建议执行 chmod 600 ~/.claude/settings.json。

第 4 步:启动并选择模型

重启终端,进入任意项目目录运行:

claude

看到欢迎横幅和提示符即接入成功。在会话里输入 /model 切换模型,模型名须完整复制(区分大小写)。满血稳定claude线路当前可用:

  • claude-opus-5-5
  • claude-opus-5
  • claude-opus-4-8
  • claude-opus-4-7
  • claude-opus-4-6
  • claude-fable-5-1
  • claude-fable-5
  • claude-sonnet-5-5
  • claude-sonnet-5
  • claude-sonnet-4-6
  • claude-haiku-4-5-20251001

使用 Opus 5.5 前,请把 Claude Code 更新到 2.1.280 或更新版本。各模型单价见 Claude API 线路与价格。

注意事项

  • Claude 线路只保证官方 Claude Code 客户端可用,裸 curl、第三方 SDK 等其他请求形态可能被上游拒绝。
  • 分系统的逐步说明、权限策略等可选配置见配置文档。

常见问题

Claude Code 的 Base URL 填什么?

ANTHROPIC_BASE_URL 填 https://cc.yzzt.top,不要加 /v1,也不用写端口号。此前使用的 https://cc.yzzt.top:2087 继续可用,已有配置无需修改。

用 ANTHROPIC_AUTH_TOKEN 还是 ANTHROPIC_API_KEY?

两种认证头本站都识别,但请只保留一种。推荐只设 ANTHROPIC_AUTH_TOKEN;同时设置时 ANTHROPIC_API_KEY 会覆盖前者,排查问题时容易混淆。

提示 401、403 或客户端被拒绝怎么办?

401 通常是密钥填错或已删除,到控制台的令牌页核对。

403 多为请求形态被上游拦截:Claude 线路只保证官方 Claude Code 客户端,请勿用裸 curl、第三方 SDK 或旧版客户端访问。

Claude Code 里怎么切换模型?

在会话里输入 /model,从列表选择,或粘贴完整模型名(区分大小写),例如 claude-opus-5-5。

怎么更新 Claude Code?

教程里的 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 会关闭自动更新,需要手动更新:重新运行 npm install -g @anthropic-ai/claude-code 即可原地替换。

用 Opus 5.5 有什么要求?

请先把 Claude Code 更新到 2.1.280 或更新版本,再用 /model 切到 claude-opus-5-5。

最后更新:2026-10-07。本页价格由站内价格数据生成,实时费率以模型广场为准。