Codex 安装与配置教程 (Windows+macOS)

什么是 Codex？

Codex 是 OpenAI 推出的一款面向开发者的代码智能助手（CLI 命令行工具），底层基于 OpenAI 优化后的 GPT 系列大语言模型，专门针对代码生成、理解、调试、重构 等编程场景做了深度适配。它区别于通用的聊天式 AI，核心聚焦编程领域，能通过自然语言指令快速响应开发者的代码需求，且支持关联本地项目上下文，提供更贴合实际开发场景的解决方案。

Codex 的核心用途

1. 代码生成：通过自然语言描述需求（如 “写一个 Python 函数实现文件批量重命名”），自动生成可运行的多语言代码片段；

2. 代码理解与调试：输入现有代码或报错信息，询问逻辑含义、潜在问题或修复方案；

3. 交互式编程辅助：以命令行对话形式，实时解答编程疑问、补充代码注释、优化代码结构；

4. 项目上下文适配：进入本地项目目录后启动 Codex，可识别项目文件结构和已有代码，提供贴合项目的个性化建议。

Codex 同类型工具

市面上与 Codex 定位相似的代码智能助手主要分为两类：

• 商业化工具：GitHub Copilot（底层基于 OpenAI Codex，集成到 VS Code/IDE）、Cursor（AI 原生代码编辑器）、Tabnine（多 IDE 适配的代码补全工具）、JetBrains AI（集成到 IntelliJ 等 IDE）；

• 开源 / 国产工具：CodeLlama（Meta 开源代码大模型）、通义灵码（阿里云）、讯飞星火代码助手、百度 Comate、腾讯云智服代码助手。

安装与配置教程

一、安装 Node.js（LTS 长期支持版）

Windows 系统

1. 访问官网：https://nodejs.org/，下载 LTS 长期支持版（.msi 格式安装包）

2. 运行安装包，保持默认设置，勾选「Add to PATH」（自动配置环境变量）

3. 验证安装（打开 CMD/PowerShell）：

   node --version
   npm --version
   

   显示版本号即安装成功。

macOS 系统

• 方式一（官网安装）：访问 https://nodejs.org/，下载 LTS 版（.pkg 格式），按向导完成安装

• 方式二（Homebrew 安装，优先）：

  brew install node
  

• 验证安装（打开终端）：

  node --version
  npm --version
  

  显示版本号即安装成功。

二、安装 Codex CLI（跨平台通用）

1. 打开终端（Windows：PowerShell/CMD；macOS：终端），执行全局安装命令：

   npm i -g @openai/codex --registry=https://registry.npmmirror.com
   

2. 验证安装：

   codex --version
   

   显示版本号即安装成功。

权限问题解决

• Windows：提示权限不足时，以「管理员身份」重新打开终端重试

• macOS：提示权限不足时，在安装命令前加 sudo（输入开机密码）：

  sudo npm i -g @openai/codex --registry=https://registry.npmmirror.com
  

三、永久配置环境变量（核心步骤）

需配置两个变量：OPENAI_BASE_URL（接口地址）、OPENAI_API_KEY（专属密钥）

Windows 系统

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」

2. 在「用户变量」区域点击「新建」，添加以下两条变量：

   表格

   变量名	变量值
   OPENAI_BASE_URL	你的接口地址
   OPENAI_API_KEY	你的专属密钥

3. 点击「确定」保存，关闭并重新打开 PowerShell（使配置生效）

4. 验证配置：

   echo $env:OPENAI_BASE_URL
   echo $env:OPENAI_API_KEY
   

   显示对应值即配置成功。

macOS 系统

1. 打开终端，编辑配置文件（默认 zsh，bash 替换为 .bashrc）：

   nano ~/.zshrc
   

2. 在文件末尾添加（替换为实际信息）：

   export OPENAI_BASE_URL="你的接口地址"
   export OPENAI_API_KEY="你的专属密钥"
   

3. 保存退出：按 Ctrl+O → 回车确认 → 按 Ctrl+X

4. 使配置立即生效：

   source ~/.zshrc
   

5. 验证配置：

   echo $OPENAI_BASE_URL
   echo $OPENAI_API_KEY
   

   显示对应值即配置成功。

四、基础使用方法

启动 Codex

• 打开终端，直接输入：codex（首次启动自动初始化，进入交互式对话）

• 关联项目：先进入项目文件夹，再执行 codex（自动识别项目上下文）

退出 Codex

• 输入命令：exit → 回车

• 快捷键：Ctrl+C

五、常见问题排查

表格

总结

1. Codex 是 OpenAI 推出的代码智能助手，核心用于代码生成、调试和理解，同类工具包括 GitHub Copilot、CodeLlama、通义灵码等；

2. 安装核心步骤：先装 Node.js（LTS 版），再全局安装 Codex CLI，最后配置 OPENAI_BASE_URL 和 OPENAI_API_KEY 环境变量；

3. 配置后需验证环境变量生效，遇到权限 / 命令未找到问题，优先检查 Node.js 环境和终端权限。