快米兔 API 文档

主题

Claude Code ​

Anthropic 官方 CLI，支持完整 tool use、prompt cache、subagent、hooks、skills 等核心能力。Claude 模型走 Anthropic 原生 /v1/messages 协议，功能与官方一致。DeepSeek 等模型建议用 CC Switch 兼容协议，长会话首字更快。

安装 ​

bash
# 推荐：官方 install.sh
curl -fsSL https://claude.ai/install.sh | bash

# 或 npm（无 root 权限场景）
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
npm install -g @anthropic-ai/claude-code
export PATH="$HOME/.npm-global/bin:$PATH"
powershell
# 方法 1（推荐 ⭐）：WinGet
winget install Anthropic.ClaudeCode

# 方法 2：官方安装脚本
irm https://claude.ai/install.ps1 | iex

# 方法 3：npm（需 Node.js ≥ 18）
npm install -g @anthropic-ai/claude-code
fish
curl -fsSL https://claude.ai/install.sh | bash
fish_add_path ~/.local/bin

Windows 必要依赖

Windows 上 Claude Code 依赖 Git for Windows（用于 shell 工具调用）。先装 Git：https://git-scm.com/download/win

不装 Git 时即使 claude --version 能跑，实际执行命令会报 no shell available。

安装下载失败的坑

若 curl install.sh | bash 显示 ✅ 但 claude 命令找不到，通常是安装时程序没下完（国内网络常见）。

处理方式：

  1. rm -rf ~/.local/share/claude ~/.local/bin/claude 清干净
  2. 改用 npm 安装路线（见上）
  3. 仍失败就给 npm 换个源：npm config set registry https://registry.npmmirror.com

验证安装 ​

bash
claude --version

如果 command not found：

bash
# 找 claude 实际位置
find ~ -name claude -type f -o -name claude -type l 2>/dev/null

# 加进 PATH（zsh / bash）
export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

# 加进 PATH（fish）
fish_add_path ~/.local/bin

配置快米兔 API ​

三种方式，任选其一。

方式 A：~/.claude/settings.json（推荐，跨 shell 通用） ​

  • macOS / Linux 路径：~/.claude/settings.json
  • Windows 路径：%USERPROFILE%\.claude\settings.json
json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.52pay.com",
    "ANTHROPIC_AUTH_TOKEN": "<您的令牌>"
  }
}

优点：不用动 .zshrc / .bashrc / config.fish，换 shell 也生效。

方式 B：写进 shell 配置（关掉窗口也还在） ​

bash
echo 'export ANTHROPIC_BASE_URL="https://api.52pay.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<您的令牌>"' >> ~/.zshrc
exec $SHELL
powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.52pay.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<您的令牌>", "User")
# 关闭 PowerShell 重开
fish
set -Ux ANTHROPIC_BASE_URL "https://api.52pay.com"
set -Ux ANTHROPIC_AUTH_TOKEN "<您的令牌>"

方式 C：临时单次 ​

bash
env ANTHROPIC_BASE_URL="https://api.52pay.com" \
    ANTHROPIC_AUTH_TOKEN="<您的令牌>" \
    claude

不要加 /v1

ANTHROPIC_BASE_URL 只填到域名：https://api.52pay.com。 Claude Code 会自己拼 /v1/messages，你多加一次会变成 /v1/v1/messages → 404。

ANTHROPIC_API_KEY 与 ANTHROPIC_AUTH_TOKEN

两个变量 Claude Code 都认，但用 ANTHROPIC_AUTH_TOKEN 更稳：某些版本下 ANTHROPIC_API_KEY 存在时会触发官方登录态检查，导致要求你重新 /login。

如果你之前登录过官方账号，先 claude 进交互模式执行 /logout，再配环境变量。

用 CC Switch 走兼容协议 ​

Claude Code 只会发 /v1/messages。DeepSeek 等模型的上游不收这个协议，本站还要再转一层，上下文到几十万 token 时首字会拖到十几秒。用 CC Switch 在本机转成 OpenAI 兼容协议，直接打 https://api.52pay.com/v1 的 Chat Completions，同一量级的长会话首字会回到数秒。

什么时候用

在 Claude Code 里跑 deepseek-v4.1-flash、deepseek-v4-pro 这类模型，觉得思考或首字慢。令牌分组要和模型对应：DeepSeek 选 Deepseek。Claude 官方模型仍用上面的 Anthropic 配置，不要改成这条。

  1. 安装并打开 CC Switch，左侧选 Claude Code。
  2. 点 + 添加供应商，选自定义，不要沿用会写成根域名的 Anthropic 预设。
  3. 按下表填写，并打开本地路由、接管 Claude Code。
  4. 启用该供应商，重新打开 Claude Code，发一句 Reply with exactly one word: pong。
项填写
请求地址https://api.52pay.com/v1。必须带 /v1，末尾不要斜杠
API Key控制台这把令牌，sk- 整段复制
模型deepseek-v4.1-flash 或令牌分组里已有的模型名
API 格式OpenAI Chat Completions（兼容协议，需开启路由）。不要选 Anthropic Messages
认证字段保持 ANTHROPIC_AUTH_TOKEN
本地路由打开，并启用 Claude Code 接管。不打开的话兼容协议不会生效

两套地址不要混写

兼容协议的地址带 /v1。上面 Anthropic 配置是根域名，不带 /v1。交给 CC Switch 接管后，它会把 Claude Code 的 Base URL 改成本机路由，真实地址留在 CC Switch 里。如果供应商列表里只有 OpenAI Responses，也可以用，仍然比 Messages 快；优先选 Chat Completions。

验证连通 ​

bash
claude -p "Reply with exactly one word: pong"

看到 pong，就说明通了。

如果卡住不动或一直 retry，先用 curl 确认服务端正常：

bash
curl https://api.52pay.com/v1/messages \
  -H "x-api-key: <您的令牌>" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

curl 通、claude 不通 → 问题在本地配置（多半是环境变量没生效，或被 settings.json 覆盖）。

日常使用 ​

bash
cd ~/your-project

# 交互模式
claude

# 一次性命令
claude -p "解释这个项目的整体架构"

# 指定模型
claude --model claude-haiku-4-5-20251001   # 最快最便宜
claude --model claude-sonnet-4-6           # 平衡
claude --model claude-opus-5               # 最强

# 继续上次会话
claude --continue

# 恢复指定会话
claude --resume

交互模式内常用斜杠命令：

命令作用
/model切换模型
/clear清空上下文（省钱的关键）
/compact压缩上下文，保留要点
/cost查看本次会话消耗
/init生成 CLAUDE.md 项目规范
/logout退出官方登录态

支持的模型 ​

模型 ID用途上下文
claude-opus-5现役最强，复杂重构首选1M
claude-opus-4-8上一代旗舰，稳定1M
claude-opus-4-7前代旗舰1M
claude-opus-4-6前代百万上下文1M
claude-sonnet-4-6性价比之选，日常主力1M
claude-sonnet-4-5-20250929上一代 Sonnet200K
claude-haiku-4-5-20251001最快最便宜，跑子任务200K

模型清单见 模型与分组，实时价格以 模型广场 公示为准。

分组怎么选

Claude Code 建议令牌走 Claude 高性价比（0.3）或 Claude Code Max满血高质量（0.4）。default 也能跑，但更贵。详见 模型与分组。

进阶：自定义子模型 ​

Claude Code 内部会用三档模型（Haiku 做后台任务、Sonnet/Opus 做主任务），可以分别指定：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.52pay.com",
    "ANTHROPIC_AUTH_TOKEN": "<您的令牌>",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5"
  },
  "model": "claude-sonnet-4-6"
}

不要把 Haiku 映射成 Opus

Claude Code 的子任务和后台任务（话题命名、todo 摘要、文件搜索等）走 Haiku 档。 把 ANTHROPIC_DEFAULT_HAIKU_MODEL 改成 Opus，每次会话成本会翻 5–10 倍，而且这些后台任务根本不需要那么强的模型。

关于 1M 上下文 ​

Claude 系模型的 1M 上下文需要在请求里带 beta 头激活：

anthropic-beta: context-1m-2025-08-07

本站会原样转发这个请求头。Claude Code 使用 opus[1m] 之类的内部别名时会自动带上。

如果遇到 400/503，说明这次分到的线路没有 100 万上下文权限——改用不带 [1m] 的普通模型名即可（claude-opus-4-8）。

超时与重试 ​

国内网络下建议放宽超时，避免长任务被本地掐断：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.52pay.com",
    "ANTHROPIC_AUTH_TOKEN": "<您的令牌>",
    "API_TIMEOUT_MS": "600000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

常见错误 ​

现象跳转
一直 retry / 不出字流式无输出
401 Invalid token401 排查
无可用渠道503 排查
要求重新 /login上面 ANTHROPIC_API_KEY 提示
404 Not FoundBase URL 多加了 /v1

配套阅读 ​

文档持续更新 · 以 模型广场 公示为准

Copyright © 2026 咿嗷科技 · 快米兔 API