一款专为大型任务和真实世界项目设计的AI编码助手。

💻  Plandex是一款基于终端的AI开发工具，能够规划并执行涉及多步骤、触及数十个文件的大型编码任务。它可直接处理高达200万token的上下文（约每文件10万token），并通过Tree-Sitter项目映射索引包含2000万token或更多内容的目录。

🔬  累积差异审查沙盒会将AI生成的更改与您的项目文件隔离开来，直到它们准备就绪。命令执行受到严格控制，因此您可以轻松回滚和调试。Plandex帮助您充分利用AI的能力，同时不会在项目中留下混乱的痕迹。

🧠  结合Anthropic、OpenAI、Google以及开源提供商的最佳模型，借助稳健的终端工作流构建完整的功能和应用程序。

🚀  Plandex具备<强>完全自主性</强>——它可以加载相关文件、规划并实施更改、执行命令，并自动进行调试——但它也非常灵活且可配置，可在需要时为开发者提供细粒度的控制和逐步审查流程。

💪  Plandex专为应对<强>大型项目和文件</强>而设计。如果您发现其他工具在项目规模超过一定限度或更改过于复杂时会遇到困难，不妨试试Plandex。

适用于大型项目的智能上下文管理

• 🐘 200万token的有效上下文窗口，配备默认模型包。Plandex仅加载每一步所需的上下文。

• 🗄️ 在大型项目和文件中表现可靠。 轻松生成、审查、修改并应用跨越数十个文件的更改。

• 🗺️ 快速生成项目映射及使用Tree-Sitter进行语法验证。支持30多种语言。

• 💰 上下文缓存广泛应用于OpenAI、Anthropic和Google的模型，从而降低费用并减少延迟。

紧密控制或完全自主——由您决定

• 🚦 可配置的自主性： 根据任务需求，从完全自动模式切换到细粒度控制。

• 🐞 终端命令的自动化调试（如构建、代码检查器、测试、部署和脚本）。如果已安装Chrome浏览器，还可以自动调试浏览器应用程序。

助力您获得生产就绪成果的工具

• 💬 项目感知聊天模式，可在进入实现阶段前帮助您完善想法。也非常适合提问和了解代码库。

• 🧠 轻松尝试并组合来自不同提供商的模型。 精选的模型包提供了能力、成本和速度之间的不同权衡，同时还包括开源和特定提供商的模型包。

• 🛡️ 可靠的文件编辑优先考虑正确性。虽然大多数编辑快速且经济，但Plandex会根据需要验证语法和逻辑，并在出现问题时提供多重后备机制。

• 🔀 完善的版本控制，用于计划的每一次更新，包括用于探索多条路径或比较不同模型的分支。

• 📂 Git集成，支持生成提交信息，并可选择自动提交。

开发者友好，易于安装

• 🧑‍💻 REPL模式，具有模糊自动补全功能，可用于输入命令和加载文件。只需在任何项目中运行plandex即可开始使用。

• 🛠️ CLI界面，可用于编写脚本或将数据导入上下文。

• 📦 一行命令、零依赖的CLI安装。提供容器化的本地模式，方便用户自行托管服务器。同时也有云托管选项，以提升可靠性和便利性。

工作流程  🔄

示例  🎥

安装  📥

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

注意： Windows系统可通过WSL支持。Plandex仅在WSL shell中才能正常运行，在Windows CMD提示符或PowerShell中则无法使用。

更多安装选项。

托管  ⚖️

选项	描述
Plandex Cloud	自2025年10月3日起逐步停止服务，不再接受新用户。 了解详情。
自托管/本地模式	• 使用 Docker 在本地运行 Plandex，或将其部署在您自己的服务器上。 • 使用您自己的 OpenRouter.ai 密钥（或其他模型提供商 的账户和 API 密钥）。 • 按照本地模式快速入门 文档开始使用。

提供商密钥  🔑

export OPENROUTER_API_KEY=... # 如果使用 OpenRouter.ai

Claude Pro/Max 订阅  🖇️

如果您拥有 Claude Pro 或 Max 订阅，Plandex 在调用 Anthropic 模型时可以使用该订阅。首次运行 Plandex 时，系统会询问您是否要连接订阅。

开始使用  🚀

首先，cd 到您希望完成任务或讨论项目的项目目录中。如果您刚开始一个新项目，请先使用 mkdir your-project-dir 创建一个新目录。

cd your-project-dir

对于新项目，您可能还想初始化一个 Git 仓库。虽然 Plandex 并不要求您的项目必须位于 Git 仓库中，但如果使用 Git，Plandex 可以很好地与之集成。

git init

现在，在您的项目中启动 Plandex REPL：

plandex

或者简写为：

pdx

文档  🛠️

👉  完整文档。

讨论与 Discord  💬

欢迎您提出反馈、提问、报告问题，或只是来聊聊天：

• Discord
• 讨论区
• 问题追踪

关注与订阅

• 关注 @PlandexAI
• 关注 @Danenania（Plandex 的创建者）
• 订阅 YouTube 频道

贡献者  👥

⭐️  请为 Plandex 点赞、叉出、探索并贡献代码。我们还有很多工作要做，也还有许多可以改进的地方。

这里提供了关于搭建开发环境的概述。

Plandex 快速上手指南

环境准备

• 系统要求：Linux/macOS 推荐。Windows 用户需使用 WSL（Windows Subsystem for Linux），不支持 CMD/PowerShell。
• 前置依赖：无额外依赖（安装脚本自动处理）。

安装步骤

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

注意：Windows 用户必须在 WSL 终端中运行此命令。

基本使用

1. 创建项目目录并进入：

   mkdir my-project && cd my-project
   

2. 初始化 Git（可选但推荐）：

   git init
   

3. 启动 Plandex REPL：

   plandex
   

   或简写：

   pdx
   

启动后默认进入聊天模式，可直接描述需求（如“添加用户登录功能”），Plandex 会引导你完成任务规划和代码生成。