要在windows终端让codex cli真正干活,必须打通环境、权限、配置、路径四关:确认node.js≥v22.0.0、npm≥v10.0.0、git已安装;全局安装@openai/codex后重启终端;在%userprofile%.codex下创建auth.json和config.toml并正确配置;cd至项目目录后运行codex --ask发起交互。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Windows终端里让Codex CLI真正干活——读项目、改代码、执行命令、追问验证,不能只装完就完事,必须打通环境、权限、配置、路径四关,缺一不可。
确认Node.js和Git已就位
打开PowerShell(右键开始菜单→“Windows Terminal(管理员)”),逐行执行:
node -v → 必须输出 【v22.0.0 或更高】,低于此版本安装会静默失败,不报错但后续所有命令无效。
npm -v → 必须输出 v10.0.0 或更高。
git --version → 必须有输出,Codex在Windows下依赖Git Bash解析路径和沙箱权限,没Git会直接卡死在启动阶段,报错类似“spawn git ENOENT”。
安装Codex CLI并刷新环境
执行安装命令:
npm install -g @openai/codex
安装完成后必须关闭当前所有PowerShell窗口,重新打开一个全新终端——旧窗口的PATH不会自动更新,此时运行 codex --version 一定提示“command not found”。
新终端中输入 codex --version,看到类似 codex 0.131.0 的输出,说明CLI已可调用。
创建并填写核心配置文件
在文件资源管理器地址栏输入:【C:\Users\%USERNAME%\ .codex】(注意 .codex 前有一个英文点号,是隐藏文件夹),按回车。
如果提示“找不到该路径”,先点击顶部“查看”→勾选“隐藏的项目”,再手动新建名为 .codex 的文件夹。
进入该文件夹,新建两个纯文本文件,分别命名为:auth.json 和 config.toml。
用记事本或VS Code打开 auth.json,写入(仅且必须是这一行):
{"OPENAI_API_KEY": "sk-你的实际密钥"}
config.toml 内容需严格匹配你使用的模型服务商,例如用 wolfai.top 中转:
model_provider = "wolfai"
model = "gpt-5-codex"
model_reasoning_effort = "high"
[model_providers.wolfai]
base_url = "https://wolfai.top/v1"
进入项目并启动Codex交互会话
第一步:在PowerShell中用 cd 命令切换到你的代码目录,例如:
cd C:\dev\my-web-app
第二步:执行启动命令:
codex --ask "帮我把 src/utils/date.js 里的 formatISO 函数改成支持中文星期显示"
第三步:Codex会自动加载当前目录结构,分析文件,生成修改建议,并在终端内展示 diff 预览。按 y 确认应用修改,按 n 拒绝,按 Ctrl+C 退出。











