被AI编程工具的”上下文溢出”折磨过？Plandex想让你真正”看清”改了什么

做过大项目的都知道：Claude Code 跑个小功能很爽，但让你一口气生成 30 个文件、改完整套 API 的时候，它就开始”失忆”了——上下文塞不下，或者改着改着就跑偏。

Plandex 解决的就是这个问题。

它是什么

Plandex（15.6k ⭐，1.2k Fork，GitHub 地址）是 Go 语言写的终端 AI 编程 Agent，核心理念就一句：在真正的复杂项目上跑得起来。

对比主流工具，它的几个数字值得关注：

• 2M token 有效上下文：默认模型包就能做到，每步只加载当前任务需要的文件，不会一次性把整个仓库塞进去
• 单文件上限 ~100k token：配合 tree-sitter 项目图（支持 30+ 语言），可以索引 20M token 规模的项目
• 沙盒 diff 机制：AI 的改动先存在隔离区，等你 review 通过再合并——不是”AI 写完直接落地”

这让它特别适合：接手遗留代码库做重构、批量迁移 API、写一整个新模块、清理历史债务这类”做一次要改很多文件”的任务。

怎么跑起来

一行安装：

curl -sL https://plandex.ai/install.sh | bash

进项目目录，直接敲 plandex（或简写 pdx）就能进入 REPL 模式。

cd your-project-dir
pdx

服务端支持本地 Docker 自部署，或者用自己的 OpenRouter API Key 连接各种模型提供方（包括 Claude、GPT 系列、Gemini、开源模型）。有 Claude Pro/Max 订阅的话，首次运行会提示直连订阅。

它的”自动驾驶”是什么段位

Plandex 最大的特点是把控制权交给你：提供了一个从全手动到全自动的连续光谱。

• 纯手动模式：你一步一点指挥，AI 只负责生成当前文件的修改
• 分步自动：AI 自己规划 + 执行 + 给你看结果，你点头再继续
• 全自主动：让它自己跑，跑完回来检查

调试能力也在线：能自动跑构建命令、linters、测试脚本，如果装了 Chrome 还能自动 debug 浏览器应用。

每个 plan 的每次更新都有版本记录，还可以开分支对比不同方案、不同模型生成的结果。

项目边界：适合谁、不适合谁

适合：

• 需要一次改 10+ 文件的中大型重构或新功能
• 接手不熟悉的代码库，想先”对话”了解结构
• 想在一个工具里组合使用多个模型（比如对比 Claude 和 GPT-4 的实现）
• token 成本敏感的用户（Plandex 在 OpenAI/Anthropic/Google 模型上都做了一层上下文缓存，省钱）

不太适合：

• 轻度使用：只是想问个简单编程问题，Cursor / Claude Code 更轻量
• Windows 原生用户：目前只支持 WSL，不支持 CMD/PowerShell
• 追求 GUI 的用户：Plandex 是纯终端操作，习惯图形界面的话有学习成本
• 只想闭眼全自动：它的定位是”强大但受控”，如果你追求的是无脑跑全自主动，官方建议用 Claude Code 的 auto mode

和同类比差在哪

下一步怎么做

如果你想试：

1. 先在小的练习项目上跑一遍：git init + pdx，让 AI 写一个工具函数，感受它的 prompt 风格和文件修改逻辑
2. 有真实遗留项目要重构？先让它用 chat 模式了解代码库，再用 plan 模式做修改——把”调研”和”执行”分开用
3. 想省 token 成本？用 OpenRouter 自带缓存的模型（比如某些支持 cached tokens 的配置），或者开启上下文缓存

项目地址： https://github.com/plandex-ai/plandex

文档： https://docs.plandex.ai/

Discord 社区： https://discord.gg/plandex-ai

说实话，用 Plandex 最大的感受是：它不急着帮你”快点写完”，而是让你真正”看清楚改了什么”。沙盒 diff + 分步 review 这个设计，让 AI 写代码变成了一件可以中途喊停、调整方向的事，而不是等它全部跑完才发现走偏了。如果你经常被 AI 编程工具的”上下文溢出”和”改着改着就跑偏”折磨，试试它。