codex配置教程

概述：

安装nodejs（codex依赖nodejs运行）

安装codex

注册账号，创建API密钥

写入codex配置文件

终端启动

简单使用方式

VS Code插件

Windows 安装 codex

1. 安装nodejs

下载nodejs安装包并运行安装：
https://npmmirror.com/mirrors/node/v24.14.1/node-v24.14.1-x64.msi

安装完成后打开命令提示符（搜索命令提示符后单击打开），输入以下命令检验是否安装成功：

检验nodejs：（输出版本号即为安装成功）

检验npm（nodejs附带的包管理工具）：（输出版本号即为安装成功）

2. 安装codex

打开命令提示符，输入以下内容后回车，安装codex：

安装完成后输入以下命令检验是否安装成功：（输出版本号即为安装成功）

3. 注册小羊ai账号，创建API密钥

访问：https://www.sheepai.top/register?aff=5WHg

注册账号后进入控制台，进入API令牌页面，点击添加令牌

自己输入一个名字，分组优先级选择Codex专属，然后点击提交

找到刚刚创建的令牌，复制它的密钥，稍后会用到

4. 写入codex配置文件

进入当前用户的用户目录下的.codex文件夹，例如：C:\Users\testuser\.codex
如果没有.codex文件夹，请手动创建该文件夹，然后在其中创建config.toml以及auth.json两个文件。

将以下内容粘贴到auth.json并保存：（注意要将sk-xxx替换成刚刚复制的密钥）

{"OPENAI_API_KEY":"sk-xxx"}

将以下内容粘贴到config.toml并保存：

model_provider = "sheepai"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.sheepai]
name = "sheepai"
base_url = "https://www.sheepai.top/v1"
wire_api = "responses"

5. 终端启动

打开命令提示符，输入以下命令即可启动codex

Linux 安装 codex

1. 安装nodejs

打开Bash，依次输入以下命令安装nodejs：

安装完成后可以使用以下命令检验nodejs和npm是否安装成功：（输出版本号即为安装成功）

2. 安装codex

重新打开Bash，输入以下命令安装codex：

安装完成后输入以下命令检验是否安装成功：（输出版本号即为安装成功）

3. 注册小羊ai账号，创建API密钥

访问：https://www.sheepai.top/register?aff=5WHg

注册账号后进入控制台，进入API令牌页面，点击添加令牌

自己输入一个名字，分组优先级选择Codex专属，然后点击提交

找到刚刚创建的令牌，复制它的密钥，稍后会用到

4. 写入codex配置文件

进入当前用户的用户目录下的.codex文件夹，即：~/.codex
如果没有.codex文件夹，请手动创建该文件夹，然后在其中创建config.toml以及auth.json两个文件。

如何新建文件夹：

如何新建文件：

将以下内容粘贴到auth.json并保存：（注意要将sk-xxx替换成刚刚复制的密钥）

{"OPENAI_API_KEY": "sk-xxx"}

将以下内容粘贴到config.toml并保存：

model_provider = "sheepai"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.sheepai]
name = "sheepai"
base_url = "https://www.sheepai.top/v1"
wire_api = "responses"

5. 终端启动

重新打开Bash（一定要重新打开终端），输入以下命令即可启动codex

codex

Mac 安装 codex

1. 安装nodejs

打开终端，输入以下命令安装homebrew：

再输入以下命令安装nodejs：

安装完成后可以使用以下命令检验nodejs和npm是否安装成功：（输出版本号即为安装成功）

2. 安装codex

重新打开终端，输入以下命令安装codex：

安装完成后输入以下命令检验是否安装成功：（输出版本号即为安装成功）

3. 注册小羊ai账号，创建API密钥

访问：https://www.sheepai.top/register?aff=5WHg

注册账号后进入控制台，进入API令牌页面，点击添加令牌

自己输入一个名字，分组优先级选择Codex专属，然后点击提交

找到刚刚创建的令牌，复制它的密钥，稍后会用到

4. 写入codex配置文件

如何新建文件夹：

mkdir -p ~/.codex

如何新建文件：

touch ~/.codex/auth.json
touch ~/.codex/config.toml

将以下内容粘贴到auth.json并保存：（注意要将sk-xxx替换成刚刚复制的密钥）

{"OPENAI_API_KEY": "sk-xxx"}

将以下内容粘贴到config.toml并保存：

model_provider = "sheepai"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.sheepai]
name = "sheepai"
base_url = "https://www.sheepai.top/v1"
wire_api = "responses"

5. 终端启动

重新打开终端（一定要重新打开终端），输入以下命令即可启动codex

codex

6. 更好的体验：VS Code 插件

在VS Code的扩展商店，搜索codex，安装OpenAI官方的codex插件

然后就可以在侧边栏看到codex插件，点击后就可以开始使用了

简单使用方式

安装并配置完成后，推荐按下面的方式开始使用：

先进入你的项目目录

启动codex

直接用自然语言描述你的需求，例如：

帮我总结一下这个项目的目录结构

帮我阅读这个仓库，然后告诉我主程序从哪里启动

帮我修复当前项目里的编译报错

帮我在这个项目里新增一个登录页面

如果你希望codex只关注某个文件或某个问题，可以把需求说得更具体，例如：

请阅读 src/main.py，解释这个文件的作用

请检查 app.py 为什么会报错，并直接帮我修改

简单理解：你把codex当成一个可以直接对话的编程助手即可。你不用先学很多命令，直接说“帮我看代码”、“帮我改bug”、“帮我实现功能”就能开始使用。

codex配置教程

Windows 安装 codex#

1. 安装nodejs#

2. 安装codex#

3. 注册小羊ai账号，创建API密钥#

4. 写入codex配置文件#

5. 终端启动#

Linux 安装 codex#

1. 安装nodejs#

2. 安装codex#

3. 注册小羊ai账号，创建API密钥#

4. 写入codex配置文件#

5. 终端启动#

Mac 安装 codex#

1. 安装nodejs#

2. 安装codex#

3. 注册小羊ai账号，创建API密钥#

4. 写入codex配置文件#

5. 终端启动#

6. 更好的体验：VS Code 插件#

简单使用方式#

Windows 安装 codex

1. 安装nodejs

2. 安装codex

3. 注册小羊ai账号，创建API密钥

4. 写入codex配置文件

5. 终端启动

Linux 安装 codex

1. 安装nodejs

2. 安装codex

3. 注册小羊ai账号，创建API密钥

4. 写入codex配置文件

5. 终端启动

Mac 安装 codex

1. 安装nodejs

2. 安装codex

3. 注册小羊ai账号，创建API密钥

4. 写入codex配置文件

5. 终端启动

6. 更好的体验：VS Code 插件

简单使用方式