Codex 安装教程（macOS）

0. 前置：安装 Node.js

先装 Node.js（建议 22+）：Nodejs macOS

1. 安装 Codex

方案 A：npm（推荐）

第一步：打开终端（按 Command + 空格，输入 Terminal，按回车）

第二步：执行安装命令

npm install -g @openai/codex

第三步：验证安装

codex --version

如果看到版本号，说明安装成功了。

方案 B：Homebrew（可选）

如果你更习惯用 Homebrew 管理软件：

brew install --cask codex

2. 配置 Codex（接入词元AI）

2.1 配置文件在哪里？

Codex 配置目录：~/.codex/

什么意思？

• ~ 表示你的用户主目录
• 完整路径是：/Users/你的用户名/.codex/

需要创建两个配置文件：

• config.toml - 主配置文件
• auth.json - 认证信息

2.2 创建配置目录

mkdir -p ~/.codex

2.3 写入主配置文件 config.toml

cat > ~/.codex/config.toml <<'EOF'
model_provider = "flashapi"
model = "gpt-5.2-codex"
approval_policy = "on-request"

[model_providers.flashapi]
name = "flashapi"
base_url = "https://api.ci-yuan-ai.com/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

配置说明：

• model_provider - 使用的服务提供商（这里是 flashapi）
• model - 默认使用的模型
• approval_policy - 执行代码前是否需要确认（on-request 表示需要）
• base_url - 词元AI的服务地址
• wire_api - 使用 OpenAI 兼容格式

2.4 写入认证文件 auth.json（注意替换 API Key）

cat > ~/.codex/auth.json <<'EOF'
{
  "OPENAI_API_KEY": "你的词元AI Key"
}
EOF

必须替换：把 你的词元AI Key 替换成你从词元AI官网复制的真实 Key

如何替换？

1. 复制上面整段命令
2. 把 你的词元AI Key 这几个字替换成你的真实 Key
3. 然后粘贴到终端执行

2.65 验证配置文件是否创建成功

ls -la ~/.codex

应该能看到 config.toml 和 auth.json 两个文件。

可选：查看配置文件内容

cat ~/.codex/config.toml

3. 启动并验证

第一步：进入你的项目目录

cd /path/to/your/project

把 /path/to/your/project 替换成你实际的项目路径。

第二步：启动 Codex

codex

如果配置正确，Codex 会启动并连接到词元AI。

常见问题

1. 提示找不到 codex 命令

原因：全局包路径没有加到 PATH 环境变量里。

解决方法：

1. 检查 Node.js 是否正确安装：node -v
2. 重启终端
3. 如果还不行，重新安装 Codex

2. 配置文件写入失败

原因：可能是权限问题或路径不存在。

解决方法：

1. 手动创建目录：mkdir -p ~/.codex
2. 然后再执行配置文件写入命令

3. API 调用失败

原因：API Key 不正确，或者词元AI账户余额不足。

解决方法：

1. 检查 auth.json 文件是否正确：cat ~/.codex/auth.json
2. 确认 API Key 是否正确（注意不要有多余的空格）
3. 登录词元AI官网检查账户余额