01｜先统一 shell：安装 pwsh 7#

如果还在用系统自带的 Windows PowerShell 5.1，建议先换到 PowerShell 7（pwsh）。现代 Windows 开发环境最好统一到 pwsh 7，再谈 Codex、提示词和排错。

用 winget 安装：

1
winget install --id Microsoft.PowerShell --source winget

也可以从 PowerShell 官方安装页面 下载 MSI 手动安装。

安装后验证版本：

1
pwsh -v
2
# 期望类似：PowerShell 7.x

02｜装 Windows Terminal，并设默认配置为 pwsh 7#

原生 PowerShell 窗口体验一般；更关键的是，Windows Terminal 可以把 pwsh、Git Bash、SSH 等放在同一窗口管理，支持标签页、分屏和统一字体/编码。

一边让 Codex 在某个标签执行命令，一边看日志或跑服务，效率会高很多。

1
winget install --id Microsoft.WindowsTerminal --source winget

也可从 Windows Terminal Releases 手动安装。

装完后把 默认配置文件设为 PowerShell 7。后续所有提示词、命令和排错过程，都建立在同一个 shell 上，避免「有时 5.1、有时 7、有时又是 Bash」的混用。

03｜安装 ripgrep（rg）#

rg 是代码仓库里搜文本的利器：快、默认尊重 .gitignore，输出也比 PowerShell 原生搜索更适合直接交给 AI 阅读。

注意：rg 不是 Windows 原生命令，需要单独安装。

1
# winget
2
winget install BurntSushi.ripgrep.MSVC
3

4
# 或 Scoop
5
scoop install ripgrep

也可从 ripgrep Releases 下载 Windows 包。

安装后重新打开 Windows Terminal，否则当前会话可能还没刷新 PATH。确认：

1
rg --version

04｜关键：把 Windows / pwsh 约束写进 AGENTS.md#

终端统一只是第一步。真正影响体验的，是明确告诉 Codex：

当前项目用的是 PowerShell，不是 Bash。

大模型训练语料里 Linux / Bash 占比很高。你只说「执行一个命令」时，它很容易下意识写出 Bash 写法——命令在 Linux 上没错，放到 pwsh 里就会炸，或者结果不符合预期。

下面是楼主已经用了几个月的约束片段，可直接复制到：

C:/Users/<userName>/.codex/AGENTS.md

（系统版本可按本机修改，例如 Windows 10 / 11 / LTSC。）

1
## Windows约束
2
当前环境是 Windows 10 / pwsh7
3
- 默认禁止使用 Bash 语法，除非确定此shell处在 Linux 环境
4
- 不要使用 Bash 引号/转义习惯，在 PowerShell 命令里，复杂正则优先用单引号包裹。
5
- 如果正则本身同时包含单引号和双引号，优先拆成多个简单 rg 命令。
6
- 执行多行 Python 禁止使用 Bash heredoc；改用 PowerShell here-string | python -
7
- pwsh 中，语句块表达式（如 `foreach`、`if`）不能直接作为管道输入。 需要先使用 `$()` / `@()` 包裹，或先赋值给变量。 普通命令输出可直接进入管道，无需额外包裹。
8
- PowerShell 使用 `rg` 时，通配目录必须先用 `Get-ChildItem -Filter` 展开为真实路径，禁止直接把含 `*` 的搜索路径传给 `rg`。

这套提示词不是为了「限制」Codex，而是减少它在 shell 之间切换时的冲突。引号、管道、正则、多行脚本这几类一旦错了，让 AI 自己猜着改，往往最费时间。

05｜为什么这几条值得长期保留#

经验是：提示词不必写很长，但要把最容易出错、而且会反复出错的地方说清楚。规则稳定后，Codex 命令成功率会明显上升，「请改成 PowerShell」的来回也会少很多。

评论区也有共鸣：引号嵌套错多了还会「降智」；长任务里可以让 Codex 定期回顾 AGENTS.md，避免跑偏。

06｜最小落地清单#

按这个顺序做一遍即可：

1. 安装并验证 pwsh 7
2. 安装 Windows Terminal，默认配置改为 PowerShell 7
3. 安装 rg，新开终端验证 rg --version
4. 把「Windows约束」写入 ~/.codex/AGENTS.md（路径按用户名调整）
5. 开一个真实任务试跑：刻意观察是否还出现 grep/&&/heredoc 等 Bash 习惯

若仍偶发 Bash 写法，可在对话里再补一句：「当前 shell 是 pwsh7，禁止 Bash 语法，请按 AGENTS.md 执行。」

总结#

Codex 和 PowerShell 打架，核心往往不是 PowerShell「难用」，而是模型在猜你的 shell。

• 环境统一到 pwsh 7 + Windows Terminal + rg
• 用 AGENTS.md 写清禁止 Bash、引号、heredoc、管道与 rg 路径规则

把这两层钉死后，Windows 下用 Codex 开发会稳定一截。

来源：LINUX DO · PowerShell 和 Codex 在打架？可以试试这份提示词（knowckx）