Codex CLI 安装与配置指南

本文将带你从零开始安装 OpenAI Codex CLI，配置 API Key，设置沙箱模式，并与 ProjectManager 集成。

安装前提

在安装 Codex CLI 之前，请确保你的环境满足以下条件：

• Node.js 22+ — Codex CLI 需要较新的 Node.js 版本
• OpenAI API Key — 前往 OpenAI Platform 获取 API Key
• Git — 用于版本控制和代码回滚

检查 Node.js 版本：

node --version
# 应输出 v22.x.x 或更高

安装步骤

全局安装

npm install -g @openai/codex

验证安装

codex --version
# 应输出 codex/x.x.x

首次运行

codex
# 首次运行会提示输入 API Key

配置详解

API Key 配置

Codex CLI 支持以下方式配置 API Key：

• 环境变量 — OPENAI_API_KEY，推荐方式
• 交互式输入 — 首次运行时提示输入
• .env 文件 — 在项目根目录创建 .env 文件

export OPENAI_API_KEY=sk-xxxxx

模型选择

Codex CLI 支持以下模型，通过 --model 参数指定：

• o4-mini — 默认模型，速度快，成本低
• o3 — 更强的推理能力，适合复杂任务

codex --model o3

沙箱模式

Codex CLI 内置沙箱模式，限制 AI 的操作权限：

• 建议模式（默认） — AI 的写操作需要用户确认
• 自动编辑模式 — AI 可以自动编辑文件，但执行命令仍需确认
• 完全自动模式 — AI 可以自动执行所有操作（--full-auto）

codex                        # 建议模式（默认）
codex --full-auto            # 完全自动模式

建议仅在可信环境中使用完全自动模式，并始终配合 Git 使用以便回滚。

自定义 Base URL

如果你使用代理或兼容 OpenAI API 的第三方服务：

export OPENAI_BASE_URL=https://your-proxy.example.com/v1

与 Wishmere 集成

Wishmere 可以自动检测已安装的 Codex CLI，你可以根据项目类型选择合适的智能体：

• 需要深度推理的任务 — 自动使用 Claude Code
• 需要快速迭代的任务 — 自动使用 Codex CLI

在 Wishmere 的项目设置中，你可以配置默认工具和模型切换策略。

常见问题

1. Node.js 版本不满足

Codex CLI 需要 Node.js 22+，如果版本过低：

nvm install 22
nvm use 22
npm install -g @openai/codex

2. 沙箱权限被拒绝

如果沙箱模式下操作被拒绝，检查是否缺少必要的系统权限。macOS 用户可能需要在"系统偏好设置 → 安全性与隐私"中允许终端操作。

3. API 调用频率限制

OpenAI API 有调用频率限制。如果遇到 429 错误，等待片刻后重试，或升级 API 计划。

4. 输出乱码

如果终端输出乱码，确保终端支持 UTF-8 编码：

export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

下一步

• Codex CLI 使用指南：从入门到避坑 — 深入了解 Codex CLI 的用法和注意事项
• Claude Code 安装与配置指南 — 了解另一个 AI 编程工具的安装方式
• Claude Code 常见 10 个坑及解决方案 — 对比学习，避免类似问题

使用 Wishmere 可以同时管理 Claude Code 和 Codex CLI，根据任务自动选择最合适的工具，让你专注于功能本身。

← 返回文章列表