Client 1 / Claude Code

把 Claude Code 接到 OpenEasyAPI

Claude Code 走 Anthropic 原生协议：ANTHROPIC_BASE_URL 填根地址 https://openeasyapi.com（不要加 /v1），令牌放 ANTHROPIC_AUTH_TOKEN，模型填 claude-opus-5-5 或 claude-sonnet-5-5。

Claude CodeAnthropic Messagesclaude-opus-5-5claude-sonnet-5-5

关键配置安装步骤验证命令常见问题

Config

关键配置：三项固定值

Base URL、令牌变量名、模型名写死这三项就够了，Claude Code 自己会请求 /v1/messages。

💡

提示

ANTHROPIC_BASE_URL 必须是 https://openeasyapi.com，不要写成 https://openeasyapi.com/v1，也不要追加 /messages。

⚠️

注意

令牌变量名是 ANTHROPIC_AUTH_TOKEN（sk- 开头），不是 OPENAI_API_KEY，两者不要混用。

~/.claude/settings.json（推荐，跨终端生效）

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openeasyapi.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "ANTHROPIC_MODEL": "claude-opus-5-5"
  }
}

macOS / Linux（当前 shell）

export ANTHROPIC_BASE_URL="https://openeasyapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
export ANTHROPIC_MODEL="claude-opus-5-5"

# 想换成更便宜的型号
# export ANTHROPIC_MODEL="claude-sonnet-5-5"

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://openeasyapi.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的令牌"
$env:ANTHROPIC_MODEL = "claude-opus-5-5"

💡

提示

只想临时换一次模型时，也可以直接 claude --model claude-sonnet-5-5；当前可用的 Claude 型号见模型广场，教程里的 claude-opus-5-5 / claude-sonnet-5-5 都在售。

Install

按平台安装

三个平台都是同一套顺序：Git、Node.js、Claude Code，然后写配置。

依赖	最低版本	检查命令	用途
Git	2.39+	`git --version`	让 Claude Code 读取仓库状态
Node.js	20+	`node --version`	运行 Claude Code CLI
npm	10+	`npm --version`	安装 @anthropic-ai/claude-code

安装 Git

推荐 Windows Terminal + PowerShell 7，后面的命令都在 PowerShell 里执行。

Git

winget install --id Git.Git -e
git --version

安装 Node.js（20+）

推荐用 fnm 管理版本；不想折腾版本管理时，直接装官方 LTS 包也可以。

Node.js

winget install Schniz.fnm
fnm install 22
fnm default 22

# 不想装 fnm 时，直接用官方安装包
winget install OpenJS.NodeJS.LTS

安装 Claude Code

Install Claude Code

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

安装完成后，按本页“关键配置”写入 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN，再用下面的命令启动。

Verify

claude --version
cd C:\path\to\your\project
claude

Verify

一条 curl 先确认链路通，再启动 Claude Code

先不启动 Claude Code，直接用 curl 打 https://openeasyapi.com/v1/messages，能拿到 200 和文本 "OK" 就说明 base URL、令牌、模型三项都对。

复制这条验证命令

先确认 ANTHROPIC_AUTH_TOKEN 已经在当前终端里（echo $ANTHROPIC_AUTH_TOKEN 能看到 sk- 开头的值），再执行：

curl 验证（Anthropic Messages）

curl -sS -i https://openeasyapi.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 8,
    "messages": [{"role": "user", "content": "reply with OK"}]
  }'

看到这样的响应就算成功

关键看两点：HTTP 状态是 200，并且 content[0].text 是模型回的内容（这里是 OK）。

成功响应片段

HTTP/2 200
{"id":"msg_...","type":"message","role":"assistant","model":"claude-opus-5-5",
 "content":[{"type":"text","text":"OK"}],"stop_reason":"end_turn",
 "usage":{"input_tokens":13,"output_tokens":4}}

再启动 Claude Code

验证通过后进入项目目录执行 claude；第一次启动如果询问是否信任目录，按提示确认。

启动

claude --version
cd /path/to/your/project
claude

⚠️

注意

401 多半是令牌没带上或复制时多了空格；404 多半是 base URL 被写成了 https://openeasyapi.com/v1；400 通常是模型名写错。

⚠️

注意

账号余额为 0 时 Claude 调用会返回 402 和 insufficient balance, please top up，先充值再验证；首次调用大约 10–15 秒返回属于正常冷启动。

Troubleshooting

最常见的四类问题

按顺序排查，基本都能定位到具体哪一项写错。

⚠️

注意

Base URL 写错：写成 https://openeasyapi.com/v1 会 404，改回根地址 https://openeasyapi.com。

⚠️

注意

令牌错：回到 API Key 页面确认这把 Key 属于 team-claude 分组，并重新复制一次。

💡

提示

环境变量未生效：重开终端，或改成写进 settings.json，避免只写在某一个窗口里。

💡

提示

想用图形界面管理多个配置：继续看 CC Switch。

创建令牌

Codex