Windows Codex 使用说明

在 Windows 系统上安装官方 Codex CLI，并配置为使用积木AI代码助手。

返回 下载脚本 登录后创建 Codex Key
开始前先做这一步：先到 Key 管理 创建 Codex Key。文档里所有 你的Codex_API_KEY 都必须替换成你自己的真实 Key，否则无法使用。

先选一种方式

如果你是不熟悉命令行的用户，优先用“脚本安装”；只有脚本安装失败，或你想逐步检查每一步时，再看下面的完整说明。
下载脚本 完整说明 
powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -useb https://code.jimuxyz.com/env_deploy/codex-install.ps1 | iex"
powershell -NoProfile -ExecutionPolicy Bypass -Command "npm install -g @openai/codex --registry=https://registry.npmmirror.com"
powershell -NoProfile -ExecutionPolicy Bypass -Command "$env:JIMUXYZ_CODEX_KEY='你的Codex_API_KEY'; iwr -useb https://code.jimuxyz.com/env_deploy/codex-deploy.ps1 | iex"

系统要求

系统
Windows 10（版本 1809 / build 17763）及以上
依赖
Node.js 22 LTS + npm（Windows 原生优先用 22 LTS，不建议先用 24/25 再排障）
Node.js 安装（如果没有安装）
前往 nodejs.org/zh-cn/download 下载。
Git 安装（可选）
前往 git-scm.com/downloads/win 下载，保持默认一路下一步（不要改路径）。如访问不稳定，可用清华镜像 mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/，选择 Git for Windows 下载。

安装步骤（Windows 终端）

1

环境检查（推荐）

powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -useb https://code.jimuxyz.com/env_deploy/codex-install.ps1 | iex"

可在 PowerShell / CMD / Windows Terminal / VSCode 终端执行；脚本会检查 Node.js / npm 版本，并提示修复方式。

2

卸载已安装的 Codex（可选，未安装请跳过）

powershell -NoProfile -ExecutionPolicy Bypass -Command "npm uninstall -g @openai/codex"
3

安装 Codex 官方原版包

powershell -NoProfile -ExecutionPolicy Bypass -Command "npm install -g @openai/codex --registry=https://registry.npmmirror.com"
4

验证安装

codex -V
npm list -g @openai/codex --depth=0

先执行 codex -V；如果没有正常显示版本，再用 npm list -g @openai/codex --depth=0 确认官方包是否已安装。

若 PowerShell 提示“无法加载 codex.ps1，因为在此系统上禁止运行脚本”，请先执行：Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，然后关闭当前终端，重新打开 PowerShell / Windows Terminal 再试。

5

可选：重建 .codex 配置目录（旧配置异常时再执行）

powershell -NoProfile -ExecutionPolicy Bypass -Command "Remove-Item -Recurse -Force ([IO.Path]::Combine([Environment]::GetFolderPath('UserProfile'), '.codex')) -ErrorAction SilentlyContinue; New-Item -ItemType Directory -Path ([IO.Path]::Combine([Environment]::GetFolderPath('UserProfile'), '.codex')) | Out-Null"

首次安装通常不用先删目录；只有之前装过 Codex、怀疑旧配置冲突时再执行这一条。

6

登录后创建并复制 Codex Key

登录后到「Key 管理」页面创建一个新的 Codex Key，并复制你自己的 你的Codex_API_KEY 对应真实值。

7

一键写入配置（脚本写入配置）

powershell -NoProfile -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('JIMUXYZ_CODEX_KEY','你的Codex_API_KEY','Process'); iwr -useb https://code.jimuxyz.com/env_deploy/codex-deploy.ps1 | iex"

脚本会自动写入 .codex\\auth.json 与 .codex\\config.toml，并备份旧文件。

如果你之前在本机用过其他 Key / 其他服务商，改完配置后建议这样理解：codex = 按当前新配置新建会话；codex resume = 继续旧会话；codex fork --last = 继承最近一次会话内容，但按当前新配置开一个新会话。想把旧历史接到新的积木AI配置继续使用时，优先用 codex fork --last。

若 PowerShell 提示“无法加载 *.ps1，因为在此系统上禁止运行脚本”，请先执行：Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，然后重新打开终端再试。

或者

如果你不想用脚本，就按下方两个小步骤手动新建 auth.json 和 config.toml 文件。

8

手动配置（auth.json + config.toml）提示：将 你的Codex_API_KEY 改为你在「Key 管理」页面创建的真实 Codex Key。

先打开资源管理器，进入 C:\Users\你的用户名\。如果没有 .codex 文件夹，就手动新建一个名为 .codex 的文件夹。然后在这个文件夹里分别新建 auth.json 和 config.toml 两个文件。

  • 步骤 1：用记事本或 VS Code 打开 auth.json，粘贴下面内容后保存
{
  "OPENAI_API_KEY": "你的Codex_API_KEY"
}
  • 步骤 2：再打开 config.toml，粘贴下面内容后保存
model_provider = "codex"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.codex]
name = "codex"
base_url = "https://code.jimuxyz.com/p/v1"
wire_api = "responses"
requires_openai_auth = true

这里保留 model_provider = "codex"，目的是尽量兼容你本机已有的 Codex CLI 历史会话；真正决定走积木AI的是 base_url = "https://code.jimuxyz.com/p/v1"。默认模型为 gpt-5.4，也可按需改成 gpt-5.3-codex。

保存完成后，重新打开一个新的终端，再执行 codex 或 codex fork --last。

9

启动 Codex / 续接历史

# 导航到你的项目（可选）
cd your-project

# 1) 全新按当前配置启动
codex

# 2) 只恢复旧会话
codex resume --last

# 3) 继承旧历史，但按当前新配置继续
codex fork --last

首次切到积木AI后，先用 codex 验证新配置；如果想把旧历史一起带过来继续用，优先执行 codex fork --last。