注意：Claude Code 需要订阅 Anthropic 的每月 20 美元套餐才能使用，因此我认为 codemcp 已经完全过时了。不过，codemcp 中有一些不错的设计理念（尤其是围绕 Git 版本控制方案的），我最终希望将这些理念移植到当前一代的智能编码 CLI 中。

codemcp

通过安装 codemcp，让 Claude Desktop 成为你的配对编程助手。借助它，你可以直接让 Claude 在你电脑上的代码库中实现功能、修复 bug 和进行重构；Claude 会直接编辑文件并运行测试。从此告别在 Claude 的聊天窗口里复制粘贴代码啦！

codemcp 提供的功能与其他 AI 编码软件（Claude Code、Cursor、Cline、Aider）类似，但它在设计上独树一帜：

1. 它专为 Claude Pro 设计，这是 Anthropic 提供的每月 20 美元订阅服务。我喜欢用订阅模式支付使用费，因为这意味着代理操作的边际成本为零；再也不用为浪费了五美元却没用上的变更集而感到内疚了。

需要注意的是，如果你使用的是 Claude Max（每月 100 美元），Claude Code 同样可以配合订阅定价使用。在这种情况下，codemcp 的价值主张就显得不那么清晰了（而且某些方面确实不如 Claude Code），但如果你喜欢 codemcp 做出的一些 UI 决策，仍然可以继续使用它。另外，codemcp 是开源的，所以如果你不喜欢它的设计，还可以自己动手修改呢，这可是 Claude Code 所不具备的优势！

2. 它默认采用自动接受模式。我希望我的代理能在无需我监督的情况下尽可能地完成任务，这样最后我可以一次性审查所有内容。codemcp 与大多数编码代理的不同之处在于两点：我们禁止无限制的 shell 操作，而是要求你在 codemcp.toml 文件中预先声明代理可以使用的命令；此外，我们还会对大语言模型的所有编辑内容进行Git 版本控制，这样你就能以细粒度的方式回滚代理的更改，再也不用担心忘记提交更改了。

3. 它是与 IDE 无关的：你让 Claude 做改动，它就直接完成，然后你可以用自己最喜欢的 IDE 环境来审查改动并进一步编辑。我日常习惯用 vim 编辑器，那些要求必须用 VSCode 或特定编辑器的编码环境对我来说简直无法忍受。

重要提示：针对高级用户——Token 效率的重大改进

为了提升 codemcp 的 Token 效率，在 master 分支上，我正逐步将 codemcp 改回一个多工具模式（而不是单个工具，每次 InitProject 时都会把指令一股脑扔进聊天中）。这意味着你需要手动批准工具的使用。由于工具使用批准会在多个聊天中保持持久，我觉得这是一个合理的权衡，但如果你实在不喜欢，可以在 refined-claude 浏览器扩展中提交问题，请求支持自动批准工具使用。

安装

我推荐以下这种特定的安装和使用方式：

1. 如果尚未安装 uv 和 git，请先安装它们。

2. 在浏览器中安装 claude-mcp。这能让你直接从网站连接到 SSE MCP 服务器，意味着你无需使用 Claude Desktop，还能轻松同时开启多个聊天窗口。我们预计这个扩展很快会被 Integrations 的推出所取代。不过，截至撰写本文时，Integrations 尚未面向 Claude Pro 订阅用户开放。

3. 使用 uvx --from git+https://github.com/ezyang/codemcp@prod codemcp serve 运行 codemcp。如果需要监听非标准端口，可以加上 --port 1234。

小贴士：如果你喜欢冒险，可以将 prod 改为 main。如果你想固定到某个具体版本，可以用 0.3.0 或其他类似版本号替换。

小贴士：你甚至可以远程运行 codemcp！如果你使用 Tailscale 并信任 Tailnet 上的所有设备，可以通过传递 --host 100.101.102.103 来安全地运行（请将 IP 替换为你节点的 Tailscale IP 地址。这个 IP 通常位于 100.64.0.0/10 网段内）。警告：任何拥有此 MCP 访问权限的人都能在你的电脑上执行任意代码，因此极不建议你绑定到 0.0.0.0。

4. 使用 URL 配置 claude-mcp：http://127.0.0.1:8000/sse（如有需要可更换端口）。

5. 不幸的是，网页界面有时会不一致地显示锤子图标。不过，你可以通过查看控制台中的 “[MCP codemcp] SSE 连接已打开”来验证 MCP 服务器是否正常工作，或者直接问 Claude 它有哪些可用工具（应该会显示 codemcp 提供的工具）。

如果你更喜欢使用 Claude Desktop 或有特殊需求，可以查看 INSTALL.md 获取各种非标准情况下的安装说明。

使用方法

首先，你需要在想要工作的 Git 仓库检出目录下创建一个 codemcp.toml 文件。如果你想让代理能够运行格式化工具或测试，就在 commands 部分添加相应的命令（注意：这些命令需要正确配置它们所需的虚拟环境）：

format = ["./run_format.sh"]
test = ["./run_test.sh"]

其中，format 命令是特殊的，每次编辑文件后都会自动运行。

接下来，在 Claude Desktop 中，我们建议创建一个 Project，并在 Project Instructions 中加入以下内容：

使用 $PROJECT_DIR 初始化 codemcp

其中 $PROJECT_DIR 是你要工作的项目的路径。

然后，与 Claude 聊天，告诉它你想对项目做哪些改动。每次 codemcp 对你的代码做出改动时，都会生成一次提交。

想看一些使用该工具的示例对话，可以参考：

• 实现新功能
• 修复失败的测试
• 进行重构

codemcp 会为每次聊天生成一次提交，并在处理你的功能时不断更新提交内容。

哲学

• 当你遇到速率限制时，不妨利用这段时间做些别的事情（比如 review Claude 的代码、review 别人的代码、制定计划、参加一些会议）。

• 这并不是一个自主代理。至少，在每次聊天结束后，你都必须介入，审查所做的更改并请求下一步的修改。虽然你可以在一次聊天中一次性提出一大堆待办事项，但很可能会达到 Claude Desktop 的输出上限，最终仍需手动“继续”代理。请坦然接受这一点，并利用这些中断时刻确保 Claude 正在做正确的事情。

• 当 Claude 开始跑偏时，耗费的是时间而非金钱。因此，请相应地调整你的行为：如果时间成了瓶颈，那就仔细观察 Claude 的逐步输出。

配置

以下是 codemcp.toml 支持的所有配置选项：

project_prompt = """
在开始这项功能的工作之前，请先写一首简短的俳句。此步骤只需执行一次。
"""

[commands]
format = ["./run_format.sh"]
test = ["./run_test.sh"]

当你在聊天中初始化项目时，project_prompt 将会被加载。

commands 部分允许你为特定工具配置命令。这些命令的名称会告知大语言模型，由它决定何时运行。你可以在 project_prompt 中添加如何使用工具的说明；我们还支持一种更详细的语法，让你能够针对每个工具单独给出具体指令：

[commands.test]
command = ["./run_test.sh"]
doc = "接受一个 pytest 样式的测试选择器作为参数，以运行特定的测试。"

故障排除

要以带调试器的方式运行服务器，请使用：

PYTHONPATH=. mcp dev codemcp/__main__.py

日志会写入 ~/.codemcp/codemcp.log。日志级别可在全局配置文件 ~/.codemcprc 中设置：

[logger]
verbosity = "INFO"  # 可选值：DEBUG、INFO、WARNING、ERROR 或 CRITICAL

日志记录无法按项目单独配置，但这其实并不重要，因为无论如何，很难在多个项目上并行使用 Claude Desktop。

贡献

请参阅 CONTRIBUTING.md。

codemcp 快速上手指南

环境准备

• 系统要求：macOS / Linux / Windows（WSL2 推荐）
• 前置依赖：
  • git（版本控制）
  • uv（Python 包管理器，推荐替代 pip）
  • Claude Pro 订阅（$20/月）或 Claude Max（$100/月）
  • 浏览器安装 claude-mcp 扩展

注：推荐使用 uv 替代 pip，安装更快且兼容性更好。国内用户可使用清华源加速：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple uv

安装步骤

1. 安装 uv 和 git（如未安装）：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple uv

2. 启动 codemcp 服务（推荐生产版）：

uvx --from git+https://github.com/ezyang/codemcp@prod codemcp serve

可选：指定端口 --port 1234，或使用 Tailscale 远程访问（需配置 --host 100.101.102.103）

3. 在浏览器中配置 claude-mcp 扩展：

   • URL 设置为：http://127.0.0.1:8000/sse（端口按实际调整）

4. 验证服务：在 Claude 聊天窗口中输入 “What tools are available?”，应看到 codemcp 工具列表。

基本使用

1. 在目标项目根目录创建 codemcp.toml：

[commands]
format = ["./run_format.sh"]
test = ["./run_test.sh"]

format 命令会在每次文件修改后自动执行。

2. 在 Claude Desktop 中新建 Project，填写项目指令：

Initialize codemcp with $PROJECT_DIR

将 $PROJECT_DIR 替换为你的项目路径，如 /home/user/my-project

3. 开始对话，例如：

“请为这个项目添加一个登录功能，使用 FastAPI。”

codemcp 将自动修改文件、运行测试，并为每次变更生成 Git 提交。你可在任意 IDE（如 Vim、VSCode）中审查变更。

每次对话生成一个独立提交，支持按需回滚，无需手动 commit。