Codex 配置教程

安装 Codex CLI

安装方法

三系统使用同一条 npm 命令：

npm install -g @openai/codex

验证：

codex --version

输出版本号即为安装成功。

常见问题

Q：permission denied / EACCES 错误（Mac / Linux）

不要使用 sudo，把 npm 全局目录改到用户目录：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc   # zsh 用户改为 ~/.zshrc
source ~/.bashrc

Q：permission denied 错误（Windows）

以管理员身份运行 PowerShell：

npm config set prefix "$env:APPDATA\npm"
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Q：command not found: codex

npm 全局 bin 目录未加入 PATH，执行 npm config get prefix 查看路径，将对应的 /bin 目录追加到系统 PATH。

配置 API

cc-switch（推荐）

支持 Claude Code 与 Codex 多渠道一键切换。注意：Codex 的 Base URL 需要以 /v1 结尾。

手动配置文件

Codex 读取两个配置文件：

系统	config.toml	auth.json
Windows	C:\Users\用户名\.codex\config.toml	C:\Users\用户名\.codex\auth.json
Mac / Linux	~/.codex/config.toml	~/.codex/auth.json

编辑 config.toml

model_provider = "custom"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.custom]
name = "custom"
base_url = "https://你的请求地址/v1"
wire_api = "responses"
requires_openai_auth = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

编辑 auth.json

{
  "OPENAI_API_KEY": "sk-***"
}

配置参数参考

参数	说明	可选值
model_provider	与下方配置段匹配的供应商标识	自定义名称
model	使用的模型	见模型列表
model_reasoning_effort	推理深度	low / medium / high
disable_response_storage	关闭服务端存储	建议 true
wire_api	API 协议	responses
model_context_window	上下文窗口（1M 场景填 1000000）	整数
model_auto_compact_token_limit	接近上限自动压缩	整数（通常 900000）

开始使用

在任意项目目录打开终端，输入 codex 启动：

cd 你的项目目录
codex

看到输入框后，直接用中文或英文描述需求即可，例如：

帮我用 Python 实现一个二叉搜索树，包含插入、删除、查找方法