Codex 安装与配置指南

Codex 安装与配置指南

Codex 是一款强大的 AI 编程助手，支持在 macOS 和 Windows 系统上快速部署。本文将分别介绍两种操作系统下的安装步骤、配置文件创建及验证方法。

AICodeMirror官方地址：https://www.aicodemirror.com

输入邀请码：注册就是8￥：https://www.aicodemirror.com/register?invitecode=1Z7S80

系统要求

macOS / Linux：macOS 10.15 或更高版本 / 主流 Linux 发行版
Windows：Windows 10（版本 1809 / 内部版本 17763）或更高版本

一、安装 Codex 官方原版包

在终端（Windows 下为命令提示符或 PowerShell）中执行以下命令：

bash 复制代码

npm install -g @openai/codex

💡 提示：如果使用 macOS 且已安装 Homebrew，也可通过以下命令安装：
bash 复制代码
brew install codex

二、创建配置目录

macOS / Linux

删除已有配置目录（若存在），并新建：

bash 复制代码

rm -rf ~/.codex
mkdir ~/.codex

Windows

删除已有配置目录（若存在），并新建。路径中的 你的用户 请替换为实际用户名：

bash 复制代码

rmdir /s /q C:\users\你的用户\.codex
mkdir C:\users\你的用户\.codex

三、获取 API 密钥

访问 OpenAI 仪表板的 「API 密钥」 页面，创建一个新的 API 密钥并复制保存。

四、创建 `auth.json` 文件

在 .codex 目录下创建 auth.json 文件，内容如下（将 你的API_KEY 替换为实际密钥）：

json 复制代码

{
  "OPENAI_API_KEY": "你的API_KEY"
}

文件路径参考

macOS / Linux ：~/.codex/auth.json
Windows ：C:\users\你的用户\.codex\auth.json

⚠️ 若该文件已存在，请先删除再新建。

五、创建 `config.toml` 文件

在 .codex 目录下创建 config.toml 文件，内容如下（直接复制粘贴）：

toml 复制代码

model_provider = "aicodemirror"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.aicodemirror]
name = "aicodemirror"
base_url = "https://api.aicodemirror.com/api/codex/backend-api/codex"
wire_api = "responses"

文件路径参考

macOS / Linux ：~/.codex/config.toml
Windows ：C:\users\你的用户\.codex\config.toml

⚠️ 若该文件已存在，请先删除再新建。

六、验证安装

重启终端（Windows 下需重启命令提示符或 PowerShell），运行以下命令查看版本信息，确认安装成功：

bash 复制代码

codex -V

若正常输出版本号，则安装与配置完成。

七、开始使用

在任意项目目录中启动 Codex：

bash 复制代码

cd your-project-folder
codex

八、集成支持

Codex 完全支持 VSCode 官方插件，安装插件后可直接在编辑器内使用，提升开发体验。

如果在配置过程中遇到问题，可参考官方技术支持文档或联系技术支持团队获取帮助。

Codex 安装与配置指南