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）中执行以下命令：

npminstall-g@openai/codex

💡提示：如果使用 macOS 且已安装 Homebrew，也可通过以下命令安装：

brewinstallcodex

二、创建配置目录

macOS / Linux

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

rm-rf~/.codexmkdir~/.codex

Windows

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

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

三、获取 API 密钥

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

四、创建auth.json文件

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

{"OPENAI_API_KEY":"你的API_KEY"}

文件路径参考

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

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

五、创建config.toml文件

在.codex目录下创建config.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），运行以下命令查看版本信息，确认安装成功：

codex-V

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

七、开始使用

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

cdyour-project-folder codex

八、集成支持

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

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