---
title: "如何在 Claude Code 使用第三方 API：配置 settings.json"
description: "Claude Code 接 CodingPass：把 ANTHROPIC_BASE_URL 和 Key 写进 ~/.claude/settings.json，用 /status 验证请求发到了哪。"
url: https://codingpass.ai/zh/blog/use-custom-api-in-claude-code-settings-json
language: zh-CN
updated: 2026-11-19
---
# 如何在 Claude Code 使用第三方 API：配置 settings.json

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

[CodingPass 团队](https://codingpass.ai/zh/about) 发布于 2026年11月19日 更新于 2026年11月19日 阅读约 8 分钟

只想看三步速查的，看 [Claude Code 接入指南](https://codingpass.ai/zh/tools/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 接入指南](https://codingpass.ai/zh/tools/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!](https://codingpass.ai/assets/img/tools/claude-code/header-api-billing.webp)

*头部写着 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](https://codingpass.ai/assets/img/tools/claude-code/status.webp)

*/status 里的 Anthropic base URL 和 Auth token 两行。*

作者 CodingPass 团队

CodingPass 由我们运营。每篇指南发布前，都会在对应工具的最新稳定版上实测一遍。发现内容过时了？写信到 [support@codingpass.ai](mailto:support@codingpass.ai)。

## 相关阅读。

指南

### [Claude Code 接入指南](https://codingpass.ai/zh/tools/claude-code)

三步接好 Claude Code，各档位的默认模型和额度。

指南

### [Claude Desktop 接入指南](https://codingpass.ai/zh/tools/claude-desktop)

桌面 App 不读 settings.json，走 Gateway 模式。

规则

### [额度和上限怎么算](https://codingpass.ai/zh/usage-limits)

每个套餐、每个模型的额度和上限，以及 429 响应。
