开始使用
选择接入方式
在直接 API、普通客户端和辅助工具之间选择。
准备：先按目标分类
准备好已经通过 GET /v1/models 验证的 Base URL、API Key 和模型 ID。不要从工具名称猜用途，先确定你是要写程序、使用现成客户端，还是管理多个工具环境。
用途分流始终从同一条 cURL 基线开始：自己的程序走直接 API；Codex、Cursor 等走普通客户端；CC Switch 用于 Provider 与客户端配置切换；Cockpit Tools 用于账户、实例、配额与启动入口管理。后两者是辅助工具，不代替真正发出 API 请求的程序或客户端。
决策表
| 你的目标 | 类型 | 选择 | 说明 |
|---|---|---|---|
| 在自己的脚本、后端或服务中发送请求 | 直接调用 API | Responses API 或兼容 API | 自己控制请求体、超时、重试和密钥存储 |
| 在编辑器或桌面工具中对话、改代码 | 普通客户端 | Codex、Cursor、Continue、Cline / Roo Code、OpenCode | 客户端直接使用 Base URL、Key 和模型 |
| 切换 Provider，或管理账户、多实例、配额与启动入口 | 辅助工具 | 辅助工具概览 | 辅助管理现有工具，不等于普通 API 客户端 |
操作步骤
成功标志
目标工具返回正常结果，并且用量页出现对应 Key、模型和端点记录。
失败时先检查
先确认同一把 Key 的 cURL 是否仍成功。cURL 成功而工具失败，检查 Base URL、Provider 类型、模型缓存和代理；cURL 也失败，回到模型列表和常见错误。
安全边界
Key 只能填入正式程序的受信任密钥字段或受控后端。不要把 Key 放入前端代码、公开配置、截图、插件反馈或 Git；第三方工具能读取 Key 时，应独立创建可撤销、有限额的专用 Key。
下一步
直接 API 从 Responses API开始；普通客户端进入对应配置页；只需要 Provider 切换或多实例管理时，再读辅助工具概览。