文档
获取 API Key
创建和管理用于编程工具、SDK 与 API 调用的 AIGoCode API Key
API Key 是调用 AIGoCode 服务的身份凭证。配置 Claude Code、Codex 等工具，或通过代码调用模型时，都需要填写对应的 API Key。
创建 API Key
- 注册并登录 AIGoCode 控制台。
- 打开 模型广场，选择需要使用的供应商和分组。
- 核对该分组的「接入协议」「适用工具」、模型列表和价格。
- 点击「创建 API Key」，填写备注名称并确认创建。
- 复制生成的 Key，保存到密码管理器或本地环境变量中。
创建后，可以在 我的密钥 中管理已有 Key。
名称与分组规则
| 项目 | 说明 |
|---|---|
| 备注名称 | 用于区分工具、项目或使用环境，例如「Claude Code」「开发环境」；不影响调用能力 |
| 接入分组 | 决定该 Key 可调用的模型、适用工具、协议与计费价格 |
| 多把 Key | 可以分别绑定不同分组，但共用账户额度；创建新 Key 不会额外获得额度 |
| 调整分组 | 调整后，调用范围和价格随新分组变化，原有工具配置也需要与新分组匹配 |
先确认分组能用于你的工具和调用方式，再比较模型、价格与线路特性。
使用 curl、SDK 或第三方应用时，应选择支持外接调用的分组。标明「仅限 Claude Code」或「仅限 Codex 官方客户端」的分组，不适合直接套用通用 API 示例。
在工具或代码中使用
- 编程工具：按对应教程，通过 AIGoCode Desktop、CC Switch 或手动配置填写 Key。
- 代码调用：将 Key 保存为环境变量，并使用所选协议要求的认证字段。
| 协议 | 认证字段 |
|---|---|
| OpenAI 兼容 | Authorization: Bearer YOUR_API_KEY |
| Anthropic Messages | x-api-key: YOUR_API_KEY |
| Gemini 原生兼容 | x-goog-api-key: YOUR_API_KEY |
完整请求配置见 鉴权。
保管与更换
API Key 可以消耗账户额度，请妥善保管：
- 不要提交到 Git 仓库或放入公开的前端代码。
- 分享截图、配置和日志前，先隐藏 Key。
- 不同项目或工具尽量使用独立 Key，方便管理和更换。
- 发现泄露时，删除旧 Key、创建新 Key，并更新使用它的工具或应用。
下一步
- 快速开始：使用对应分组的 Key，完成第一次调用。
- Agent 工具接入：按工具教程完成配置。
- 鉴权：查看不同协议的请求头与环境变量用法。