PowerShell与Codex冲突？这份提示词帮你解决

背景

在 Windows 下使用 AI 编程助手（如 Codex）进行开发时，开发者常遇到一个典型问题：PowerShell 和 Codex 之间频繁“打架”。Codex 在训练数据中大量接触 Linux 和 Bash 环境，因此自动生成的命令往往带有 Bash 语法习惯（如 grep、sed、cat、&&），但这些命令在 PowerShell 中无法直接运行，或行为与预期不符。作者在半年 Windows 开发实践中，逐步摸索出一套方案，通过统一终端环境和编写针对性提示词，有效解决了这一冲突，并将经验分享出来。

核心内容

作者的核心方案分为两部：先统一终端环境，再用提示词约束 Codex 的命令习惯。

第一步：统一终端环境

1. 安装 PowerShell 7（pwsh）
   建议放弃系统自带的 Windows PowerShell 5.1，改用现代 shell：PowerShell 7。可通过 winget 安装
   winget install --id Microsoft.PowerShell --source winget
   或从 PowerShell 官方页面下载 MSI 安装包。安装后验证版本：pwsh -v 应显示 PowerShell 7.x。

2. 安装 Windows Terminal
   用于管理多个终端（pwsh、Git Bash、SSH 等）的统一窗口，支持标签页、分屏、统一字体和编码。可通过 winget 安装
   winget install --id Microsoft.WindowsTerminal --source winget
   或从 GitHub Releases 下载安装包。安装后，将默认配置文件设为 PowerShell 7，确保每次打开终端即进入 pwsh 环境。

3. 安装 ripgrep（rg）
   ripgrep 是适合在代码仓库中搜索文本的命令行工具，速度极快，默认遵守 .gitignore，输出格式适合 AI 阅读。通过 winget 安装
   winget install BurntSushi.ripgrep.MSVC
   或使用 Scoop、手动下载。安装后重启终端，用 rg --version 验证。

第二步：添加提示词约束

将以下提示词写入 C:/Users/<用户名>/.codex/AGENTS.md（或相应位置），明确告知 Codex 当前环境为 Windows 10 / pwsh7：

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

每条约束背后的原因：

• 明确 shell：让 Codex 从一开始就知道命令要交给 pwsh，避免默认生成 Bash 命令。
• 约束引号和转义：PowerShell 的字符串、正则和变量展开规则不同，提前规定写法，减少转义错误。
• 替代 heredoc：Windows 下没有 Bash heredoc，PowerShell here-string 才是稳定的多行文本方案。
• 处理语句块管道：foreach、if 等语句块不能直接作为普通管道输入，提前写入规则后，Codex 不会反复生成错误写法。
• 处理 rg 通配路径：先展开真实目录再搜索，比把 * 直接交给命令更符合 PowerShell 和 Windows 的路径行为。

关键要点

• 将终端环境统一为 pwsh 7 + Windows Terminal，消除 shell 版本差异带来的混乱。
• 安装 ripgrep 作为代码搜索工具，其输出更适合 AI 阅读，且能避免原生 PowerShell 搜索的兼容问题。
• 提示词必须明确声明 “当前环境是 Windows / pwsh7”，从根源上防止 Codex 误用 Bash 语法。
• 对 引号、转义、heredoc、管道、通配符 等高频冲突点进行逐条约束，减少反复纠错成本。
• 提示词不宜过长，但要把 最容易出错且反复出错 的地方说清楚，规则稳定后 Codex 执行命令成功率显著提升。
• 建议将提示词保存在 AGENTS.md 文件中，作为持久化配置，无需每次对话重复输入。

意义与影响

该方案为 Windows 开发者提供了一套可复用的方法，将 AI 编程助手（如 Codex）与本地环境之间的摩擦降到最低。通过统一环境并编写针对性提示词，开发者不再需要手动纠正 AI 生成的 Bash 命令，也无需在每次出错后重新解释 PowerShell 的语法差异。这套约束不仅适用于 Codex，也适用于任何基于大模型的代码生成工具（如 GPT-4、Claude 等）。它提醒我们：AI 工具的能力边界取决于我们如何明确地定义上下文。将环境配置和语法规则提前写进提示词，是一种高效且低成本的“人机协作”策略，能显著提升 Windows 下的开发流畅度。