Shell and Coding agent for Claude and Chatgpt
2025.02.18
1
PythonShell代理编码代理开发工具开发效率
wcgw是一个为Claude和ChatGPT设计的Shell和编码代理服务，旨在赋能聊天应用程序在本地机器上进行编码、构建和运行。它支持多种模式，包括架构师模式、代码编写模式和全功能模式，适用于各种开发场景。
View on GitHub
Overview
基本能力
产品定位
wcgw是一个为Claude和ChatGPT设计的Shell和编码代理服务，旨在赋能聊天应用程序在本地机器上进行编码、构建和运行。
核心功能
- 创建、执行、迭代：支持持续运行编译器检查直至所有错误修复完成。
- 大文件编辑：支持大文件增量编辑以避免令牌限制问题。
- 语法检查：在编辑时报告语法错误，以便LLM重新编辑。
- 交互式命令处理：支持使用箭头键、中断和ANSI转义序列的交互式命令。
- 文件保护：
- AI需要至少读取一次文件才能编辑或重写。
- 避免读取大文件时上下文填充，文件根据令牌长度分块。
- Shell优化：
- 一次只允许运行一个命令，简化管理并避免流氓进程。
- 当前工作目录始终在Shell命令后返回。
- 保存仓库上下文：使用"ContextSave"工具保存详细上下文到单个文件，支持任务恢复和知识转移。
- 多种模式：支持架构师模式、代码编写模式和全功能模式。
适用场景
- 使用Python解决问题，创建并运行测试用例并修复问题。
- 在仓库中查找具有特定行为的代码实例。
- 克隆仓库，理解项目，设置环境并构建。
- 创建Golang HTMX Tailwind Web应用并打开浏览器查看是否工作。
- 编辑或更新大文件。
- 在单独的分支中创建功能，然后使用GitHub CLI创建PR到原始分支。
工具列表
- Shell Operations:
Initialize,BashCommand - File Operations:
ReadFiles,WriteIfEmpty,FileEdit,ReadImage - Project Management:
ContextSave
常见问题解答
- 如果出现"uv ENOENT"错误，确保
uv已安装。 - 如果仍有问题，检查
uv tool run --from wcgw@latest --python 3.12 wcgw_mcp是否在终端中运行。 - 尝试删除~/.cache/uv文件夹。
- 尝试使用
uv版本0.6.0。
使用教程
使用依赖
首先安装uv：
brew install uv
安装教程
通过Smithery安装wcgw：
npx -y @smithery/cli install wcgw --client claude
更新claude_desktop_config.json：
{
"mcpServers": {
"wcgw": {
"command": "uv",
"args": [
"tool",
"run",
"--from",
"wcgw@latest",
"--python",
"3.12",
"wcgw_mcp"
]
}
}
}
调试方式
检查uv是否安装：
which uv
调试MCP服务器：
npx @modelcontextprotocol/[email protected] uv tool run --from wcgw@latest --python 3.12 wcgw_mcp