codemcp 是一个编码助手 MCP（Model Context Protocol），用于将 Claude Desktop 变成结对编程助手。通过安装 codemcp，用户可以直接要求 Claude 在本地代码库上实现功能、修复 bug 和进行重构，Claude 会直接编辑文件并运行测试，从而避免在聊天窗口中复制粘贴代码。
用途
codemcp 旨在与 Claude Pro（Anthropic 的 20 美元/月订阅）配合使用，让用户以订阅方式支付使用费用，从而消除代理操作的边际成本。它与其他 AI 编码软件（如 Claude Code、Cursor、Cline、Aider）功能相似，但在设计上具有独特之处。
主要能力
- 自动接受编辑：默认情况下，codemcp 会自动接受 Claude 对代码的修改，让代理尽可能自主地推进工作，用户可以在最后一次性审查所有更改。
- 受限的 shell 命令：codemcp 禁止无限制的 shell 访问，要求用户在
codemcp.toml中预先声明代理可以使用的命令。 - Git 版本化编辑：所有 LLM 编辑都会通过 Git 进行版本控制，用户可以细粒度地回滚代理的更改，无需担心忘记提交。
- IDE 无关：用户可以使用自己偏好的 IDE 或编辑器（如 vim）来审查更改和进一步编辑，不强制使用 VSCode 或特定编辑器。
使用方式
- 安装 uv 和 git（如果尚未安装）。
- 在浏览器中安装 claude-mcp 扩展，以便直接从网站连接 SSE MCP 服务器，无需使用 Claude Desktop，并可轻松并行运行多个聊天窗口。
- 使用以下命令运行 codemcp：
可以添加uvx --from git+https://github.com/ezyang/codemcp@prod codemcp serve .--port 1234指定非标准端口。若想使用最新开发版，可将prod改为main；若想固定特定版本，可替换为0.3.0等。 还可以远程运行：如果使用 Tailscale 并信任 Tailnet 上的所有设备，可通过--host 100.101.102.103（替换为节点的 Tailscale IP）安全地远程运行。警告：任何能访问此 MCP 的人都可以在您的计算机上执行任意代码，极不建议绑定到0.0.0.0。 - 在 claude-mcp 中配置 URL：
http://127.0.0.1:8000/sse（根据需要替换端口）。 - 在要工作的 Git 仓库中创建
codemcp.toml文件，在commands部分添加代理可执行的命令（如格式化、运行测试）。format命令特殊，会在每次文件编辑后自动运行。 - 在 Claude Desktop 中创建项目，并在项目指令中加入相关配置（如
$PROJECT_DIR指向项目路径）。 - 与 Claude 聊天，要求对项目进行更改。每次 codemcp 修改代码都会生成一个提交，并在聊天过程中修订。
适用场景
- 希望以订阅方式使用 AI 编码助手，避免按量计费的用户。
- 偏好自动接受编辑、最后统一审查的工作流程。
- 使用非 VSCode 编辑器（如 vim）的用户。
- 需要细粒度回滚代理更改的场景。
限制
- 作者声明 claude code 的推出使 codemcp 基本过时，但部分设计思路仍有价值。
- 不是自主代理，至少需要在每次聊天后介入审查更改并请求下一步。
- 在单次聊天中请求过多任务可能触及 Claude Desktop 的输出限制，需要手动“继续”。
- 当 Claude 偏离轨道时，消耗的是时间而非金钱，需相应调整行为。
- 日志写入
~/.codemcp/codemcp.log，日志级别可在全局配置文件~/.codemcprc中设置，不支持按项目配置。 - 更多安装说明（包括非标准情况）可参考 INSTALL.md。
- 贡献指南见 CONTRIBUTING.md。
