Codex — macOS 安装配置
本指南帮助你在 macOS 上安装并配置 OpenAI Codex CLI，接入 TinyPx API 服务。
前置要求
- macOS 10.15 (Catalina) 或更高版本
- Node.js 18.0 或更高版本
- npm 或 Homebrew 包管理器
步骤 1：安装 Node.js
方法 1：Homebrew（推荐）
bash
# 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node.js
brew install node方法 2：官网下载
访问 nodejs.org 下载并安装 macOS 版本。
验证安装：
bash
node --version
npm --version步骤 2：安装 Codex CLI
bash
sudo npm install -g @openai/codex@latest或使用 Homebrew：
bash
brew install --cask codex验证安装：
bash
codex --version步骤 3：创建配置目录
bash
mkdir -p ~/.codex
cd ~/.codex步骤 4：配置 API 端点
bash
cat > ~/.codex/config.toml << 'EOF'
model_provider = "tinypx"
model = "填写该 Codex 分组支持的模型名"
model_reasoning_effort = "xhigh"
[model_providers.tinypx]
name = "TinyPx API"
base_url = "https://ai.tinypx.cn/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF或用文本编辑器手动创建：
toml
model_provider = "tinypx"
model = "填写该 Codex 分组支持的模型名"
model_reasoning_effort = "xhigh"
[model_providers.tinypx]
name = "TinyPx API"
base_url = "https://ai.tinypx.cn/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"注意端点格式
Codex 必须带 /v1 后缀 —— 使用 https://ai.tinypx.cn/v1。 详见 API 端点说明。
可用模型
具体可用模型请访问 模型广场 查看该 Codex 分组支持的 model 及价格。
步骤 5：配置 API 密钥
bash
export OPENAI_API_KEY="你的 TinyPx API 令牌"
echo 'export OPENAI_API_KEY="你的 TinyPx API 令牌"' >> ~/.zshrc
source ~/.zshrc设置文件权限（重要）：
bash
chmod 600 ~/.codex/config.toml安全提示
请把占位文本替换为你从 TinyPx API 控制台 获取的实际令牌， 并确保 shell 配置文件权限正常。
步骤 6：验证配置
bash
codex "你好，请写一个 Python 函数计算斐波那契数列"VSCode 集成
- 打开 VSCode
- 按
Cmd+Shift+X打开扩展面板 - 搜索 "Codex" 或 "OpenAI Codex"
- 点击安装
安装扩展后，实际配置继续使用前面的 ~/.codex/config.toml 和 OPENAI_API_KEY 即可，不需要在 VSCode 里单独填写 apiBase 或 apiKey。
常用命令
bash
# 启动交互式编码会话
codex
# 非交互式执行
codex exec "创建一个 Express 服务器"
# 代码审查
codex review --uncommitted
# 查看帮助
codex --help高级配置
更多可用配置请参考 codex --help 和官方配置参考。若需临时覆盖配置，可以用 codex -c key=value。
故障排除
权限被拒绝
bash
sudo npm install -g @openai/codex@latest命令未找到
bash
npm config get prefix
echo $PATH添加到 PATH：
bash
# Zsh
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.zshrc
source ~/.zshrc
# Bash
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.bash_profile
source ~/.bash_profileAPI 连接失败
bash
# 检查配置
cat ~/.codex/config.toml
echo $OPENAI_API_KEY
# 测试网络连接
curl -I https://ai.tinypx.cn/v1
# 检查日志
tail -f ~/.codex/logs/codex.logApple Silicon（M 系列芯片）兼容性
bash
# 使用 Rosetta
arch -x86_64 npm install -g @openai/codex@latest
# 或指定原生架构
npm install -g @openai/codex@latest --target_arch=arm64Shell 自动补全
bash
# Zsh，添加到 ~/.zshrc
eval "$(codex completion zsh)"
# Bash，添加到 ~/.bash_profile
eval "$(codex completion bash)"使用技巧
bash
# 启动一次交互式会话
codex
# 让 Codex 在当前项目中执行一次性任务
codex exec "创建一个 React 用户认证组件，并保存为 AuthComponent.tsx"
# 审查当前未提交改动
codex review --uncommitted下一步
提示
macOS 用户推荐用 Homebrew 管理 Codex，更新方便：brew upgrade codex