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 官方插件,安装插件后可直接在编辑器内使用,提升开发体验。


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

相关推荐
AI大模型-小华2 天前
Codex 自动测试怎么用?从生成测试用例到修复失败用例
git·测试用例·ai编程·软件开发·codex·chatgpt pro·codex cli
逐梦苍穹3 天前
不训练不微调:直接改权重矩阵,给小模型补上新能力
ai编程·codex·claudecode
夕阳_醉了9 天前
Codex 客户端从装好到跑通:第三方 API 接入与配置避坑指南
人工智能·gpt·openai·codex·ai 编程
段一凡-华北理工大学10 天前
工业智能体:从Codex/Claude到项目实战~系列文章06:一张蓝图看懂“工业智能体×高炉炼铁“
人工智能·claude·codex·工业智能体·高炉炼铁智能化·高炉智能体技术栈
小年糕是糕手12 天前
【AI】用 AI 做自己的个人网站(上):选模板、写提示词,做出第一版
人工智能·app·网页开发·codex·index·styles·0基础教程
段一凡-华北理工大学13 天前
工业智能体:从Codex/Claude到项目实战~系列文章05:从“AI助手“到“工业智能体“:能力跃迁与落地范式
人工智能·python·claude·codex·工业智能体·高炉炼铁智能化
孤狼GPT17 天前
ChatGPT、Codex数据库实战:MyBatis-Plus第一页查询正常,翻到第10000页为什么越来越慢?
mysql·chatgpt·mybatis-plus·codex·深分页
仙逆GPT19 天前
ChatGPT、Codex工程实战:Agent接入企业知识库,文档明明更新了,为什么回答还是旧版本?
chatgpt·codex·rag·企业知识库·ai agent
孤狼GPT19 天前
ChatGPT、Codex工程实战:Spring Boot的SSE一直在推送,为什么经过Nginx后前端才一次性显示?
spring boot·chatgpt·sse·codex·chatgptplus
孤狼GPT19 天前
ChatGPT、Codex性能实战:MySQL升级到8.0后,SQL没改,为什么接口P99反而翻倍?
spring boot·chatgpt·sql优化·codex·mysql8.0