Codex国内如何使用?Codex镜像API国内最全使用教程:Windows/macOS/Linux官网级安装攻略(超详细)
type
status
date
slug
summary
tags
category
icon
password
网址

本篇教程为希望在国内使用 AI 编程神器 OpenAI Codex 的开发者提供了终极解决方案。我们为您准备了覆盖 Windows、macOS 和 Linux三大操作系统的完整图文安装与配置指南,通过使用国内 http://api.aigc.bar 站点,彻底解决了网络访问和API密钥获取难题。教程内容从环境准备、Node.js 安装,到详细的环境变量配置,再到启动使用、常用命令和高级技巧,手把手教您完成所有步骤,让您无需复杂操作即可免费、稳定地体验 OpenAI Codex 强大的代码生成、分析和自动化能力,助您大幅提升开发效率。
本文目录
本文目录📋 什么是 Codex使用示例实际开发体验对比主要功能支持平台📋 通用要求🔑 Codex API 站点选择与配置详细说明前往API站点注册账号,获取 Auth Token🪟 Windows 版本教程系统要求前置步骤!!!1. 安装 Node.js2. 安装 codex3. 验证安装4. 配置 API5. 启动 codex🍎 Mac 版本教程系统要求1. 安装 Node.js2. 安装 codex3. 验证安装4. 配置 API5. 启动 codex🐧 Linux 版本教程系统要求1. 安装 Node.js2. 安装 codex3. 验证安装4. 配置 API5. 启动 codex🚀 启动和使用基本启动实战使用示例🔌 VSCode插件 codex❓ 常见问题📝 常见命令参考(按需使用)内置斜杠命令💡 小结
📋 什么是 Codex
codex 是 OpenAI 官方推出的命令行工具,为开发者提供强大的 AI 辅助编程体验。
使用示例
启动 codex:
实际开发体验对比
传统开发方式:
- 🕐 研究文档: 30分钟
- 🕑 编写后端API: 45分钟
- 🕒 开发前端组件: 60分钟
- 🕓 调试集成: 30分钟
- 总耗时: 2.5小时
使用 codex:
- ⚡ 描述需求: 30秒
- ⚡ 获得完整代码: 3秒
- ⚡ 复制粘贴测试: 2分钟
- 总耗时: 3分钟
主要功能
- 🚀 智能代码生成 - 快速生成高质量代码
- 🔍 代码分析 - 深度理解和分析代码结构
- 🛠️ 调试助手 - 智能发现和修复代码问题
- 📚 文档生成 - 自动生成代码文档
- ⚡ 命令行集成 - 无缝集成到开发流程
支持平台
codex 支持多个主流操作系统:
- Windows - 支持 Windows 10/11
- macOS - 支持 macOS 12+
- Linux - 支持主流 Linux 发行版
📋 通用要求
- Node.js 22+ (所有系统必需)
- npm 10+
- 网络连接 (访问 API站点)
- 终端/命令行工具
- 国内Codex API站点:http://api.aigc.bar
🔑 Codex API 站点选择与配置详细说明
前往API站点注册账号,获取 Auth Token
- 点击控制台 -> API令牌页面

2.点击"添加令牌"

3.令牌分组请选择:openai codex专用(务必选择此分组,否则无法使用)

4.令牌名称随意
5.额度建议:设置为无限额度
6.其他选项保持默认,点击提交
7.复制令牌密钥,进行下一步操作
🪟 Windows 版本教程
系统要求
- Windows 10 或 Windows 11
- Node.js 22+
- npm 10+
- 网络连接
前置步骤!!!
安装git bash,Git - Downloads,点击这个链接,下载自己电脑系统对应的git bash,之后一直点下一步即可完成安装。
1. 安装 Node.js
访问 Node.js 官网 下载并安装最新 LTS 版本。
2. 安装 codex
打开命令提示符(CMD)或 PowerShell,运行:

3. 验证安装
打开命令提示符(CMD)或 PowerShell,运行:

4. 配置 API
重要提示:请将下方的 sk-xxx 替换为您在 http://api.aigc.bar 生成的实际 API 密钥!
- 进入当前用户的用户目录下的
.codex
文件夹中,例如:C:\Users\testuser\.codex
(注意如果看不到隐藏目录说明你没有打开windows的显示隐藏项目)

2.如果没有
.codex
文件夹,那么需要手动创建文件夹,然后创建 config.toml
以及 auth.json
两个文件

3.填写配置(需要将sk-xxx替换成刚才在API站点创建的真实的sk)

auth.json中的配置:

config.toml中的配置(原封不动直接粘贴下面的即可),
model_reasoning_effort
可选择的有high medium low,代表模型思考的努力程度,分别为(高、中、低):
5. 启动 codex
重启终端!,重启终端!,重启终端!
然后进入到工程目录:
然后,运行以下命令启动:

🍎 Mac 版本教程
系统要求
- macOS 12 或更高版本
- Node.js 22+
- npm 10+
- 网络连接
1. 安装 Node.js
直接访问 Node.js 官网 下载并安装最新 LTS 版本。
或者使用 Homebrew(可选)安装Node.js:
如果尚未安装 Homebrew:
2. 安装 codex
打开终端,运行以下命令(可能要求输入开机密码,注意输入的时候不会显示内容,输入完成后按Enter键确认):
3. 验证安装
打开终端,运行:
4. 配置 API
重要提示:请将下方的 sk-xxx 替换为您在 http://api.aigc.bar 生成的实际 API 密钥!
- 创建目录:
- 创建config.toml以及auth.json两个文件
auth.json中的配置:
填入下列值:
粘贴后按一下键盘上的"ESC"案件,将输入法调成英文,输入
:wq
后按下Enter键保存并且退出。config.toml中的配置:
粘贴以下值(原封不动直接粘贴下面的即可),
model_reasoning_effort
可选择的有high medium low,代表模型思考的努力程度,分别为(高、中、低):粘贴后按一下键盘上的"ESC"案件,将输入法调成英文,输入
:wq
后按下Enter键保存并且退出。5. 启动 codex
重启终端!,重启终端!,重启终端!
然后进入到工程目录:
然后,运行以下命令启动:
🐧 Linux 版本教程
系统要求
- Linux 发行版 (Ubuntu 20.04+ , Debian 10+)
- Node.js 22+
- npm 10+
- 网络连接
1. 安装 Node.js
Ubuntu/Debian:
CentOS/RHEL/Fedora:
Arch Linux:
2. 安装 codex
打开终端,运行以下命令(可能要求输入开机密码,注意输入的时候不会显示内容,输入完成后按Enter键确认):
3. 验证安装
打开终端,运行:
4. 配置 API
重要提示:请将下方的 sk-xxx 替换为您在 http://api.aigc.bar 生成的实际 API 密钥!
- 创建目录:
- 创建config.toml以及auth.json两个文件
auth.json中的配置:
填入下列值:
粘贴后按一下键盘上的"ESC"案件,将输入法调成英文,输入
:wq
后按下Enter键保存并且退出。config.toml中的配置:
输入以下值(原封不动直接粘贴下面的即可),
model_reasoning_effort
可选择的有high medium low,代表模型思考的努力程度,分别为(高、中、低):粘贴后按一下键盘上的"ESC"案件,将输入法调成英文,输入
:wq
后按下Enter键保存并且退出。5. 启动 codex
重启终端!,重启终端!,重启终端!
然后进入到工程目录:
然后,运行以下命令启动:
🚀 启动和使用
基本启动
实战使用示例
代码生成:
代码分析:
Bug修复:
🔌 VSCode插件 codex
以上配置完成后直接安装即可。

安装完成后会出现在侧边栏。

❓ 常见问题
出现错误请按照如下步骤排查:
- key创建的是否正确,额度选择无限额度,不要限制模型,分组选择openai codex专用
📝 常见命令参考(按需使用)
内置斜杠命令
命令 | 描述 |
/mode | 切换审批模式(Suggest/Auto Edit/Full Auto) |
/model | 切换 AI 模型和推理级别 |
/approvals | 切换批准模式(Read Only/Auto/Full Access) |
/init | 创建 AGENTS.md 文件,为 Codex 提供项目指令 |
/status | 显示当前会话配置和令牌使用情况 |
/diff | 显示 Git 差异(包括未跟踪文件) |
/clear | 清除会话历史 |
/prompts | 显示示例提示 |
/help | 显示帮助信息 |
💡 小结
🎉 恭喜! 您已完成 OpenAI Codex 的完整安装配置。现在可以在任何操作系统上享受 AI 编程助手的强大功能!

💡 提示:建议将代码文件拖拽到对话框来上传,让 Codex 更好地理解您的项目。
更多codex配置及使用详情参考OpenAI官网 codex 官方教程
Loading...