如何安装Codex？OpenAI Codex CLI完整安装教程与配置指南

分类：AI功能使用 更新：2025-10-28 难度：简单

OpenAI Codex CLI是一个可以在终端本地运行的编码代理工具，能够读取、修改和运行代码。它基于Rust构建，开源免费，与Cursor AI编程工具完美协作，提升开发效率。

Codex CLI简介

核心特性

  1. 本地运行：在终端中直接运行，保护代码隐私
  2. 智能编码：可读取代码库、修改文件、执行命令
  3. 高性能：基于Rust构建，速度快、效率高
  4. 开源项目：在GitHub开源，持续更新优化

系统支持

  1. macOS：完全支持，推荐使用
  2. Linux：完全支持，稳定运行
  3. Windows：实验性支持，建议使用WSL

安装方法

方式一：使用npm安装（推荐）

全局安装命令

npm install -g @openai/codex

npm安装优势

npm方式安装简单快捷，适合大多数开发者。确保已安装Node.js 18+版本。

方式二：使用Homebrew安装

macOS/Linux安装命令

brew install codex

首次运行与认证

启动Codex

运行命令

codex

认证方式

  1. ChatGPT账户认证（推荐）：使用Plus、Pro、Team、Edu或Enterprise计划账户
  2. API密钥认证：需要额外配置，适合高级用户

认证注意事项

首次运行时会提示认证，推荐使用ChatGPT账户登录。API密钥方式需要在定价页面了解详细信息。

升级与维护

npm升级

升级到最新版本

npm install -g @openai/codex@latest

Homebrew升级

升级命令

brew upgrade codex

基本使用

交互模式

Codex运行在交互式终端界面中，可以自然语言对话，让AI读取代码库、编辑文件和执行命令。

直接执行任务

带提示启动

codex "explain this codebase"

模型配置

  • 默认模型：GPT-5（通用AI模型）
  • 编码优化：GPT-5-Codex（专为编程优化）
  • 切换方法：使用`/model`命令

Windows安装指南

Windows特殊说明

Windows支持仍在实验阶段，强烈建议在WSL（Windows Subsystem for Linux）环境中运行，以获得最佳体验。

WSL安装步骤

  1. 启用WSL功能：wsl --install
  2. 安装Ubuntu或其他Linux发行版
  3. 在WSL中按Linux方式安装Codex
  4. 通过WSL终端运行Codex

故障排除

常见安装问题

权限错误解决

# npm权限问题
sudo npm install -g @openai/codex

# 设置npm全局目录（推荐）
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

网络连接问题

  • 检查网络：确保能访问OpenAI服务
  • 代理设置：配置npm或系统代理
  • 防火墙：检查防火墙设置

与Cursor的协作

由于Cursor响应越来越慢了，Codex CLI与Cursor形成完美互补：Cursor专注于IDE内的智能编程，Codex在终端提供强大的命令行AI支持，两者结合可实现全方位的AI编程体验。

相关问题