Windows 中文目录导致 Codex App 用不了？这样解决

如果你的 Windows 用户目录是中文，安装完 Codex 后打不开或报错，这篇文章就是为你准备的。

我会用最简单的方式，带你一步一步把环境搭好，让 Codex 在中文目录下也能正常使用。整个过程不需要复杂的原理，只需要按顺序操作即可。

先说清楚：Codex 是什么，适合谁

Codex 是 OpenAI 推出的 AI 编程助手。它不只是聊天窗口，而是可以“进入”你的项目文件夹，帮你看代码、改功能、分析报错、写文档。

这篇文章适合：

  • 电脑操作不太熟悉的新手
  • 第一次接触 AI 编程工具的人
  • 在 Windows 上安装 Codex 时遇到目录问题的用户
  • 想从“只聊天”升级到“让 AI 进项目干活”的人

注意：本文只讲 Windows 下的安装与使用。Mac 和 Linux 的流程有所不同，后续可以单独说明。
Codex 的可用性会受账号、网络、地区政策影响，本文以官方安装流程和本地使用为主。
不要下载来历不明的“破解版”或“国内整合包”，它们可能带来源码泄露或账号风险。

你需要准备什么

在开始之前，先准备好以下工具。它们的作用我会在后面解释，你只需知道“先装上，后面自然会用到”。

  1. Node.js：运行环境，Codex 的命令行工具依赖它
  2. npm：Node.js 自带的包管理工具，用来安装 Codex
  3. Git：代码版本管理工具，建议在修改前先备份
  4. VS Code：代码编辑器，不是必须的，但后续调试会更方便
  5. Codex：真正要用的 AI 助手

你不需要一开始就理解每一个细节，只要按步骤装好就行。

第一步：安装 Node.js

最简单的方式是安装 Node.js 的 LTS 版本（稳定版）。

下载与安装

  1. 打开 Node.js 官网
  2. 找到 LTS 版本，下载 Windows Installer x64
  3. 双击下载的 .msi 文件开始安装
  4. 安装过程中：

    • 遇到权限提示点“是”
    • 一直点“Next”，不要修改安装路径
    • 确保勾选了 npm package manager 和 Add to PATH
  5. 等待安装完成

检查是否安装成功

按 Win + R，输入 cmd 回车，打开命令行窗口。

输入以下命令：

node -v
npm -v

如果能看到版本号（例如 v20.x.x 和 10.x.x），说明 Node.js 和 npm 已经可用。

第二步：可选 — 用 nvm 管理 Node.js（进阶）

如果你以后会切换不同项目的 Node 版本，可以用 nvm。但新手第一次安装 Codex 时可以跳过这一步。

如果你愿意尝试：

  1. 下载 nvm-windows 的 .exe 安装包
  2. 安装时保持默认路径，不要放到中文目录
  3. 常用命令：
nvm version                # 检查 nvm 是否装好
nvm list available         # 查看可安装的 Node 版本
nvm install 22.22.2        # 安装指定版本
nvm list                   # 查看已安装版本
nvm use 22.22.2            # 切换到指定版本

注意：如果你已经装好了 Node.js，先不用管 nvm，目标是跑通 Codex。

第三步：安装 Git

Git 用来保存代码修改记录，防止 Codex 改错后无法恢复。

下载与安装

  1. 打开 Git 官网
  2. 下载 Git for Windows x64
  3. 双击安装包，按以下步骤操作：

    • 安装路径保持默认（通常是 C:\Program Files\Git）
    • 组件选择保持默认
    • 默认编辑器：如果装了 VS Code，可以选择它；否则保持默认
    • PATH 选项选择：Git from the command line and also from 3rd-party software
    • 后面的选项全部保持默认
  4. 点击“Install”完成安装

检查是否安装成功

在命令行输入：

git --version

如果看到类似 git version 2.x.x，说明 Git 可用。

配置用户名和邮箱（非登录，只是记录）

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
git config --global --list

这一步只是让 Git 在存档时知道是谁在操作，不涉及账号登录。

第四步：安装 VS Code

VS Code 不是必须的，但后续查看项目、改代码会更方便。

下载与安装

  1. 打开 VS Code 官网
  2. Windows 用户下载 Windows User Installer x64
  3. 安装时建议勾选：

    • Add to PATH（添加到环境变量）
    • 通过 Code 打开（右键菜单）
    • 注册为支持文件类型的编辑器

安装完成后，可以在开始菜单或桌面找到 Visual Studio Code。

第五步：安装 Codex

Codex 有三种使用方式，下面分别说明。

方式一：Codex App（适合不想用命令行的用户）

如果你更习惯图形界面，可以先试 Codex App。

  1. 打开官方入口
  2. Windows 用户会跳转到 Microsoft Store 下载
  3. 安装完成后打开，登录 ChatGPT 账号
  4. 选择一个项目文件夹，即可开始使用

注意：如果你的用户目录是中文，Codex App 可能会报错。这种情况请使用方式二或方式三。

方式二：Codex CLI（命令行，适合所有目录）

如果你愿意用命令行，Codex CLI 是最稳定的方式，且不受用户目录是否为中文的影响。

  1. 打开 PowerShell
  2. 输入以下命令安装：
npm i -g @openai/codex
  1. 等待安装完成，不要关闭窗口
  2. 检查是否安装成功：
codex --version
  1. 第一次运行：
codex

它会提示你登录 ChatGPT 账号或使用 API Key。新手建议按提示登录账号。

方式三：VS Code 插件（图形界面，适合不想用终端的用户）

如果你不想用命令行，也可以在 VS Code 里直接使用 Codex。

  1. 打开 VS Code
  2. 进入扩展商店（左侧边栏的方块图标）
  3. 搜索 “Codex”
  4. 认准 OpenAI 官方发布的插件，不要装名字类似但来源不明的第三方插件
  5. 安装后登录即可使用

第六步：第一次让 Codex 看见你的项目

很多新手装好了 Codex，却不知道怎么让它“看到项目”。其实很简单：

你要先进入项目文件夹，再运行 Codex。

操作步骤

假设你的项目文件夹叫 demo，在桌面上。

  1. 打开这个文件夹
  2. 在文件夹顶部的地址栏输入 cmd，然后回车

    • 这样会直接在该文件夹里打开命令行
  3. 输入：
codex

Codex 就会在当前项目目录里启动。

第一次使用的建议

不要一上来就让它改代码。建议先问：

请先分析这个项目的目录结构，告诉我这个项目是做什么的，以及应该如何启动。先不要修改代码。

加上“先不要修改代码”这句话，可以避免误操作。

第七步：让 Codex 改代码前，先备份

Codex 能改代码，这是它的优势，也是新手最容易出问题的地方。

最坏的情况是：它改了一堆东西，你不知道怎么恢复。

所以在动手前，先保存当前状态。

方法一：用 Git 备份（推荐）

如果项目已经是 Git 仓库：

git status
git add .
git commit -m "before codex changes"

方法二：手动复制（适合不会 Git 的用户）

直接把整个项目文件夹复制一份，作为备份。

建议：先备份，再修改。这样出问题也不慌。
你也可以直接对 Codex 说：“先给我做一个 git 提交。”

常见问题与解决方法

1. npm 或 node 不是内部或外部命令

原因：Node.js 没装好，或者安装后没重新打开命令行。

解决步骤：

  1. 关闭 PowerShell / CMD
  2. 重新打开
  3. 输入 node -v 和 npm -v 检查
  4. 还不行就重启电脑
  5. 再不行就重新安装 Node.js，安装时保持默认选项

2. codex 不是内部或外部命令

原因：全局安装后路径未刷新。

解决方法：

  1. 重新执行一次：
npm i -g @openai/codex
  1. 关闭 PowerShell，重新打开
  2. 输入 codex --version 检查

3. 下载很慢怎么办

  • 优先换一个更稳定的网络环境
  • 多刷新几次，不要频繁中断
  • Node.js、Git、VS Code、Codex 都建议从官网下载，不要用第三方打包版

4. 登录 Codex 失败怎么办

检查以下几点：

  • ChatGPT 账号是否能正常登录
  • 账号是否有 Codex 权限
  • 当前网络是否能访问相关服务
  • 浏览器是否拦截了登录跳转
  • 安装的是不是 OpenAI 官方 Codex

5. 完全不会代码，可以用 Codex 吗

可以，但不要一上来就让它大改项目。

更适合新手的第一句话是：

请像教新手一样，解释这个项目是做什么的，每个文件夹分别有什么作用。先不要修改代码。

等你对项目有概念了，再让它改小功能。

给小白的安装顺序（建议按这个来）

如果你是第一次安装，按这个顺序操作最稳妥：

  1. 安装 Node.js LTS
  2. 用 node -v 和 npm -v 检查
  3. 安装 Git
  4. 用 git --version 检查
  5. 安装 VS Code
  6. 打开 PowerShell
  7. 运行 npm i -g @openai/codex
  8. 用 codex --version 检查
  9. 进入项目文件夹
  10. 运行 codex
  11. 登录账号
  12. 先让 Codex 分析项目，不要立刻改代码

最后提醒

在中国地区使用 Codex，最容易卡住的往往不是 Codex 本身，而是前面的基础环境：Node.js、Git、npm、VS Code。

小白不用急，按顺序来。每装完一个，就用命令检查一下有没有成功。

记住两句话：

  • 不要乱下第三方整合包。
  • 不要让 Codex 在没有备份的项目里直接大改代码。

按这个流程走一遍，你的 Windows 中文目录问题可以解决，Codex 也能正常使用。