Codex Proxy API Key 接入文档

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

推荐方式

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

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

1. 获取 API Key

1. 登录控制台。
2. 先兑换套餐或购买额度，没有有效套餐或可用额度时，实际调用会返回 402 Insufficient credits。
3. 进入 API Keys 页面创建新的 Key。
4. 保存创建时展示的一次性明文 Key，格式类似 codex_xxxxxxxxxxxxxxxx。

WARNING

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

2. Base URL

API Base URL

https://codex.miaomiaocode.com/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

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	没有可用上游渠道，或所有渠道都失败