Mac 版本教程

系统要求

• macOS 12 或更高版本
• Node.js 22+
• npm 10+
• 网络连接

安装步骤

1. 安装 Node.js

直接访问 Node.js 官网 (opens in a new tab) 下载并安装最新 LTS 版本。

或者使用 Homebrew（可选）安装Node.js：

brew install node

如果尚未安装 Homebrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 codex

打开终端，运行以下命令(可能要求输入开机密码，注意输入的时候不会显示内容，输入完成后按Enter键确认)：

sudo npm install -g @openai/codex

3. 验证安装

打开命令提示符(CMD)或 PowerShell，运行：

codex --version

配置 API

1. 获取 Auth Token

访问 YourAPI Token 页面 (opens in a new tab) 进行以下操作：

• 点击控制台 -> API令牌页面

• 点击 添加令牌

• 令牌分组请选择：openai codex专用（务必选择此分组，否则无法使用）

• 令牌名称随意

• 额度建议：设置为无限额度

• 其他选项保持默认

  

2. 配置环境变量

重要提示：请将下方的 sk-xxx 替换为您在 yourapi.cn 生成的实际 API 密钥！
重要提示：请将下方的 sk-xxx 替换为您在 yourapi.cn 生成的实际 API 密钥！
重要提示：请将下方的 sk-xxx 替换为您在 yourapi.cn 生成的实际 API 密钥！

1. 创建目录

   mkdir ~/.codex

2. 创建创建config.toml以及auth.json两个文件

   auth.json中的配置

   vi ~/.codex/auth.json

   填入下列值

   {
   "OPENAI_API_KEY": "sk-xxx"
   }

   粘贴后按一下键盘上的"ESC"案件，将输入法调成英文，输入:wq后按下Enter键保存并且退出。

   config.toml中的配置

   vi ~/.codex/config.toml

   粘贴以下值（原封不动直接粘贴下面的即可），model_reasoning_effort 可选择的有high medium low，代表模型思考的努力程度，分别为（高、中、低）

   model_provider = "yourapi"
   model = "gpt-5-codex"
   model_reasoning_effort = "high"
   disable_response_storage = true
   preferred_auth_method = "apikey"
   [model_providers.yourapi]
   name = "yourapi"
   base_url = "https://yourapi.cn/v1"
   wire_api = "responses"

   粘贴后按一下键盘上的"ESC"案件，将输入法调成英文，输入:wq后按下Enter键保存并且退出。

启动 codex

重启终端！，重启终端！，**重启终端！**然后进入到工程目录

cd your-project-folder

然后，运行以下命令启动：

codex

vscode插件 codex

以上配置完成后直接安装即可

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

常见问题

出现错误请按照如下步骤排查

1.key创建的是否正确，额度选择无限额度，不要限制模型，分组选择openai codex专用

2.实在解决不了可以联系QQ：2137994192

常见命令参考（按需使用）

内置斜杠命令

更多codex配置及使用详情参考claude官网 codex 官方教程 (opens in a new tab)