OPENAI CODEX

CodeX - macOS 安装配置

在 macOS 系统安装和配置 OpenAI CodeX，并使用智叶 API 服务。

#前置要求

Node.js 24 LTS 与 npm（推荐的统一安装环境）
macOS 系统与管理员或 sudo 权限
智叶 API 账户和 CodeX 专用分组令牌

#步骤 1：安装 Node.js

#方法 1：使用 Homebrew（推荐）

# 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node

#方法 2：从官网下载

访问 Node.js 官网，下载并安装 macOS 版本。

验证安装：

node --version
npm --version

#步骤 2：安装 CodeX CLI

# 使用 npm 安装
sudo npm install -g @openai/codex@latest

# 也可以使用 Homebrew
brew install --cask codex

# 验证安装
codex --version

#步骤 3：创建配置目录

mkdir -p ~/.codex
cd ~/.codex

#步骤 4：配置 API 端点

编辑 ~/.codex/config.toml：

model_provider = "zhiye"
model = "自行选择一个该CodeX分组支持的model（在模型广场查看）"
model_reasoning_effort = "xhigh"

[model_providers.zhiye]
name = "智叶 API"
base_url = "https://api.ziyelian.site/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

配置字段说明：

model_provider：提供商名称，本页使用zhiye。
model：填写模型广场中 CodeX 分组支持的实际 model。
model_reasoning_effort：可用档位由客户端与所选模型共同决定，不要把示例档位当作所有模型的完整列表。
env_key：读取 API Key 的环境变量名。

chmod 600 ~/.codex/config.toml

#步骤 5：配置 API 密钥

export OPENAI_API_KEY="你的智叶_API令牌"
echo 'export OPENAI_API_KEY="你的智叶_API令牌"' >> ~/.zshrc

替换令牌

将示例中的占位文本替换为智叶控制台生成的 CodeX 专用分组令牌。

#步骤 6：验证配置

codex "你好，请写一个Python函数计算斐波那契数列"

如果配置正确，CodeX 会生成代码并响应。

#VSCode 集成

#安装 CodeX 扩展

打开 VSCode。
按 Cmd+Shift+X打开扩展面板。
搜索 “CodeX” 或 “OpenAI CodeX” 并安装。

#配置 VSCode

安装扩展后，继续使用 ~/.codex/config.toml 与 OPENAI_API_KEY，无需在 VS Code 中单独填写 apiBase 或 apiKey。

#常用命令

# 启动交互式编码会话
codex

# 非交互式执行
codex exec "创建一个Express服务器"

# 代码审查
codex review --uncommitted

# 查看帮助
codex --help

快捷键（VS Code）

通过命令面板搜索 Codex，并在 VS Code“键盘快捷方式”中查看当前扩展绑定。快捷键随版本与平台变化，本页不提供未经核实的固定组合。

#高级配置

#额外配置

可用配置以 codex --help 和官方配置参考为准；需要临时覆盖时，使用 codex -c key=value。

#故障排除

#问题：权限被拒绝

sudo npm install -g @openai/codex@latest

#问题：命令未找到

npm config get prefix
echo $PATH
which codex

#问题：API 连接失败

cat ~/.codex/config.toml
test -n "$OPENAI_API_KEY" && echo "已设置" || echo "未设置"
curl -I https://api.ziyelian.site/v1

#问题：M1/M2 芯片兼容性

# Apple Silicon 使用原生 arm64 Node.js；Intel Mac 使用 x64。
uname -m
node -p "process.arch"
npm install -g @openai/codex@latest

#使用技巧

# 初始化交互式会话
codex

# 一次性任务
codex exec "创建一个 React 用户认证组件，并保存为 AuthComponent.tsx"

# 审查未提交改动
codex review --uncommitted

#Shell 集成

#Zsh 自动补全

eval "$(codex completion zsh)"

#Bash 自动补全

eval "$(codex completion bash)"

#下一步

提示

macOS 用户推荐使用 Homebrew 管理 CodeX：brew upgrade codex