忍者Token Codex Windows 安装说明

← 返回首页

Codex Windows 安装说明

这个说明是给使用 Windows 的同学看的。

下载 codex-config-windows.zip — 内含 install-codex-config-windows.bat 与 CODEX_SETUP_README_WINDOWS.md，解压后即可使用。

你会拿到一个文件（或从压缩包中解压得到）：

  • install-codex-config-windows.bat

可选阅读同目录下的 CODEX_SETUP_README_WINDOWS.md（与网页版说明一致）。

它的作用很简单：

  • 自动创建 %USERPROFILE%\.codex 文件夹（一般在 C:\Users\你的用户名\.codex）
  • 自动生成 auth.json
  • 自动生成 config.toml
  • 如果你原来已经有同名文件，会先帮你备份，再覆盖

怎么运行

第 1 步：把文件放到电脑里

比如放到「下载」文件夹或桌面。

第 2 步：打开命令行

任选一种方式：

方式 A：命令提示符（cmd）

  1. 按 Win + R
  2. 输入 cmd
  3. 回车

方式 B：PowerShell

  1. 在开始菜单搜索 PowerShell
  2. 打开「Windows PowerShell」

也可以直接双击 install-codex-config-windows.bat 运行（会弹出一个黑色窗口）。

第 3 步：执行命令

如果脚本在「下载」目录，在 cmd 里可以这样（把 你的用户名 换成实际用户名）：

"%USERPROFILE%\Downloads\install-codex-config-windows.bat"

如果文件在桌面：

"%USERPROFILE%\Desktop\install-codex-config-windows.bat"

如果文件不在上述位置，就把路径改成你保存脚本的真实路径。

也可以先 cd 到脚本所在文件夹，再输入文件名：

cd /d D:\某个文件夹
install-codex-config-windows.bat

第 4 步：输入你的 Key

执行后，窗口会提示：

请输入你的 OpenAI API Key:

把你的 key 粘贴进去，然后按回车。

注意：

  • 在 Windows 默认的 cmd 里用 set /p 输入时，你输入的内容通常会显示在屏幕上（和 Mac 终端里「完全不显示」不一样）。若介意被旁人看到，请尽量在私密环境操作，或改用更安全的输入方式（自行保管 key）。
  • 若粘贴后没反应，可先右键窗口标题栏 → 属性，确认已勾选「快速编辑模式」等便于粘贴的选项；或改用「以管理员运行」再试（一般不需要）。

第 5 步：完成

如果成功，你会看到类似提示：

Codex 配置已写入 C:\Users\你的用户名\.codex
auth.json -> C:\Users\你的用户名\.codex\auth.json
config.toml -> C:\Users\你的用户名\.codex\config.toml

说明已经装好了。

常见问题

1. 提示找不到文件或路径

意思就是文件路径写错了，或脚本根本不在那个目录。

请检查：

  • 脚本是否已下载完整、文件名是否一致（含 .bat 后缀）
  • 路径里若有空格，建议整条路径加英文双引号，例如："D:\我的文件\install-codex-config-windows.bat"

2. 双击后一闪就关了

多半是执行完就自动退出了。可以改用 cmd 手动运行，这样窗口会保留，方便看提示和报错：

cmd /k ""%USERPROFILE%\Downloads\install-codex-config-windows.bat""

（把路径换成你的脚本路径。）

3. 原来有配置会不会丢

不会直接丢。

脚本会先备份旧文件，名字大概像这样：

  • auth.json.bak.20260331-112233
  • config.toml.bak.20260331-112233

4. 杀毒软件或 SmartScreen 拦截

个别环境会提示「未知发布者」。若你确认脚本来源可信，可选择「仍要运行」或把文件加入白名单后再执行。

一句话版本

对方只需要做两件事：

  1. 打开 cmd（或双击 bat）
  2. 运行 install-codex-config-windows.bat，然后输入自己的 key