Codex CLI

PulseNeko2026/5/20大约 1 分钟

Codex CLI 是 OpenAI 官方的命令行编程助手，对应 GPT-5 codex 系列模型。

前置

已安装 Codex CLI
在 PulseNeko Bridge 创建好一个绑定了 GPT-5 codex 可用 的分组的 Key（推荐 codex 分组）

配置文件位置

系统	路径
macOS / Linux	`~/.codex/`
Windows	`%userprofile%\.codex\`

初次安装如果目录不存在，手动创建即可。需要两个文件：config.toml 和 auth.json。

`config.toml`

model = "gpt-5.1-codex"
model_provider = "pulseneko"

[model_providers.pulseneko]
name = "PulseNeko Bridge"
base_url = "https://bridge.pulseneko.com/v1"
wire_api = "responses"
requires_openai_auth = true

字段说明：

model — 默认模型，可在运行时切换
wire_api = "responses" — Codex CLI 走 OpenAI Responses API（/v1/responses），不是 chat completions
requires_openai_auth = true — 启用 OpenAI 风格鉴权（Authorization: Bearer sk-...）

`auth.json`

{
  "OPENAI_API_KEY": "sk-你的-Key"
}

`AGENTS.md`（可选）

放在 ~/.codex/AGENTS.md，会作为全局系统提示注入到每次会话。可以写：

你的偏好语言（中文 / 英文）
代码风格约定
默认不允许触碰的操作（比如 git push --force）

模型	适合
`gpt-5.1-codex`	默认主力
`gpt-5.1-codex-mini`	轻量任务，性价比
`gpt-5.3-codex`	更新的高质量推理（如分组开放）

验证

codex

进入后随便提问。如果立刻报错：

报错	原因
`provider not found`	`config.toml` 里 `model_provider` 的值和 `[model_providers.xxx]` 的小节名对不上
`401`	`auth.json` 里 Key 写错 / 文件未保存
`wire_api` 相关	一定要写 `responses`，不能写 `chat`

切换模型

会话中输入 /model gpt-5.1-codex-mini 等可切换。