Claude Code

Anthropic 官方 CLI，支持完整 tool use、prompt cache、subagent、hooks、skills 等核心能力。本站走 Anthropic 原生 /v1/messages 协议接入，不做协议转换，功能与官方一致。

安装

macOS / Linux

# 推荐：官方 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"

Windows

# 方法 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 Shell

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

验证安装

claude --version

如果 command not found：

# 找 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

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

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

方式 B：环境变量（持久化到 shell rc）

zsh / bash

echo 'export ANTHROPIC_BASE_URL="https://api.52pay.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<您的令牌>"' >> ~/.zshrc
exec $SHELL

Windows PowerShell

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.52pay.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<您的令牌>", "User")
# 关闭 PowerShell 重开

Fish Shell

set -Ux ANTHROPIC_BASE_URL "https://api.52pay.com"
set -Ux ANTHROPIC_AUTH_TOKEN "<您的令牌>"

方式 C：临时单次

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，再配环境变量。

验证连通

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

看到 pong 即可。

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

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 覆盖）。

日常使用

cd ~/your-project

# 交互模式
claude

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

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

# 继续上次会话
claude --continue

# 恢复指定会话
claude --resume

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

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

支持的模型

模型 ID	用途	上下文
claude-opus-4-8	最强推理，复杂重构首选	1M
claude-opus-4-7	上一代旗舰，稳定	1M
claude-opus-4-6-thinking	显式思维链	1M
claude-fable-5	长上下文 + 强推理	1M
claude-sonnet-4-6	性价比之选，日常主力	1M
claude-sonnet-4-5-20250929	上一代 Sonnet	200K
claude-haiku-4-5-20251001	最快最便宜，跑 subagent	200K

完整清单与实时价格见 模型与分组 和 站内价格页。

分组怎么选

default 分组覆盖全部模型且倍率最低（0.7），先用它。 如果长任务频繁遇到 503 / 限速，再换成 Claude Code Max 专线分组重建一把令牌。详见 模型与分组。

进阶：自定义子模型

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

{
  "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-4-8"
  },
  "model": "claude-sonnet-4-6"
}

不要把 Haiku 映射成 Opus

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

关于 1M 上下文

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

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

快米兔 API 透传该 beta 头。Claude Code 使用 opus[1m] 之类的内部别名时会自动带上。

如果遇到 400/503，说明当前路由到的上游账号没有 1M 权限——改用不带 [1m] 的普通模型名即可（claude-opus-4-8）。

超时与重试

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

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

常见错误

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

配套阅读

• CLAUDE.md 项目规范 — 让 Claude 懂你的项目
• Hooks 钩子 / Subagents 子代理 / Skills 技能扩展
• MCP 数据连接器
• CC Switch — 多 Provider 一键切换
• 成本优化策略