Plandex：面向大型项目与真实任务的终端 AI 编程智能体
Plandex 是一个基于终端的开源 AI 编程工具，可规划并执行跨多步骤、涉及数十个文件的大型编码任务。默认模型组合提供约 200 万 token 有效上下文窗口（单文件约 10 万 token），并通过 tree-sitter 项目地图索引 2000 万 token 以上的目录。它提供累积式 diff 审查沙箱、版本控制与分支、自动化调试、Git 集成，以及从全自动到逐步确认的可配置自主度。
社区作者 · zZz
它解决什么问题
Plandex 是一个面向大型任务与真实世界项目的 AI 编程智能体，以终端（REPL/CLI）为主要交互形态。
核心能力：
- 任务规模：可规划并执行跨多步骤、触及数十个文件的大型编码任务，适合项目体积变大、变更复杂度上升后其他工具吃力的场景。
- 上下文：默认模型包提供约 2M token 的有效上下文窗口（约 100k token/文件），仅加载每一步所需内容；借助 tree-sitter 项目地图可索引 20M token 及以上的目录，支持 30 多种语言的语法校验与快速项目地图生成。
- 审查沙箱：累积式 diff 审查沙箱让 AI 生成的改动与项目文件保持隔离，直到确认可用；命令执行受控，便于回滚和调试。
- 模型组合：可组合 Anthropic、OpenAI、Google 与开源提供商的模型；提供经过筛选的模型包，在能力、成本、速度之间取舍，也包含开源包与特定提供商包。对 OpenAI、Anthropic、Google 模型普遍使用上下文缓存以降低费用与延迟。
- 自主度：可从全自动模式切换到细粒度控制；支持对终端命令（构建、lint、测试、部署、脚本）自动调试，安装 Chrome 时还可自动调试浏览器应用。
结果质量：项目感知的 chat 模式用于在实现前梳理想法、提问和学习代码库；文件编辑以正确性优先，按需校验语法与逻辑并带多层回退；每次计划更新都有完整版本控制，支持分支以探索多条路径或比较不同模型；
Git 集成支持生成提交信息与可选自动提交。
- 交互方式：REPL 模式支持命令与文件加载的模糊自动补全，在任意项目中运行 plandex 即可开始；另有 CLI 接口用于脚本化或将数据管道式注入上下文。
- 部署形态：一行、零依赖的 CLI 安装；提供 Docker 化的本地模式便于自托管服务器；也有云托管选项（云服务自 2025/10/3 起逐步关停且不再接受新用户）。
配图 1 为 Plandex 深色背景 logo；配图 2 为 Plandex v2 演示视频封面；配图 3 展示了 Plandex 的工作流（workflow）；配图 4 为 Plandex 浏览器调试示例的演示封面。
典型工作流：先 cd 进入目标项目目录并用 REPL 启动 Plandex，在项目感知的 chat 模式中梳理需求，然后让智能体加载相关文件、制定计划、实现改动，在 diff 沙箱中审查、修订并应用，最后按需执行命令并自动调试。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
安装（30 秒安装）：
- 准备环境
- 一条命令、零依赖的 CLI 安装方式。
Windows 需通过 WSL 支持：Plandex 仅在 WSL shell 中能正确工作，在 Windows CMD 提示符或
PowerShell 中无法正常使用。
- 自托管/本地模式需要 Docker（或在自有服务器上托管）。
- 使用 OpenRouter.ai 时需自备 key；也可使用其他模型提供商账号与 API key。
- 如需自动调试浏览器应用，需本机安装 Chrome（可选）。
- 安装 CLI
curl -sL https://plandex.ai/install.sh | bash（页面另提供更多安装选项，详见 More installation options。）
- 配置提供商密钥
export OPENROUTER_API_KEY=... # 如果使用 OpenRouter.ai如果你有 Claude Pro 或 Max 订阅，Plandex 在调用 Anthropic 模型时可以使用它。首次运行 Plandex 时会询问是否连接订阅。
- Claude Pro/Max 订阅（可选）
- 自托管/本地模式（可选）
- 使用 Docker 在本地运行 Plandex，或托管在自己的服务器上。
- 使用自己的 OpenRouter.ai key（或其他模型提供商账号与 API key）。
- 按本地模式快速开始（local-mode quickstart）文档操作。
- 开始使用
- 先 cd 进入你希望完成任务或讨论项目的目录；如果是新项目，先用 mkdir your-project-dir 创建目录：
cd your-project-dir- 新项目可初始化 git 仓库（Plandex 不强制要求项目在 git 仓库中，但使用 git 时集成效果更好）：
git initplandex 或使用简写： pdx
- 在项目中启动 Plandex REPL：
常见问题与注意事项：
Windows 下不要在 CMD 或
PowerShell 中运行，必须使用 WSL shell。
- 云托管版 Plandex Cloud 自 2025/10/3 起逐步关停且不再接受新用户，请改用自托管/本地模式。
- 需要模型提供商的 key 才能调用模型；使用 OpenRouter.ai 时设置 OPENROUTER_API_KEY。
- 开发环境搭建可参考仓库中的开发环境说明（overview on setting up a development environment）。
- 更多安装方式与完整文档见官方 Docs。
