Skip to content

Codex 接入

推荐方式

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

  • UI 配置通常比手动改 ~/.codex/config.toml 更简单
  • cc-switch 改的仍然是 Codex 官方支持的配置项
  • 配置完成后重启 codex

首选做法

优先直接用 cc-switch 完成配置,不建议先手改配置文件。

安装

bash
npm i -g @openai/codex

环境变量

bash
export OPENAI_API_KEY="codex_your_api_key"

手动配置

如果你不用 cc-switch,再手动写入 ~/.codex/config.toml

model_provider = "codex_proxy"
model = "gpt-5-codex-mini"
model_reasoning_effort = "high"

[model_providers.codex_proxy]
name = "Codex Proxy"
base_url = "https://codex.miaomiaocode.com/v1"
env_key = "OPENAI_API_KEY"
requires_openai_auth = true
wire_api = "responses"

这里没有引入项目私有环境变量。实际做法是让 Codex 按它自己的官方配置,从 OPENAI_API_KEY 读取你的 API Key,再把请求发到自定义 base_url

验证

bash
codex

如果你已经能在会话里正常发起提问,说明接入成功。

OpenAI-compatible gateway integration docs