macOS 安装指南

1. 安装 Codex CLI

使用 npm 或 Homebrew 安装：

# 方式一：使用 npm
npm install -g @openai/codex

# 方式二：使用 Homebrew
brew install codex

更多安装问题请查看官方仓库

2. 创建 auth.json 文件

删除 ~/.codex 路径下已存在的 auth.json 文件（若有），然后新建：

# 删除旧文件（如果存在）
rm -f ~/.codex/auth.json

# 创建目录（如果不存在）
mkdir -p ~/.codex

创建 ~/.codex/auth.json 文件，内容为：

{
  "OPENAI_API_KEY": "你的API_KEY"
}

3. 创建 config.toml 文件

配置文件必须命名为 config.toml 并使用 TOML 格式，千万不要误创建 config.json 或其他格式。

# 删除旧文件（如果存在）
rm -f ~/.codex/config.toml

选择访问线路

我们提供两个访问线路，请根据你的网络环境选择其中一个：

适用于：大部分国内用户，无需代理

创建 ~/.codex/config.toml 文件，粘贴以下内容：

model_provider = "aicodewith"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
requires_openai_auth = true

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.jiuwanliguoxue.com/chatgpt/v1"
wire_api = "responses"

适用于：国内直连不稳定时使用，需要自己挂代理

创建 ~/.codex/config.toml 文件，粘贴以下内容：

model_provider = "aicodewith"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
requires_openai_auth = true

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.com/chatgpt/v1"
wire_api = "responses"

不确定选择哪个线路？查看线路选择指南了解详情。

4. 验证安装

codex hi

常见问题

Q: 报错找不到配置文件？

请确认 ~/.codex/ 目录下同时存在 auth.json 和 config.toml 两个文件。

Q: 报错 401 Unauthorized?

请检查 auth.json 中的 API Key 是否正确，且账户余额充足。

macOS 安装