第一步是确保Python和pip环境就绪：运行python --version和pip --version验证，若pip缺失则执行python -m ensurepip --upgrade；第二步安装Codex CLI工具，推荐pip install codex-cli（v0.8.4），或npm install -g @openai/codex（二者不兼容）；第三步安装并验证OpenAI Python SDK，需≥1.0.0版本，旧版须强制卸载重装；第四步配置API密钥：创建项目根目录下的.env文件写入OPENAI_API_KEY=sk-xxx，并pip install python-dotenv以启用自动读取。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在终端里执行 pip 命令安装 Codex 相关工具，是启动本地开发环境的第一步，必须确保 Python 环境就绪、pip 可用且权限正确，否则后续所有命令都会失败。
确认 Python 和 pip 是否可用
打开终端（Windows 用 PowerShell，macOS/Linux 用 Terminal），输入：
python --version 或 python3 --version
若返回类似 Python 3.9.18 的结果，说明 Python 已安装；若提示“command not found”，需先安装 Python（推荐从 python.org 下载 3.9+ 安装包）。
接着运行：
pip --version
如果报错“No module named pip”，说明 pip 未随 Python 自动安装。此时执行：
python -m ensurepip --upgrade
安装 Codex CLI 工具
方法一：使用 pip 安装官方 Codex CLI（推荐）
在终端中直接运行：
pip install codex-cli
这会自动拉取截至 2026 年 6 月的最新稳定版 v0.8.4 及全部依赖。安装过程无需额外参数，等待几秒即可完成。
方法二：全局安装（仅限 Node.js 用户）
如果你更习惯用 npm 管理命令行工具，可运行：
npm install -g @openai/codex
【注意：此方式与 pip 安装的 codex-cli 不兼容，二者不能共存】
验证是否安装成功：
codex --version
终端应输出版本号（如 0.8.4），表示 CLI 已就位。
安装 OpenAI Python SDK（关键前置依赖）
第一步：确保 openai 库版本 ≥ 1.0.0
运行：
pip install openai
第二步：检查是否残留旧版（v0.x）
若之前装过老版本，调用时会报错【model 参数不被识别】。
执行强制清理：
pip uninstall openai -y && pip install openai
第三步：验证 SDK 可用性
在 Python 交互环境中测试：
python -c "import openai; print(openai.__version__)"
输出应为 1.45.0 或更高——低于 1.0.0 的版本无法对接当前 Codex API。
配置 API 密钥（跳过登录环节）
步骤一：创建项目根目录下的 .env 文件
用任意文本编辑器新建一个名为 .env 的文件，放在你准备运行 Codex 脚本的文件夹里。
步骤二：写入密钥
在 .env 中添加一行：
OPENAI_API_KEY=sk-xxx（把你从 platform.openai.com 复制的密钥粘贴在等号后）
步骤三：安装 dotenv 支持库
运行：
pip install python-dotenv
【必须执行这一步，否则 .env 文件会被忽略】
现在，任何调用 openai 库的 Python 脚本都会自动读取该密钥，无需硬编码，也无需在终端手动登录 Codex。
