Shell and Coding agent for Claude and Chatgpt
2025.04.02
415
PythonShell 交互代码编辑项目构建任务检查点开发效率
wcgw 是一个为 Claude 和 ChatGPT 设计的 Shell 和 Coding 代理服务，旨在赋能聊天应用程序在本地机器上进行编码、构建和运行。它提供了紧密集成的 Shell 和代码编辑工具，支持通过中继服务器与 Shell 进行交互。该服务特别强调安全性，警告用户不要未经审查就允许 BashCommand 工具执行命令，以避免数据丢失。
View on GitHub
Overview
基本能力
产品定位
wcgw 是一个为 AI 聊天应用（如 Claude 和 ChatGPT）提供本地 Shell 和代码编辑能力的代理服务，旨在通过 AI 辅助开发者进行代码编写、项目构建和问题解决。
核心功能
- Shell 交互：支持执行 Shell 命令，包括交互式命令处理（如箭头键、中断和 ANSI 转义序列）。
- 文件操作：支持文件的读取、编辑（包括大文件增量编辑）和写入，带有语法检查和文件保护机制。
- 项目上下文保存：通过
ContextSave工具保存项目上下文，便于任务检查点或知识转移。 - 多模式运行：提供
architect（规划模式）、code-writer（代码编写模式）和wcgw（全能模式）三种运行模式。 - 终端复用：支持通过
screen命令附加到 AI 使用的终端，便于调试和交互。
适用场景
- 代码问题解决：如修复代码错误、运行测试用例。
- 项目构建：克隆、设置和构建项目。
- 大文件编辑：安全地编辑大文件，避免令牌限制问题。
- 任务检查点：保存任务状态以便后续恢复或知识转移。
工具列表
- Shell Operations：
Initialize：重置 Shell 并设置工作区环境。BashCommand：执行 Shell 命令，支持超时控制和交互式输入。- File Operations：
ReadFiles：读取文件内容。WriteIfEmpty：创建或写入空文件。FileEdit：通过搜索/替换块编辑文件。ReadImage：读取图像文件。- Project Management：
ContextSave：保存项目上下文和文件，用于知识转移或任务检查点。
常见问题解答
- 安装问题：如
uv未找到，需确保uv已安装并位于全局路径。 - 运行问题：如命令未执行，可尝试调试 MCP 服务器或检查
uv版本。
使用教程
使用依赖
- Mac 和 Linux：通过 Homebrew 安装
uv：bash brew install uv - Windows (WSL)：安装
uv并配置 WSL。
安装教程
- 配置 Claude：更新
claude_desktop_config.json文件以包含wcgw的 MCP 服务器配置。 - 重启 Claude：应用配置更改后重启 Claude 应用。
调试方式
- 调试 MCP 服务器：
bash npx @modelcontextprotocol/[email protected] uv tool run --from wcgw@latest --python 3.12 wcgw_mcp - 附加到终端：使用
screen -x附加到 AI 使用的终端会话。