Codex Proxy API Key 接入文档

本文档用于说明 API Key、代码接入方式，以及 Codex、Claude Code、OpenCode、Cline、Cursor、Trae、Windsurf、Roo Code、Kilo Code 等客户端配置方法。

推荐方式

建议使用 cc-switch 配置：https://github.com/farion1231/cc-switch/releases

• Codex、Claude Code、OpenCode 等工具都推荐优先用 cc-switch 配置
• UI 配置通常比手动改配置文件更省事
• cc-switch 本质上也是在修改这些官方工具支持的配置和环境变量
• 配好后请重启对应客户端

1. 获取 API Key

1. 先登录你的账户，进入控制台或用户中心。
2. 在账户相关菜单中找到 API Keys 页面。
3. 点击创建新 Key，系统会生成一个新的 API Key。
4. 保存创建时展示的一次性明文 Key，格式类似 codex_xxxxxxxxxxxxxxxx。

WARNING

API Key 只在创建时显示一次，页面关闭后无法再次查看原始明文。

TIP

如果你已经关闭了创建弹窗、没有保存原始明文，通常只能删除旧 Key 后重新创建一个新的。

2. Base URL

API Base URL

https://enjoy.aigemini.org/v1

3. 鉴权方式

所有请求都使用标准 Bearer Token：

Authorization: Bearer codex_your_api_key

4. 文档导航

• 左侧 代码接入：面向 SDK、脚本、后端服务
• 左侧 客户端接入 / Codex：Codex CLI 配置，推荐先用 cc-switch
• 左侧 客户端接入 / OpenClaw：OpenClaw 配置，推荐先用 cc-switch
• 左侧 客户端接入 / OpenCode：OpenCode 配置，推荐先用 cc-switch
• 左侧 客户端接入 / Claude Code：Claude Code 配置，推荐先用 cc-switch
• 左侧 客户端接入 / Cline：Cline 的 OpenAI Compatible provider 配置
• 左侧 客户端接入 / Cursor：Cursor 的自定义 OpenAI 兼容配置
• 左侧 客户端接入 / Trae：Trae 的自定义 OpenAI 兼容配置
• 左侧 客户端接入 / Windsurf：Windsurf 的自定义 OpenAI 兼容配置
• 左侧 客户端接入 / Roo Code：Roo Code 的 OpenAI Compatible provider 配置
• 左侧 客户端接入 / Kilo Code：Kilo Code 的 OpenAI Compatible provider 配置

5. 支持的接口

方法	路径	说明
GET	/v1/models	获取当前网关可见模型列表
POST	/v1/chat/completions	OpenAI Chat Completions 兼容接口
POST	/v1/responses	OpenAI Responses 兼容接口
POST	/v1/embeddings	向量接口，默认模型是 text-embedding-3-small
POST	/v1/messages	Anthropic Messages 兼容接口，适用于 Claude Code 等客户端

6. 常见错误码

状态码	含义
401	API Key 无效、已停用，或 Header 没带 Bearer Token
402	账户当前不可用，或没有可用调用额度
403	用户被禁用，或当前模型访问受限
429	达到并发限制，或触发频率限制
503	没有可用上游渠道，或所有渠道都失败