OpenAI Codex CLI 接入¶

Codex 是 OpenAI 官方的命令行编程 Agent，兼容 OpenAI 风格接口。把 OPENAI_BASE_URL 指向 LowCostAI 即可使用。

前置要求¶

macOS / Linux / Windows（推荐 WSL）
有效的 LowCostAI API Key（前往创建）

第一步：安装 Codex CLI¶

npm install -g @openai/codex

# 或 Homebrew（macOS）
brew install codex

验证安装：

codex --version

第二步：配置¶

方式一：环境变量（最快）¶

export OPENAI_BASE_URL="https://api.lowcostaiapi.com/v1"
export OPENAI_API_KEY="YOUR_TOKEN"

写入 ~/.zshrc / ~/.bashrc 可永久生效。

方式二：config.toml（推荐，可配模型）¶

编辑 ~/.codex/config.toml：

model_provider = "lowcostai"
model = "gpt-5-codex"

[model_providers.lowcostai]
name = "LowCostAI"
base_url = "https://api.lowcostaiapi.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

然后设置 Key：

export OPENAI_API_KEY="YOUR_TOKEN"

【待确认】model 填控制台实际提供的 Codex 模型 ID；若线上未开通 Responses 协议，把 wire_api 改为 "chat"。

第三步：开始使用¶

cd your-project
codex "add unit tests for utils.py"

推理强度（effort）¶

Codex 系列模型支持调节推理强度：low / medium / high / xhigh。强度越高推理越深入，但耗时与消耗也相应增加。可在 config.toml 中设置：

model_reasoning_effort = "medium"

日常任务用 medium 即可，疑难问题再上 high。

常见问题¶

401 / API Key 无效¶

确认 OPENAI_API_KEY 无多余空格、Key 为启用状态；
确认没有残留的官方登录凭证（codex logout 或检查 ~/.codex/auth.json）。

404 / 模型不存在¶

Base URL 是否带了 /v1；
model 是否为模型列表中的 ID。

请求超时¶

检查本地网络与代理设置；先用 cURL 验证 Key 与连通性，再排查工具配置。