参考2026 最新 Codex CLI 国内安装与使用全攻略（Windows / Mac / Linux） - 知乎

codex安装

系统要求

Windows 10 或 Windows 11

Node.js 22+

npm 10+

网络连接

安装 Git Bash，请访问 Git - Downloads下载对应您电脑系统的版本，之后一直点击“下一步”即可完成安装。

1. 安装 Node.js

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

---

2. 安装 codex

打开命令提示符（CMD）或 PowerShell，运行：

npm install -g @openai/codex

---

3. 验证安装

打开命令提示符（CMD）或 PowerShell，运行：

codex --version

如果这里能正常输出版本号，说明 Codex CLI 已经安装成功。

之前没有输出版本号，原因是这个机器没有安装c++环境，安装了VC_redist.x64

配置 API(其他api中转也可以)

1. 获取 Auth Token

访问 LetAiCode 站点页面进行以下操作：

点击 接口密钥 页面

点击 创建新密钥

密钥类型选择：codex （务必选择此分组，否则无法使用）

令牌名称随意

这一步很关键，很多人不是 Key 不对，而是分组选错了。

---

2. 配置文件

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

进入当前用户的用户目录下的 .codex 文件夹中，例如：

C:\Users\testuser\.codex

注意：如果看不到该目录，说明您没有打开 Windows 的“显示隐藏的项目”，请先在文件资源管理器中开启。

如果没有 .codex 文件夹，请手动创建该文件夹，然后在其中创建 config.toml 以及 auth.json 两个文件。

---

填写配置

需要将 sk-xxx 替换成您自己创建的真实 SK。

a. auth.json 中的配置

注意，如果文件里有其他内容，直接覆盖原有的哈：

{"OPENAI_API_KEY":"sk-xxx"}

---

b. config.toml 中的配置

直接复制下面的内容。 注意，如果文件里有其他内容，直接覆盖原有的哈：

model_provider = "api111"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://letaicode.cn/codex"
wire_api = "responses"

这里补充说明一下：

model_reasoning_effort 可选值为 high、medium、low，分别代表模型思考的努力程度（高、中、低）。

其中，model = "gpt-5.3-codex" 这一行，你可以指定具体的模型。 如果你想用最新的 gpt-5.4，也可以改成：

model = "gpt-5.4"

启动 codex

重启终端！重启终端！重启终端！

然后进入到您的工程目录：

cd your-project-folder

运行以下命令启动：

codex

当时没启动终端，其实他是报错了，但是vscode，codex插件没有展示，一直报错，401,重连，没令牌报错啥都有

VSCode 插件版 Codex

在前面的配置完成后，打开 VSCode，进入扩展商店，搜索并安装 codex 插件即可。

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

总结：配置插件的时候，需要了解整体链路的步骤，并且每一步都需要验证。