Claude Code 配置

Claude Code 使用 Anthropic Messages 协议。本站 Claude-Main / Claude-Pro 分组提供 Claude 系模型。

图形界面推荐走 CC Switch 桌面。命令行可手写 settings.json / 环境变量，或用 cc-switch --app claude。

快速字段

项	值
Base URL	https://api.ashpetals.com（不要带 /v1）
认证（推荐）	ANTHROPIC_AUTH_TOKEN=sk-你的APIKey（发 Authorization: Bearer）
备选认证	ANTHROPIC_API_KEY（发 x-api-key）
模型示例	claude-sonnet-5（以 /v1/models 为准）
分组	令牌需包含 Claude-Main / Claude-Pro
实际请求	客户端会拼 POST /v1/messages

第三方 Base 时优先 ANTHROPIC_AUTH_TOKEN，并清空会抢优先级的官方 ANTHROPIC_API_KEY，避免请求打回 api.anthropic.com。

---

图形界面

CC Switch 桌面（推荐）

1. 打开 CC Switch → 顶部选 Claude Code → 添加供应商。
2. 预设选「自定义」或任意 Anthropic 兼容中转模板。
3. 填写：
   • API Key：sk-你的APIKey
   • 请求地址：https://api.ashpetals.com
   • API 格式：Anthropic Messages（原生）
   • 模型：claude-sonnet-5
4. 启用。直连场景 不要开本地路由。
5. 新开终端运行 claude，发送测试消息。

Claude Code 自己的设置 UI

若当前版本提供 Settings → API：

字段	填
API endpoint / Base URL	https://api.ashpetals.com
Auth token	sk-你的APIKey
Default model	claude-sonnet-5

没有这项 UI 时，用下面的 settings.json 或环境变量。Claude Desktop（聊天 App）≠ Claude Code（编程 CLI）；Desktop 的 3P 配置见 CC Switch 手册。

---

命令行 / 配置文件

安装

按 Anthropic 当前文档安装 claude 命令。本页只写接本站。

方式一：settings.json（推荐，持久）

写入 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ashpetals.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的APIKey",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

Windows：%USERPROFILE%\.claude\settings.json。

已有其它字段时只合并 env，不要整文件覆盖。

方式二：当前终端环境变量（临时 / CI）

export ANTHROPIC_BASE_URL="https://api.ashpetals.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的APIKey"
export ANTHROPIC_MODEL="claude-sonnet-5"
unset ANTHROPIC_API_KEY
claude

环境变量优先于 settings.json。 排查「改了文件没生效」时先跑：

env | grep ANTHROPIC

方式三：CC-Switch CLI

cc-switch --app claude provider add
cc-switch --app claude provider switch <id>
cc-switch start claude                 # 只启动一次、不改全局
cc-switch provider export              # 导出为 ./.claude/settings.local.json

交互添加：地址 https://api.ashpetals.com，格式 Anthropic Messages。详见 CC Switch CLI。

---

在 Claude Code 里用本站 GPT（可选）

需要跨协议时，用 CC Switch / CCR / opencodex 本地路由，把 Anthropic Messages 转成 OpenAI Responses / Chat。步骤见 CC Switch 跨协议。直连本站 Claude 时不要开代理。

---

验证

claude
# 会话中发送：你好

curl -sS https://api.ashpetals.com/v1/messages \
  -H "x-api-key: sk-你的APIKey" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":64,"messages":[{"role":"user","content":"ping"}]}'

---

注意事项

• ANTHROPIC_BASE_URL 不要带 /v1（客户端会拼 /v1/messages）。多写一层会变成 /v1/v1/messages → 404。
• 调用 Claude 模型需要令牌具备对应 Claude 分组权限。
• 第三方中转优先 ANTHROPIC_AUTH_TOKEN；ANTHROPIC_API_KEY 可能让客户端走官方认证头。
• Shell 中残留的旧 ANTHROPIC_* 会覆盖 settings.json。
• 首次改 BASE_URL 建议新开终端。
• 不要将 API Key 提交到 Git。