Shell and Coding agent for Claude and Chatgpt
在Claude桌面应用程序上的Shell和编码代理程序
wcgw
是一个工具,赋予claude和chatgpt在本地机器上编码、构建和运行程序的能力。
⚠️ 警告
未审查命令前,请勿允许使用BashCommand工具,否则可能导致数据丢失。
🚀 主要功能
- 创建、执行和迭代代码,自动修复错误
- 大文件增量编辑,避免令牌限制
- 编辑时语法检查
- 交互式命令处理
- 文件保护机制
- 多种工作模式:架构师、代码写手和全能模式
- 终端多路复用支持
安装 - Claude设置 (使用MCP)
Mac和Linux
-
使用Homebrew安装
uv
:brew install uv
-
创建或更新Claude配置文件
~/Library/Application Support/Claude/claude_desktop_config.json
:{ "mcpServers": { "wcgw": { "command": "uv", "args": [ "tool", "run", "--from", "wcgw@latest", "--python", "3.12", "wcgw_mcp" ] } } }
-
重启Claude应用程序
Windows (WSL)
- 安装uv
- 更新Claude配置文件
%APPDATA%\Claude\claude_desktop_config.json
(与上方JSON内容相同)
常见用例
- 创建Python解决方案并自动测试修复
- 在仓库中查找代码
- 克隆并设置项目
- 创建和测试Web应用
- 编辑大型文件
- 创建功能分支和PR
- 修复编译错误
- 创建和运行测试用例
模式切换
architect
模式:用于规划,在编写代码前先制定计划code-writer
模式:专注于代码编辑和项目构建wcgw
模式:默认模式,无限制,完全授权
排错提示
- 如出现"uv ENOENT"错误,确保正确安装
uv
- 测试命令
uv tool run --from wcgw@latest --python 3.12 wcgw_mcp
- 尝试清理缓存:删除
~/.cache/uv
文件夹 - 使用测试版本
uv 0.6.0
完整文档请访问项目仓库:github.com/rusiaaman/wcgw