CodeBair 30 秒快速开始

适合第一次接入 CodeBair 的用户。

1. 统一接入参数

• Base URL：https://api.codebair.com/v1
• API Key：你的 CodeBair Key（通常以 sk- 开头）
• Model：填写你已接入并授权的模型名（以 /v1/models 返回为准）

安全提醒：不要把 API Key 提交到 Git 仓库、聊天群或工单截图里。

2. 最短接入路径

1. 先拿到 CodeBair API Key
2. 在客户端里找到 OpenAI API Key / Custom API / OpenAI Compatible
3. 填入上面的 Base URL、API Key、Model
4. 运行一次最小测试，确认返回正常

3. 最小测试命令

PowerShell

curl.exe https://api.codebair.com/v1/chat/completions `
  -H "Content-Type: application/json" `
  -H "Authorization: Bearer YOUR_CODEBAIR_API_KEY" `
  -d '{"model":"YOUR_AVAILABLE_MODEL","messages":[{"role":"user","content":"ping"}]}'

macOS / Linux

curl https://api.codebair.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_CODEBAIR_API_KEY" \
  -d '{"model":"YOUR_AVAILABLE_MODEL","messages":[{"role":"user","content":"ping"}]}'

4. 先看你属于哪一类工具

工具	去看哪一节
Claude Code	Claude Code
Codex	Codex
Cursor	Cursor
Chatbox	Chatbox
OpenCode	OpenCode
OpenClaw	OpenClaw
腾讯 WorkBuddy	WorkBuddy
Gemini CLI	Gemini CLI

5. 最常见的 4 个错误

• 401：Key 错误、复制多了空格，或不是 CodeBair 的 Key
• 403：账号权限不足、额度不足，或被策略限制
• 404：Base URL 填成了 https://api.codebair.com，漏了 /v1
• Model not found：模型名填错，先改成 /v1/models 返回的任一可用模型

6. 什么算成功

• HTTP 状态为 200
• 返回 JSON 中包含 choices
• choices[0].message.content 有模型回复内容

7. 下一步

• 需要分客户端看详细步骤：去 客户端接入指南
• 只想给客服一个统一回复：直接把本页发给用户