Codex超详细下载、安装、配置教程详解

Codex 是 OpenAI 推出的终端 AI 编程助手，能够在本地项目中读取代码、修改文件、执行命令，并提供 Suggest、Auto Edit、Full Auto 等审批模式。 目前它主要有三种使用形态：桌面应用、命令行 CLI 和 IDE 扩展。 下面以官方推荐的 CLI 安装方式为主，同时补充桌面版和常见配置要点。

一、下载与安装方式

使用 Codex CLI 前，需要先安装 Node.js，建议使用较新的 LTS 版本；官方文档中推荐 Node.js 22 及以上版本。 安装完成后，在终端执行 node -v 和 npm -v 确认环境可用。 Windows 用户建议重新打开终端，使 PATH 生效。

推荐安装命令为：

npm install -g @openai/codex

安装完成后执行：

codex --version

能正常输出版本号即表示安装成功。 如果提示命令不存在，通常是 npm 全局目录未加入 PATH。 macOS 用户也可以通过 Homebrew 安装桌面版或相关组件，但 CLI 更新通常以 npm 包为主。 Windows 用户若遇到兼容性问题，可考虑在 WSL2 中运行 Codex CLI。

桌面版用户应从 OpenAI 官方页面下载对应系统的安装包，避免使用来路不明的整合包或第三方安装包。 Windows 上可能通过微软商店或官方安装程序获取，macOS 上通常为 dmg 安装包。

二、登录与 API Key 配置

Codex 支持两种主要登录方式。第一种是使用 ChatGPT 账号登录，终端执行 codex login 后会打开浏览器完成授权，适合个人开发者日常使用。 第二种是使用 OpenAI API Key，适合需要脚本化调用、企业接入或第三方兼容 API 的场景。

使用 API Key 时，可在终端设置环境变量：

export OPENAI_API_KEY="sk-..."

Windows PowerShell 中可写为：

$env:OPENAI_API_KEY="sk-..."

也可以将环境变量写入 ~/.zshrc、~/.bashrc 或用户级环境变量中，使其长期生效。 若使用阿里云百炼、Azure OpenAI 或其他兼容接口，则需要在 ~/.codex/config.toml 中配置 model_provider、base_url、wire_api 和 env_key 等字段。

需要注意，Codex CLI 的配置文件通常位于 ~/.codex/，Windows 下为 %USERPROFILE%\.codex\。 修改配置后应重启终端或重新启动 Codex，使配置生效。

三、首次启动与审批模式

进入项目目录后执行：

cd your-project
codex

首次启动时，Codex 可能会提示当前目录不在 Git 仓库中。 由于 Codex 会读取和修改本地文件，建议先在重要项目中执行 git init 并提交初始状态，方便回滚。

Codex 提供三种审批模式：Suggest 模式下，所有文件修改和命令执行都需要用户确认，适合新手；Auto Edit 模式下，Codex 可以自动读写文件，但执行命令前仍需确认；Full Auto 模式下，Codex 会在受限沙箱中自动执行，但仍需注意项目安全边界。 日常开发建议从 Suggest 模式开始，确认其行为可靠后再切换更高权限模式。

四、注意事项与常见问题

第一，包名必须写全 @openai/codex，不要安装名称相近的第三方包。 第二，国内网络访问 npm 或 OpenAI 接口时可能超时，可检查代理、镜像源或网络环境，但不要反复强制重装。 第三，API Key 不要硬编码到代码仓库中，应通过环境变量或配置文件管理，并避免提交到 Git。

第四，Codex 能直接修改文件和执行命令，使用前应确认项目已备份或纳入版本控制。 第五，桌面版、CLI 和 IDE 扩展的配置可能不完全一致，切换形态时需重新确认登录状态和模型设置。 第六，若使用第三方中转 API 或整合包，需要自行判断其安全性，官方教程应以 OpenAI 文档和官方下载页面为准。

Codex 的安装并不复杂，核心步骤是准备 Node.js 环境、通过 npm install -g @openai/codex 安装 CLI、配置账号登录或 API Key，并在项目目录中启动。 桌面版用户应坚持从官方渠道下载，CLI 用户应重点关注 PATH、环境变量和配置文件。 由于 Codex 具备读写文件和执行命令的能力，使用时务必开启合适的审批模式、保持 Git 版本控制，并妥善保管 API 密钥，这样才能在提升开发效率的同时降低安全风险。

声明：所有来源为“聚合数据”的内容信息，未经本网许可，不得转载！如对内容有异议或投诉，请与我们联系。邮箱：marketing@think-land.com