用于 Claude 和其他 MCP 客户端的 Shell 及编码代理

赋能聊天应用，使其能够在本地机器上进行编码、构建和运行。

wcgw 是一个集成了 Shell 和代码编辑工具的 MCP（Model Context Protocol）服务器。

⚠️ 警告：该 MCP 服务器允许对您的机器 Shell 和文件进行不受限制的访问。它不会限制 LLM 执行任意命令或进行意外更改。如果 AI 产生幻觉，此工具可能会被攻击者滥用或运行危险命令。仅在您完全理解并接受运行无限制 AI 代理的相关风险后，才运行此存储库。

截至 2026 年，使用 wcgw 的原因是它提供了完全交互式的 Shell 体验，您和 AI 代理都可以对其进行控制（包括发送按键）。 结合 wcgw VS Code 扩展插件，将代理的 Shell 直接连接到您的编辑器中，您可以获得目前市面上最佳的代理式 Shell 体验。 文件编辑技巧和整体的极简主义设计也有助于提升代理的工作效率。

演示

更新日志

• [2025年10月6日] 模型现在可以在后台运行多个命令。ZSH 现已成为受支持的 Shell。改进了多路复用能力。

• [2025年4月27日] 移除了对通过中继服务器（relay server）使用 GPT 的支持。版本 >= 5 仅支持 MCP 服务器。

• [2025年3月24日] 改进了针对 sonnet 3.7 的编写和编辑体验，CLAUDE.md 会被自动加载。

• [2025年2月16日] 您现在可以连接到 AI 正在使用的工作终端。请参阅下方的“连接到终端 (attach-to-terminal)”章节。

• [2025年1月15日] 引入了多种模式：架构师模式（architect）、代码编写模式（code-writer）以及全能模式（wcgw mode）。

• [2025年1月8日] 引入上下文保存工具，用于将相关文件路径及其描述保存到单个文件中。可作为任务检查点或用于知识转移。

• [2024年12月29日] 文件写入和编辑的语法检查现已稳定。initialize 工具调用功能增强：若引用了任何仓库，会将智能整理后的仓库结构发送给 Claude。大型文件处理能力也得到了提升。

• [2024年12月9日] 用于在 Claude 应用中粘贴上下文的 VS Code 扩展

🚀 特性亮点

• ⚡ 创建、执行、迭代：要求 Claude 不断运行编译器检查，直到所有错误修复完毕；或要求它监控长时间运行命令的状态，直到任务完成。
• ⚡ 大文件编辑：支持大文件的增量编辑，以避免 Token 限制问题。能够根据改动百分比智能选择是进行小范围编辑还是整体重写。
• ⚡ 编辑语法检查：如果编辑存在语法错误，会向 LLM 反馈报告，以便其进行修正。
• ⚡ 交互式命令处理：支持使用方向键、中断信号和 ANSI 转义序列进行交互式命令操作。
• ⚡ 文件保护机制：
  • AI 在编辑或重写文件之前，必须至少读取过一次该文件。这避免了意外覆盖。
  • 读取超大文件时会自动分块，避免上下文被占满。
  • 初始化时，在筛选出重要文件后（基于 .gitignore 和统计方法），会返回工作区的目录结构。
  • 基于“搜索-替换”的文件编辑方式：如果存在多个匹配项，会尝试根据之前的搜索块定位正确的匹配区域，否则会报错以确保准确性。
  • 文件编辑支持空格容错匹配，并会在出现缩进不匹配等问题时发出警告。如果没有匹配项，会将最接近的匹配结果返回给 AI 以修正其错误。
  • 使用类似于 Aider 的搜索与替换，比基于工具调用的搜索与替换性能更高。
• ⚡ Shell 优化：
  • 每次执行 Shell 命令后都会返回当前工作目录，防止 AI“迷路”。
  • 命令轮询在短暂超时后会退出，避免反馈延迟。同时，状态检查具备基于命令输出流的等待容忍度。结合这两种方法，提供了良好的 Shell 交互体验。
  • 支持在主交互式 Shell 之外同时运行多个后台命令。
• ⚡ 将仓库上下文保存到单个文件：使用 "ContextSave" 工具进行任务检查点记录，将详细上下文保存到一个文件中。后续可以在新的聊天中通过要求“恢复 任务 ID”来继续任务。保存的文件可用于后续处理。