Plandex 命令速查表 - 终端规划型 AI 编码代理 (pdx)
AI 编码代理这两年的分歧不在模型强弱，而在改动以什么方式落地。Plandex（pdx）选的是最保守也最省心的一条：所有改动先写进沙箱里的计划文件，你审完再一次性应用到项目，中间任何一步都能回退。它与直接在工作区落笔的代理最大的区别，是把「计划」当成一等产物——new 写 plan、tell 追加需求、load 精确圈定进入上下文的文件。这张表按安装与认证、规划与加载、执行与迭代、分支与迭代分组，讲清多轮需求如何追加、一次大改动怎么拆成若干可独立验证的批次。什么时候翻它：准备跨十几个文件的重构、需求还在飘但想先把共识写下来、或者需要把某次迁移的决策过程留档以便日后回看。与其它代理的分界很清楚：你不需要为「它会不会把文件改坏」额外写快照脚本，规划本身就是那层保护。
安装与认证 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 diff 先看改动、plandex accept 再落盘，这两步分开是它相对直接改文件代理的核心安全优势。
- 把项目约定（构建命令、目录规范、提交信息风格）写进 AGENTS.md 再 load，比每次在对话里重复交代稳定得多。
常见问题
Plandex 和普通的 AI 聊天编程有什么不同？
Plandex 面向大任务：改动先累积在沙箱里供你审阅，再一次性应用到项目；内置版本控制可回退，分支能并行尝试多套方案，上下文自动保持最新。
Plandex 必须用 OpenAI 吗？
默认用 OpenAI（需 OPENAI_API_KEY），但也支持 Anthropic Claude、Google Gemini、Mixtral、Llama 等，通过 OpenRouter.ai 或任意 OpenAI 兼容提供商接入。
由 巧匠 维护
公开更新于 2026年8月26日，内容持续校对官方文档。