OPENAI CODEX

CodeX - macOS 安装配置

在 macOS 系统安装和配置 OpenAI CodeX，并使用千模岛 API 服务。

#前置要求

Node.js 18 或更高版本与 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 = "qianmodao"
model = "自行选择一个该CodeX分组支持的model（在模型广场查看）"
model_reasoning_effort = "xhigh"

[model_providers.qianmodao]
name = "千模岛 API"
base_url = "https://www.qianmodao.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

配置字段说明：

model_provider：提供商名称，本页使用qianmodao。
model：填写模型广场中 CodeX 分组支持的实际 model。
model_reasoning_effort：可选 low、medium、high、xhigh。
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

#快捷键（VSCode）

Cmd+Shift+X：打开 CodeX 面板
Cmd+Shift+I：内联代码生成
Cmd+Shift+E：解释选中代码
Cmd+Shift+O：优化选中代码
Tab：接受代码建议
Esc：拒绝代码建议
Cmd+K Cmd+G：生成代码注释

#高级配置

#额外配置

可用配置以 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
echo $OPENAI_API_KEY
curl -I https://www.qianmodao.com/v1

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

arch -x86_64 npm install -g @openai/codex@latest
npm install -g @openai/codex@latest --target_arch=arm64

#使用技巧

# 初始化交互式会话
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