Codex 接入

Codex CLI 与 Codex IDE 插件走 /v1/responses 接口，接入方式是设置两个环境变量。

1. 设置环境变量

export OPENAI_BASE_URL="https://gateport.dev/v1"
export OPENAI_API_KEY="sk-..."

写入 shell 配置（~/.zshrc 或 ~/.bashrc）可以长期生效：

echo 'export OPENAI_BASE_URL="https://gateport.dev/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

2. 验证

echo "你好" | codex exec -m gpt-6.1-sol

能正常返回即接入成功。

3. 推荐模型

场景	模型
日常编码	gpt-6.1-sol
复杂重构	gpt-6-sol
快速补全	gpt-6-luna

4. 关于会话与缓存

Codex 的每次请求会带一个稳定的 prompt_cache_key，服务端据此让同一会话尽量落在同一条线路上，以命中上游缓存、降低费用。

如果某条线路繁忙，请求会自动转移动另一条线路，此时该次请求不再命中原缓存（但不会失败）。

5. 常见问题

Q：提示 401？

检查 OPENAI_API_KEY 是否是 sk- 开头的完整密钥，以及是否已保存到环境变量。

Q：提示 429？

说明当前并发或上游额度触顶，Codex 会自动重试；如果持续出现，稍后再试。

Q：可以用 https://gateport.dev/v1 以外的地址吗？

旧地址 https://api.zhouyiwei.cn/v1 仍然可用，但建议切换到新地址。