wcgw 本地编码终端
让 MCP 聊天客户端在本机执行命令、读写代码并共享交互式终端。
这个 Agent 能做什么，适合哪些场景？
wcgw 是一个面向 Claude 及其他 MCP 客户端的本地 MCP 服务器，提供紧密集成的 Shell 与代码编辑工具。客户端通过配置启动 wcgw 后，可在指定工作区初始化环境、执行命令、读取文件、创建空文件并对已有文件进行搜索替换式编辑。它可在可用时将命令运行在 screen 会话中，用户可用 VS Code 扩展或 screen -x 接入同一终端、查看输出、输入文本或中断进程。服务还提供 ContextSave，用单个文件保存任务描述与相关项目内容，以便后续恢复或交接。该项目明确提供不受过滤的本机 Shell 和文件访问，适合能承担本地执行风险并希望保留人工终端控制权的开发者。
调用 Initialize 重置 Shell、选择工作区并可加载初始文件或恢复 task_id；调用 BashCommand 执行命令，或通过 send_text、send_specials、send_ascii 向交互进程发送输入。ReadFiles 读取一个或多个文件，WriteIfEmpty 仅创建或写入空文件，FileEdit 用搜索/替换块修改既有文件，ReadImage 读取图片。初始化时会返回经过筛选的目录结构，并可加载项目或全局的 CLAUDE.md/AGENTS.md；大文件会按 token 长度分块。ContextSave 将描述、项目根目录和相关文件 glob 保存为可恢复或交接的任务上下文。
- 使用 Claude Desktop 的个人开发者，需要在本机仓库中让模型运行测试、编译并持续检查长时间命令状态。
- 需要保留人工介入能力的工程师，希望通过 VS Code 扩展或 screen -x 接入模型正在使用的终端并输入交互内容。
- 处理大型源码文件的维护者，希望模型先读取文件，再采用搜索替换块进行增量修改并获得语法错误反馈。
- 先进行代码库调查和方案设计的团队成员，可要求客户端使用 architect 模式执行只读命令。
- 需要跨聊天继续开发任务的用户，可用 ContextSave 保存相关文件与任务描述，再通过任务 ID 恢复。
这个 Agent 有哪些优点和局限？
- 提供 BashCommand 的交互式输入接口，支持方向键、中断和 ANSI 转义序列，而不只是一次性命令执行。
- 支持多个后台命令与主交互 Shell 并行运行，并在命令结果中返回当前工作目录以减少路径丢失。
- FileEdit 采用搜索替换块，包含多匹配校验、空格容忍匹配与接近匹配反馈；写入和编辑还会报告语法错误。
- 可通过 screen 和 VS Code 扩展让用户直接接入模型使用的终端，便于观察、协作和人工输入。
- ContextSave 可将任务描述与相关文件集中保存，用于任务检查点或知识交接。
- 项目明确警告：服务器向模型提供不受过滤的 Shell 与文件访问，模型幻觉或恶意提示都可能执行危险命令或造成非预期修改。
- Claude Desktop 的文档化配置依赖 uv 和 Python 3.12；Windows 路径仅支持 WSL。
- code-writer 模式中的允许命令列表目前只有提示约束，没有实际校验；文档标注为 WIP。
- GPT relay 支持已在 5 及以上版本移除；仓库没有为 ChatGPT 提供当前的配置流程。
- 共享终端依赖已安装的 screen；在该会话中运行新命令会中断后续的 LLM 命令。
如何安装或部署这个 Agent？
在 macOS 或 Linux 上先执行 brew install uv。随后在 ~/Library/Application Support/Claude/claude_desktop_config.json 的 mcpServers 中加入："wcgw": {"command":"uvx","args":["--python","3.12","wcgw@latest"]}，然后重启 Claude Desktop。Windows 仅支持 WSL：安装 uv，并在 %APPDATA%\Claude\claude_desktop_config.json 中将 command 设为 wsl.exe，args 设为 ["uvx","--python","3.12","wcgw@latest"]。文档未要求 API 密钥或其他凭据。
如何使用这个 Agent？
重启 Claude Desktop 并等待 MCP 图标出现后，向 Claude 请求执行命令、读取文件、编辑文件或运行代码。需要限定 Shell 时，可在 uvx 参数末尾添加 --shell 和例如 /bin/bash。可要求使用 architect、code-writer 或默认的 wcgw 模式；如需接入运行中的终端，先用 screen -ls 查找 wcgw 会话，再执行 screen -x <session-name>。Docker 部署可先执行 docker build -t wcgw https://github.com/rusiaaman/wcgw.git，再把 Docker run 配置为 MCP server command。
这个 Agent 与同类方案有什么区别？
文档称其搜索替换编辑方式借鉴 Aider，且 architect 模式受 Aider 的 architect mode 启发；仓库未给出功能或性能的系统性对比。