大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



摘要：本文是国内开发者使用 OpenAI Codex 的终极配置指南，涵盖 Windows、macOS、Linux 三大主流操作系统的完整安装流程。通过 API独立站 解决网络访问难题，手把手教你完成从环境准备到实战使用的全部步骤，让你无需复杂操作即可体验 AI 编程的强大能力。

---

Codex 是 OpenAI 官方推出的命令行 AI 编程助手工具，专为开发者打造。它基于 OpenAI 最新的大语言模型技术，能够理解自然语言描述并生成高质量的代码，是提升开发效率的利器。

Codex 不仅仅是一个代码生成工具，更是一个全方位的编程助手，可以：

• 根据自然语言描述生成完整的功能代码
• 分析现有代码的结构和潜在问题
• 协助调试和修复 Bug
• 自动生成代码文档和注释
• 与命令行环境无缝集成

为了直观展示 Codex 的价值，我们来看一个典型开发场景的效率对比：

从上表可以看出，使用 Codex 可以将原本需要数小时的开发工作压缩到几分钟内完成，效率提升高达 50 倍以上。这种效率的飞跃，让开发者能够将更多精力投入到架构设计和创新思考中。

Codex 提供以下五大核心功能：

Codex 支持多种主流操作系统，覆盖绝大多数开发环境：

---

在开始安装 Codex 之前，请确保你的系统满足以下基本要求：

由于网络环境限制，国内开发者需要通过镜像 API 站点来使用 Codex。以下是详细的注册配置流程：

2.2.1 注册账号

1. 访问 API独立站 进行账号注册
2. 完成邮箱验证和基本信息填写
3. 登录后进入控制台界面

2.2.2 创建 API 令牌

1. 点击左侧菜单「控制台」→「API令牌」页面
   
   
   
   
2. 点击「添加令牌」按钮
3. 重要：令牌分组请选择 “openai codex 专用”（务必选择此分组，否则无法使用）
4. 令牌名称可自定义，如 “codex-dev”
5. 额度建议设置为「无限额度」，避免使用中额度耗尽
6. 其他选项保持默认，点击「提交」
7. 复制生成的令牌密钥（格式为 sk-xxx），妥善保存

2.2.3 配置文件说明

Codex 需要两个核心配置文件：

---

• Windows 10 或 Windows 11（64位）
• Node.js 22 或更高版本
• npm 10 或更高版本
• 稳定的网络连接

Windows 系统建议先安装 Git Bash，以获得更好的命令行体验：

1. 访问 Git 官网 下载 Windows 版本
2. 运行安装程序，保持默认选项一路点击「Next」
3. 安装完成后，可在开始菜单找到「Git Bash」

1. 访问 Node.js 官网 下载最新 LTS 版本
2. 运行安装程序，按提示完成安装
3. 安装完成后，打开 CMD 或 PowerShell 验证：

node --version npm --version 

打开命令提示符（CMD）或 PowerShell，执行以下命令：

npm install -g @openai/codex 

安装过程可能需要几分钟，请耐心等待。

安装完成后，验证 Codex 是否正确安装：

codex --version 

如果显示版本号，说明安装成功。

重要提示：请将下方的 sk-xxx 替换为你在 API独立站 生成的实际 API 密钥！

3.6.1 创建配置目录

1. 打开文件资源管理器，进入当前用户的用户目录
2. 找到或创建 .codex 文件夹（路径示例：C:Users你的用户名.codex）

3. 如果看不到隐藏目录，请在文件资源管理器的「查看」选项卡中勾选「隐藏的项目」

3.6.2 创建配置文件

在 .codex 文件夹中创建两个文件：auth.json 和 config.toml

auth.json 内容(需要将sk-xxx替换成刚才在API站点创建的真实的sk)：

{ "OPENAI_API_KEY": "sk-xxx" } 

config.toml 内容：

model_provider = "aigcbar" model = "gpt-5.2-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.aigcbar] name = "aigcbar" base_url = "https://api.aigc.bar/v1" wire_api = "responses" 

配置参数说明：

关键步骤：配置完成后，必须重启终端才能使配置生效！

1. 重启 CMD 或 PowerShell
2. 进入你的项目目录：

cd your-project-folder 

3. 启动 Codex：
   
   
   

codex 

---

• macOS 12（Monterey）或更高版本
• Node.js 22 或更高版本
• npm 10 或更高版本
• 管理员权限（安装时需要输入密码）

macOS 有两种安装方式：

方式一：官网下载安装（推荐新手）

1. 访问 Node.js 官网 下载 macOS 版本
2. 运行安装包，按提示完成安装

方式二：使用 Homebrew 安装（推荐开发者）

如果你已安装 Homebrew，可直接使用命令安装：

brew install node 

如果尚未安装 Homebrew，先执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 

打开终端（Terminal），执行以下命令：

sudo npm install -g @openai/codex 

注意：命令执行时可能要求输入开机密码，输入时不会显示任何字符，输入完成后按 Enter 确认即可。

codex --version 

重要提示：请将下方的 sk-xxx 替换为你在 API独立站 生成的实际 API 密钥！

4.5.1 创建配置目录

mkdir ~/.codex 

4.5.2 创建 auth.json

vi ~/.codex/auth.json 

按 i 进入编辑模式，粘贴以下内容：

{ "OPENAI_API_KEY": "sk-xxx" } 

粘贴后按 ESC 键，输入 :wq 后按 Enter 保存退出。

4.5.3 创建 config.toml

vi ~/.codex/config.toml 

按 i 进入编辑模式，粘贴以下内容：

model_provider = "aigcbar" model = "gpt-5-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.aigcbar] name = "aigcbar" base_url = "https://api.aigc.bar/v1" wire_api = "responses" 

粘贴后按 ESC 键，输入 :wq 后按 Enter 保存退出。

关键步骤：配置完成后，必须重启终端才能使配置生效！

1. 重启 Terminal
2. 进入项目目录：

cd your-project-folder 

3. 启动 Codex：

codex 

---

• Linux 发行版：Ubuntu 20.04+、Debian 10+、CentOS 7+、Fedora、Arch Linux 等
• Node.js 22 或更高版本
• npm 10 或更高版本
• sudo 权限

不同发行版的安装命令有所不同：

Ubuntu / Debian

# 更新包列表 sudo apt update # 安装 Node.js curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs 

CentOS / RHEL / Fedora

# 使用 dnf (Fedora) 或 yum (CentOS/RHEL) sudo dnf install nodejs npm # 或 sudo yum install nodejs npm 

Arch Linux

sudo pacman -S nodejs npm 

打开终端，执行：

npm install -g @openai/codex 

如果提示权限不足，使用 sudo：

sudo npm install -g @openai/codex 

codex --version 

重要提示：请将下方的 sk-xxx 替换为你在 API独立站 生成的实际 API 密钥！

5.5.1 创建配置目录

mkdir ~/.codex 

5.5.2 创建 auth.json

vi ~/.codex/auth.json 

按 i 进入编辑模式，粘贴：

{ "OPENAI_API_KEY": "sk-xxx" } 

按 ESC，输入 :wq，按 Enter 保存退出。

5.5.3 创建 config.toml

vi ~/.codex/config.toml 

按 i 进入编辑模式，粘贴：

model_provider = "aigcbar" model = "gpt-5-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.aigcbar] name = "aigcbar" base_url = "https://api.aigc.bar/v1" wire_api = "responses" 

按 ESC，输入 :wq，按 Enter 保存退出。

关键步骤：配置完成后，必须重启终端才能使配置生效！

1. 重启终端
2. 进入项目目录：

cd your-project-folder 

3. 启动 Codex：

codex 

---

无论使用哪个操作系统，启动 Codex 的标准流程都是：

# 1. 进入项目目录 cd your-project-folder # 2. 启动 codex codex 

启动成功后，你会看到 Codex 的交互式命令行界面，可以开始输入自然语言指令。

示例 1：代码生成

> 帮我写一个 Python 函数，实现快速排序算法 

Codex 会立即生成完整的快速排序实现代码，包括注释说明。

示例 2：代码分析

> 分析这段代码的性能瓶颈 

将代码文件拖拽到对话框，Codex 会分析代码并指出潜在的性能问题。

示例 3：Bug 修复

> 这段代码为什么报错，如何修复？ 

粘贴报错代码后，Codex 会分析错误原因并提供修复方案。

除了命令行工具，Codex 还提供了 VSCode 插件：

1. 在 VSCode 扩展商店搜索 “OpenAI Codex”
2. 点击安装
3. 安装完成后，Codex 会出现在侧边栏
4. 完成上述 API 配置后即可直接使用

---

---

Codex 提供了丰富的内置命令，通过输入 / 可以快速调用：

---

恭喜！通过本文的详细指导，你已经完成了 OpenAI Codex 在 Windows、macOS 或 Linux 系统上的完整安装配置。让我们回顾一下关键步骤：

1. 环境准备：确保 Node.js 22+ 和 npm 10+ 已安装
2. API 注册：在 API独立站 注册并创建专用令牌
3. 配置文件：正确创建 auth.json 和 config.toml
4. 重启终端：配置完成后务必重启终端使配置生效
5. 启动使用：进入项目目录，运行 codex 命令

• 文件上传：建议将代码文件拖拽到对话框，让 Codex 更好地理解项目上下文
• 清晰描述：提供详细、清晰的需求描述，能获得更高质量的代码
• 迭代优化：不满意的结果可以通过补充说明让 Codex 继续优化
• 版本控制：在重要项目上使用 Git，方便回溯 Codex 的修改

如需了解更多 Codex 的高级配置和使用技巧，可参考：

• Codex 官方文档
• OpenAI 开发者论坛

---

最后更新：2025年3月
适用版本：Codex CLI 最新版
作者声明：本文内容基于官方文档和社区实践整理，如有更新请以官方文档为准。

---

如果本文对你有帮助，欢迎点赞、收藏和分享！有任何问题欢迎在评论区留言讨论。