Codex国内如何使用?Codex镜像API国内最全使用教程:Windows/macOS/Linux官网级安装攻略(超详细)

type
status
date
slug
summary
tags
category
icon
password
网址
notion image
本篇教程为希望在国内使用 AI 编程神器 OpenAI Codex 的开发者提供了终极解决方案。我们为您准备了覆盖 Windows、macOS 和 Linux三大操作系统的完整图文安装与配置指南,通过使用国内 http://api.aigc.bar 站点,彻底解决了网络访问和API密钥获取难题。教程内容从环境准备、Node.js 安装,到详细的环境变量配置,再到启动使用、常用命令和高级技巧,手把手教您完成所有步骤,让您无需复杂操作即可免费、稳定地体验 OpenAI 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 站点选择与配置详细说明

前往API站点注册账号,获取 Auth Token

api.aigc.bar 为例子,访问 API站点:**api.aigc.bar** 注册账号后进行以下操作:
  1. 点击控制台 -> API令牌页面
notion image
2.点击"添加令牌"
notion image
3.令牌分组请选择:openai codex专用(务必选择此分组,否则无法使用)
notion image
4.令牌名称随意
5.额度建议:设置为无限额度
6.其他选项保持默认,点击提交
7.复制令牌密钥,进行下一步操作

🪟 Windows 版本教程

系统要求

  • Windows 10 或 Windows 11
  • Node.js 22+
  • npm 10+
  • 网络连接

前置步骤!!!

安装git bashGit - Downloads,点击这个链接,下载自己电脑系统对应的git bash,之后一直点下一步即可完成安装。

1. 安装 Node.js

访问 Node.js 官网 下载并安装最新 LTS 版本。

2. 安装 codex

打开命令提示符(CMD)或 PowerShell,运行:
notion image

3. 验证安装

打开命令提示符(CMD)或 PowerShell,运行:
notion image

4. 配置 API

重要提示:请将下方的 sk-xxx 替换为您在 http://api.aigc.bar 生成的实际 API 密钥!
  1. 进入当前用户的用户目录下的 .codex 文件夹中,例如:C:\Users\testuser\.codex(注意如果看不到隐藏目录说明你没有打开windows的显示隐藏项目)
notion image
2.如果没有 .codex 文件夹,那么需要手动创建文件夹,然后创建 config.toml 以及 auth.json 两个文件
notion image
notion image
3.填写配置(需要将sk-xxx替换成刚才在API站点创建的真实的sk)
notion image
auth.json中的配置:
notion image
config.toml中的配置(原封不动直接粘贴下面的即可),model_reasoning_effort 可选择的有high medium low,代表模型思考的努力程度,分别为(高、中、低):
notion image

5. 启动 codex

重启终端!,重启终端!,重启终端!
然后进入到工程目录:
然后,运行以下命令启动:
notion image

🍎 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 密钥!
  1. 创建目录:
  1. 创建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 密钥!
  1. 创建目录:
  1. 创建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

以上配置完成后直接安装即可。
notion image
安装完成后会出现在侧边栏。
notion image

❓ 常见问题

出现错误请按照如下步骤排查:
  1. 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 编程助手的强大功能!
notion image
💡 提示:建议将代码文件拖拽到对话框来上传,让 Codex 更好地理解您的项目。
更多codex配置及使用详情参考OpenAI官网 codex 官方教程
Loading...

没有找到文章