Claude Code 接入教程

Anthropic 官方的命令行编程助手，设两个环境变量就能用樱桃茶的 Claude 模型

接口：Anthropic Messages
地址写法：只写域名（https://gpt.cherrychat.org）
推荐模型：claude-sonnet-5-5、claude-opus-5-5
后台小模型：claude-haiku-5-5
平台：macOS、Windows、Linux、VS Code、JetBrains

接入步骤

安装 Claude Code（装过可跳过）
macOS 打开「终端」，Windows 打开「PowerShell」，粘贴对应命令回车。装好后输入 claude --version 能看到版本号就行。官方脚本下载不顺时，可以改用 npm 安装（需要先装 Node.js 22 或更高版本）。
macOS / Linux
```
curl -fsSL https://claude.ai/install.sh | bash
```
Windows（PowerShell）
```
irm https://claude.ai/install.ps1 | iex
```
或者用 npm 安装
```
npm install -g @anthropic-ai/claude-code
```
方法一（推荐）：写进 settings.json
用下面的命令打开用户目录里的 ~/.claude/settings.json（Windows 是 %USERPROFILE%\.claude\settings.json），把整段配置粘进去保存。文件里已经有别的内容时，只把 "env" 这一段合并进去，不要整个覆盖；这个文件是严格 JSON，不能写注释，最后一项后面不能有逗号。这样设置对所有终端和 VS Code / JetBrains 扩展都生效。
- ANTHROPIC_BASE_URL（API 地址）：https://gpt.cherrychat.org（只写到域名，不要加 /v1）
- ANTHROPIC_AUTH_TOKEN（API Key）：sk-你的密钥
- ANTHROPIC_MODEL（主模型）：claude-sonnet-5-5
- ANTHROPIC_DEFAULT_HAIKU_MODEL（后台小模型）：claude-haiku-5-5（起标题、总结等后台任务用，便宜又快）
打开文件（macOS）
```
mkdir -p ~/.claude && touch ~/.claude/settings.json && open -e ~/.claude/settings.json
```
打开文件（Windows）
```
mkdir $HOME\.claude -Force; notepad $HOME\.claude\settings.json
```
settings.json 内容
```
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gpt.cherrychat.org",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}
```

方法二：用环境变量

不想改 settings.json 时用这个方法。「永久生效」写进 ~/.zshrc（用 bash 的把文件名换成 ~/.bashrc），Windows 用 setx，设完要关掉终端重新打开；「只在当前窗口生效」适合先试一下，关掉窗口就失效。两种方法选一种即可，不必都做。

永久生效（写入 ~/.zshrc）

cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL="https://gpt.cherrychat.org"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
EOF
source ~/.zshrc

只在当前窗口生效

export ANTHROPIC_BASE_URL="https://gpt.cherrychat.org"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
claude

永久生效（setx，设完重开 PowerShell）

setx ANTHROPIC_BASE_URL "https://gpt.cherrychat.org"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"
setx ANTHROPIC_MODEL "claude-sonnet-5-5"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "claude-haiku-5-5"

只在当前窗口生效

$env:ANTHROPIC_BASE_URL = "https://gpt.cherrychat.org"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"
$env:ANTHROPIC_MODEL = "claude-sonnet-5-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-5-5"
claude

验证是否接通
新开一个终端，进入你的项目文件夹，运行下面的命令，能看到回复就说明接通了。进入 claude 交互界面后输入 /status：「Anthropic base URL」一行应显示 https://gpt.cherrychat.org，「Auth token」一行应显示 ANTHROPIC_AUTH_TOKEN。
```
claude -p "你好，用一句话介绍你自己"
```
提示登录时怎么办
出现登录界面，说明 Claude Code 没读到 ANTHROPIC_AUTH_TOKEN：确认是在设置之后新开的终端里运行，或者改用方法一写进 ~/.claude/settings.json。不需要登录 Anthropic 账号。以前登录过 claude.ai、启动时提示两个凭证冲突的，在 Claude Code 里输入 /logout 退出旧登录即可。

VS Code 扩展里使用（可选）

VS Code 扩展启动前会先检查登录，所以要在 VS Code 自己的设置里再写一遍：按 Cmd/Ctrl + Shift + P，运行「Preferences: Open User Settings (JSON)」，把下面这段加进最外层的大括号里保存，然后重启 VS Code。

"claudeCode.environmentVariables": [
  { "name": "ANTHROPIC_BASE_URL", "value": "https://gpt.cherrychat.org" },
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的密钥" },
  { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5-5" },
  { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-5-5" }
]

容易踩的坑

API 地址只写到域名 https://gpt.cherrychat.org，不要带 /v1，Claude Code 会自己补上 /v1/messages。
key 放在 ANTHROPIC_AUTH_TOKEN 里；不要同时再设 ANTHROPIC_API_KEY，两个都设会互相冲突。
不要把 key 写进项目文件夹里的 .claude/settings.json，它会跟代码一起提交、被别人看到；只写用户目录的 ~/.claude/settings.json。
settings.json 和终端环境变量都设了时，以 settings.json 为准；换 key 时两处都要改。
ANTHROPIC_SMALL_FAST_MODEL 是旧变量名，官方已标记弃用，新版用 ANTHROPIC_DEFAULT_HAIKU_MODEL；很老的版本可以两个都设。想在 /model 里切换 Opus / Sonnet，再加 ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5 和 ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5。
Claude Code 自带的 WebSearch 联网搜索暂不支持；Claude 桌面 App 也不读这些设置，本教程只适用于命令行和 VS Code / JetBrains 扩展。

报错 → 原因 → 怎么办

看到的报错	原因	怎么办
报 401 / Invalid bearer token	key 复制错了、前后多了空格，或这把 key 已停用 / 删除；也可能误写进了 ANTHROPIC_API_KEY	到 API 页「我的密钥」重新复制，填进 ANTHROPIC_AUTH_TOKEN，然后新开终端再试
报 404 Not Found	ANTHROPIC_BASE_URL 写成了 https://gpt.cherrychat.org/v1 或带了 /messages，路径被拼重复	改成只到域名：https://gpt.cherrychat.org
提示「There's an issue with the selected model」或模型不存在	ANTHROPIC_MODEL 的名字写错（大小写、多空格），或者用了樱桃茶没有的模型名	改成「模型价格」页上的名字，例如 claude-sonnet-5-5（全小写）
报 402 或「余额不足」（Claude 格式显示 billing_error）	账户积分不够付这次调用。API 调用只扣积分，会员卡和无限卡都不抵扣	到樱桃茶·智域GPT 的「商店」充值任意金额，几秒后重试即可
报 429 Too Many Requests	请求太快：默认每把 key 每分钟最多 120 次，每个账号同时最多 8 个请求	调低工具里的并发数或每秒请求数，按提示的 Retry-After 秒数等一等再试；多数工具会自动重试
一直转圈后报连接失败 / 超时（ECONNREFUSED、ENOTFOUND、timeout）	地址拼错、漏了 https://，或者当前网络连不到这个域名	用浏览器打开 https://gpt.cherrychat.org/v1/models：能看到一段 JSON（哪怕是报错）就说明网络是通的，再回到工具里逐字核对地址

教程核对于 2026-11-02。工具界面改版后可能和这里略有不同，以官方文档为准。

API 接入 · API 模型价格

Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 内容由 AI 生成，请仔细甄别

Claude Code 接入教程

接入步骤

安装 Claude Code（装过可跳过）

方法一（推荐）：写进 settings.json

方法二：用环境变量

验证是否接通

提示登录时怎么办

VS Code 扩展里使用（可选）

容易踩的坑

报错 → 原因 → 怎么办