Plandex 命令速查表 - 终端规划型 AI 编码代理 (pdx)
Plandex（别名 pdx）是终端的"规划型"开源 AI 编码代理，面向喜欢让 AI 先把大改动拆成清晰的多步计划、逐步执行并跟踪进度的开发者。与"直接改"的代理不同，它强调计划先行与分支迭代，适合大型重构与渐进式落地；本表帮你掌握安装认证、new/load 规划加载、tell 执行与分支迭代。
安装与认证 4
curl -sL https://plandex.ai/install.sh | bash一行零依赖安装 CLI
export OPENAI_API_KEY=...默认用 OpenAI（也可 OPENROUTER_API_KEY）
plandex启动 REPL（别名 pdx）
pdxplandex 的短别名
规划与加载 6
plandex new在当前目录开启第一个计划
plandex load some-file.ts another-file.ts把文件加入上下文
plandex load src/components -r递归加载整个目录
plandex load src --tree只加载目录结构（文件名）
plandex load src/**/*.ts用 glob 匹配加载文件
plandex load https://raw.githubusercontent.com/.../README.md加载 URL 文本内容
执行与迭代 4
plandex tell "add a new line chart..."发送任务指令，Agent 先出计划再实现
plandex tell -f prompt.txt从文件读取提示词
plandex help列出全部命令
plandex <command> --help查看某命令详细帮助
分支与迭代 25
plandex plans列出当前/所有计划
plandex cd切换到某个计划目录
plandex current显示当前激活的计划
plandex ls列出上下文中的文件
plandex rm从上下文移除文件
plandex clear清空当前计划的上下文
plandex update更新计划/上下文到最新
plandex show显示当前计划的完整内容
plandex chat进入聊天模式（不写代码）
plandex continue继续上次未完成的任务
plandex build构建当前计划（生成 diff）
plandex debug "npm test"让 Agent 调试失败的命令
plandex diff显示计划产生的 diff
plandex apply --commit应用改动并提交
plandex reject --all拒绝全部改动
plandex log查看计划执行日志
plandex rewind 3回退到前 3 步
plandex branches列出分支
plandex checkout -y切换分支（自动确认）
plandex delete-branch删除分支
plandex config查看/编辑配置
plandex set-config设置配置项
plandex set-auto设置自动执行策略
plandex models列出可用模型
plandex set-model设置默认模型
提示
- Plandex 的核心是"先规划再实现"：改动先累积在受保护沙箱里，你审阅后再应用到项目文件，配合内置版本控制可随时回退。
- `plandex load -r` 递归加载目录、`--tree` 只加载结构、`**/*.ts` 用 glob，精细控制上下文，避免 token 浪费。
- 默认走 OpenAI，也能用 Anthropic Claude、Gemini、Mixtral、Llama 等——通过 OpenRouter.ai 或任意 OpenAI 兼容端点接入。
常见问题
Plandex 和普通的 AI 聊天编程有什么不同？
Plandex 面向大任务：改动先累积在沙箱里供你审阅，再一次性应用到项目；内置版本控制可回退，分支能并行尝试多套方案，上下文自动保持最新。
Plandex 必须用 OpenAI 吗？
默认用 OpenAI（需 OPENAI_API_KEY），但也支持 Anthropic Claude、Google Gemini、Mixtral、Llama 等，通过 OpenRouter.ai 或任意 OpenAI 兼容提供商接入。
由 巧匠 维护
公开更新于 2026年8月26日，内容持续校对官方文档。