登录选套餐
博客 · 接入指南

如何在 Claude Code 使用第三方 API:配置 settings.json

settings.json 里写两个变量,跑一次 /status 就能确认请求走的是 CodingPass。

只想看三步速查的,看 Claude Code 接入指南。这篇从 Claude Code 本身讲起,再一步步配好。

Claude Code 是什么

Claude Code 是 Anthropic 自己做的编程 Agent。它在你的仓库里读代码、列改动方案,再改多个文件、跑测试,看终端输出接着排查。能按项目定制的地方:

  • CLAUDE.md:写项目约定
  • 斜杠命令和 skills:把常用流程打包
  • hooks:在每次工具调用前后跑你的脚本
  • 子 Agent:在各自的上下文里处理旁支任务
  • MCP 服务器:照常接

官方文档列出的入口有终端、IDE、桌面 App 和浏览器。读 settings.json 的是这几种:

  • 终端:claude 命令
  • IDE:VS Code 和 JetBrains 扩展,底层跑的是同一个 Claude Code
  • 脚本和 CI:claude -p 跑一条提示,不开交互界面

桌面 App 是另一回事:Claude Desktop 不读 settings.json,接 CodingPass 要走 Gateway 模式,见 Claude Desktop 接入指南。

接 CodingPass 后,Claude Code 用的还是 Anthropic 的官方模型 ID:Go 档默认 Sonnet 5.5(claude-sonnet-5-5),Plus 档起可以用 Opus 5.5,Pro 档起可以用 Fable 5.2,小改动可以交给 Haiku 5.5。请求按套餐额度计量,不会意外扣费。

配置实战

下面的步骤在一台全新的虚拟机上跑过一遍,Claude Code 版本 2.1.327,没登录过 claude.ai。

准备

装好 Claude Code,在 CodingPass 控制台的 Key 页新建一个 Key,工具选 Claude Code。Key 以 cp-live- 开头。

写 settings.json

文件在 ~/.claude/settings.json(Windows 上是 %USERPROFILE%\.claude\settings.json),没有就新建:

~/.claude/settings.json
{  "$schema": "https://json.schemastore.org/claude-code-settings.json",  "env": {    "ANTHROPIC_BASE_URL": "https://codingpass.ai",    "ANTHROPIC_AUTH_TOKEN": "cp-live-…"  },  "model": "claude-sonnet-5-5"}
  • 地址写 https://codingpass.ai,不带 /v1。
  • model 按套餐填:Go 档 claude-sonnet-5-5,Plus 档可以填 claude-opus-5-5。不写的话 Claude Code 默认用 Opus 5.5。
  • 必须是合法 JSON,多一个尾逗号整个文件都不生效。$schema 那行能让编辑器把写错的地方标红。

写好后,已经开着的 Claude Code 先完全退出,再在项目目录里运行 claude。

发一条消息跑通

Logo 下面那行写着模型名和 API Usage Billing,随便问一句,正常回复就通了。

Claude Code 2.1.327 启动界面,Logo 下一行显示 Sonnet 5.5 · API Usage Billing;发了一句 Say hi in five words,回复 Hello there, nice to meet you!
头部写着 API Usage Billing,说明走的是 Key,不是 claude.ai 订阅。

不想进界面,也可以跑一条非交互命令,返回 2 就对了:

Terminal
claude -p "1+1, output only the answer"

再输入 /status 看一眼:

  • Anthropic base URL:https://codingpass.ai
  • Auth token:ANTHROPIC_AUTH_TOKEN,说明用的是 CodingPass 的 Key,不是之前的 claude.ai 登录
  • Setting sources:读到的配置文件,这里是 User settings
/status 的 Status 标签页:Auth token 为 ANTHROPIC_AUTH_TOKEN,Anthropic base URL 为 https://codingpass.ai,Setting sources 为 User settings
/status 里的 Anthropic base URL 和 Auth token 两行。
出发

Claude Code 照用,账单按月固定。

一个 settings.json,Sonnet 5.5 每月 起。随时取消。

  • 每个响应都带请求 ID
  • 用量不超过 5% 可全额退款
  • 不会意外扣费
选 GoClaude Code 指南

每月 $10,直到你取消。