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。本页价格由站内价格数据生成,实时费率以模型广场为准。