快速开始

本页把 CatAPI 的接入流程整理成最短路径。详细信息可参考：CatAPI Docs。

1. 准备账号和令牌

1. 前往 CatAPI 注册并登录。
2. 在站内完成充值或额度准备。
3. 进入令牌管理页面创建 API Key。
4. 复制令牌，后续在 CLI 或第三方客户端里作为鉴权值使用。

令牌通常以 sk- 开头。不要把它提交到 Git，也不要写进公开文档或截图。

2. 设置基础地址

CatAPI 的常用基础地址是：

https://catapi.com

如果客户端要求填写完整接口地址，优先使用它自己的 OpenAI/Anthropic 兼容配置项；如果只要求 Base URL，填写上面的根地址即可。

3. 选择配置方式

推荐顺序：

1. 使用 CC-Switch 管理多个 CLI 配置，适合经常切换 Claude、Codex、Gemini 的用户。
2. 使用 CLI 手动配置，适合只接入一个工具或需要精确控制配置文件的用户。
3. 使用 第三方客户端，适合 OpenCode、OpenClaw、Hermes、Cline 等工作流。

4. 选择模型分组

CatAPI 文档把模型按用途和计费方式拆成多个分组：

• Default：通用分组，适合先验证服务可用性。
• AWS / AWS-Q：偏向 Claude 或 Qwen Coder 的特殊计费分组。
• CC：面向 Claude Code 体验做了适配。
• Codex：面向 Codex CLI 和 OpenAI 兼容模型。
• Gemini：面向 Gemini CLI。

模型选择细节见 模型分组。

5. 验证是否生效

配置完成后，优先做一个低成本验证：

• CLI 能否启动。
• 是否命中正确的 Base URL。
• 令牌是否有余额。
• 模型名是否属于当前分组。
• 报错是否来自鉴权、余额、网络代理或模型不存在。

如果排查失败，先看 FAQ。