codex使用说明

一、安装 Codex

使用 npm 快速安装 Codex，获得 AI 驱动的编码辅助工具。

1、前置要求

Node.js 环境要求

最低版本：Node.js 18.0 或更高版本

推荐版本：最新的 LTS 版本（获得最佳性能和稳定性）

2、安装步骤

步骤 1：安装 Node.js

从 Node.js 官方网站下载并安装适合您操作系统的版本：
下载地址：https://nodejs.org/

验证安装：
bash

#检查 Node.js 版本
node --version
#检查 npm 版本
npm --version

步骤 2：安装 Codex

执行安装命令：
bash

npm i -g @openai/codex --registry=https://registry.npmmirror.com

验证安装：
bash

codex --version

步骤 3：配置Codex

在MacOS/Linux/WSL下配置Codex和windows(powershell) 下稍有不同，下面区分给出。

进入codex配置脚本下载页面，下载对应的配置脚本:
https://cc.585dg.com/download?product=codex

MacOS/Linux/WSL 下配置codex

选择其中适合MacOS/Linux/WSL 版本的配置脚本，然后在命令行中运行

bash config_codex.sh

然后输入您购买的秘钥。

根据您使用的.bashrc或者.zshrc 进行source即可。

Windows(powershell) 下配置codex

选择其中适合Windows版本的配置脚本，然后双击运行：

输入您购买的秘钥;

输入密钥之后会在下方生成install_codex.ps1文件

用记事本编辑这个文档，把里面地址改为https://xh.v1api.cc/v1

3、修改配置

找到 .codex 文件的位置。
编辑 auth.json 修改为自己api，没问题就不改

再找到config.toml,将url改为https://xh.v1api.cc/v1

4、直接使用

完成上述配置后，重新打开一个命令行在其中输入codex 即可开始使用codex cli（codex 与claude codex 共用积分):

Enjoy it!

5、版本升级

如果您已经安装了 Codex，执行以下命令升级到最新版本：
bash

npm install -g

💡 提示：升级会自动覆盖旧版本，您的配置文件会被保留

6、故障排除

（1）. 权限错误

macOS/Linux 系统：
bash

sudo npm install -g

Windows 系统：以管理员身份运行命令提示符

（2）. 找不到 codex 命令

重启终端窗口

检查 npm 全局路径：
bash

npm config get prefix

确保该路径已添加到系统 PATH 环境变量

（3）. 网络连接问题

检查防火墙设置

如需配置代理：
bash

npm config set proxy http://proxy.example.com:8080

尝试使用国内镜像源

（4）. 版本冲突

卸载旧版本：
bash

npm uninstall -g codex

清理 npm 缓存：
bash

npm cache clean --force

重新执行安装命令

7、快速开始

安装成功后，您可以执行以下操作：

codex init - 初始化项目配置

codex help - 查看所有可用命令

codex version - 查看当前版本信息

二、Vscode codex 插件配置

需要在vs中连接使用的，一定需要先在终端中设置好并且测试没有问题后再连接vs!!

1、先下载官方的 codex 插件，切记官方的 codex 插件，只有带 openai 认证的才是！！如图所示：

2、安装完了之后，它会出现在你vscode 的左侧边栏，如图所示：

此时，你可以尝试对话，如果不行，可以点击 vscode 的个人中心里面的设置，搜索@ext:openai.chatgpt，如图所示：

点击在settings.json 中编辑，在 json 最下面加上以下内容：

保存之后重启 vscode，即可开始重新使用。

Cursor codex插件配置

需要在cursor中连接使用的，一定需要先在终端中设置好并且测试没有问题后再连接cursor!!

先下载官方的 codex 插件，切记官方的 codex 插件，只有带 openai 认证的才是！！如图所示：

然后打开左上角的File（文件）点击perferences（首选项）点击VScode settings（设置）然后搜索settings

点击在settings.json 中编辑，在 json 最下面加上以下内容：

保存之后重启 cursor，即可开始重新使用

最后、常见问题

1、codex链接超时提示

遇到下面的提示，这种一般是超过记忆长度了，新建聊天试试

stream error: stream disconnected before completion: Transport error: error decoding response body; retrying 1/5 in 197ms… 这个提示，

2、codex插件一直转圈

是 openai 自己的 bug。

目前解决方案，在转圈的时候点击右上角的 “历史记录” 图标（在开启新会话图标的右边）

codex使用说明

codex使用说明#

一、安装 Codex#

1、前置要求#

2、安装步骤#

在MacOS/Linux/WSL下配置Codex和windows(powershell) 下稍有不同， 下面区分给出。#

MacOS/Linux/WSL 下配置codex#

3、修改配置#

4、直接使用#

5、版本升级#

6、故障排除#

7、快速开始#

二、Vscode codex 插件配置#

需要在vs中连接使用的，一定需要先在终端中设置好并且测试没有问题后再连接vs!!#

需要在cursor中连接使用的，一定需要先在终端中设置好并且测试没有问题后再连接cursor!!#

最后、常见问题#

1、codex链接超时提示#

2、codex插件一直转圈#

codex使用说明

一、安装 Codex

1、前置要求

2、安装步骤

在MacOS/Linux/WSL下配置Codex和windows(powershell) 下稍有不同，下面区分给出。

MacOS/Linux/WSL 下配置codex

3、修改配置

4、直接使用

5、版本升级

6、故障排除

7、快速开始

二、Vscode codex 插件配置

需要在vs中连接使用的，一定需要先在终端中设置好并且测试没有问题后再连接vs!!

需要在cursor中连接使用的，一定需要先在终端中设置好并且测试没有问题后再连接cursor!!

最后、常见问题

1、codex链接超时提示

2、codex插件一直转圈