主题
快速开始
5 分钟内跑通你的第一次请求。
第 1 步:获取令牌(API Key)
- 打开 快米兔 API 控制台 → 注册 / 登录
- 左侧「令牌」→「添加令牌」
- 填名称,选 分组(不确定就选
default),额度可设「无限额度」 - 保存后点「复制」,拿到
sk-开头的字符串
下文统称 <您的令牌>。
令牌 ≠ 余额
令牌只是一把钥匙,额度扣的是账号余额。令牌可以建很多把,分别给不同项目/机器用,丢了直接删。 详见 账号 · 充值 · 令牌。
分组决定了你能用哪些模型
不同分组开放的模型和线路不同(例如 Claude Code 分组走 Claude Code 专线)。若提示「当前分组下对于模型 xxx 无可用渠道」,多半是分组选错了,见 模型与分组。
第 2 步:选客户端
| 你要做什么 | 推荐客户端 |
|---|---|
| 终端里写代码 / agentic 编程 | Claude Code ⭐ 主流 |
| 用 GPT-5 系写代码 | Codex CLI |
| 开源、可自由换模型的终端 Agent | OpenCode |
| 在 IDE 里编辑(VS Code / JetBrains) | Cursor / Cline |
| 多 Provider 一键切换 | CC Switch |
| 通用对话 GUI | ChatBox / Cherry Studio / NextChat / LobeChat |
| 自己写代码调接口 | 原生 API 调用 |
不确定选哪个?看 选择客户端 决策树。
第 3 步:配置 + 验证
下面以 Claude Code 为例,5 分钟跑通:
bash
# 1. 安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash
# 2. 配置环境变量
export ANTHROPIC_BASE_URL="https://api.52pay.com"
export ANTHROPIC_AUTH_TOKEN="<您的令牌>"
# 3. 验证
claude -p "Reply with one word: pong"powershell
# 1. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 2. 配置环境变量(永久)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.52pay.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<您的令牌>", "User")
# 关闭 PowerShell 重开
# 3. 验证
claude -p "Reply with one word: pong"fish
# 1. 安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash
fish_add_path ~/.local/bin
# 2. 配置环境变量(持久化)
set -Ux ANTHROPIC_BASE_URL "https://api.52pay.com"
set -Ux ANTHROPIC_AUTH_TOKEN "<您的令牌>"
# 3. 验证
claude -p "Reply with one word: pong"看到 pong 即配置成功。
只想先确认令牌是通的?
不用装任何客户端,一条 curl 就够:
bash
curl https://api.52pay.com/v1/chat/completions \
-H "Authorization: Bearer <您的令牌>" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.4-mini","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'返回 JSON 里有 choices 就说明账号、令牌、余额、分组都没问题,接下来的问题一定出在客户端配置上。
第 4 步:日常使用
bash
# 进入项目目录
cd ~/your-project
# 交互模式(推荐)
claude
# 一次性命令
claude -p "把 main.py 重构成模块化结构"
# 指定模型
claude --model claude-opus-4-8常见首次启动问题
| 现象 | 原因 | 详细 |
|---|---|---|
command not found: claude | PATH 没加好 | Claude Code 安装 |
401 Invalid token / 无效的令牌 | 令牌写错、多了空格、已删除 | 401 排查 |
当前分组下对于模型 xxx 无可用渠道 | 分组选错或模型名写错 | 模型与分组 |
| 一直 retry / 卡住不出字 | 反代关了 SSE buffering 没生效,或上游慢 | 流式卡顿 |
额度不足 | 余额用完 | 充值 |
install.sh 显示 ✅ 但 claude 找不到 | 安装阶段下载失败的假成功 | 安装失败 |
