Mentat 命令速查表 - 终端多文件 AI 编码代理 CLI 全参数
Mentat 是终端里的 AI 编码代理，它的核心产出不是聊天里的代码片段而是一份跨文件的统一 diff：给定文件与需求，它产出补丁，你审阅后决定是否应用。这个形态决定了几件具体的事——审阅是必要环节而不是可选项，因为改动会跨文件，单看片段容易漏掉连带修改；它遵守 .gitignore 且不越出你传入的路径，因此安全边界靠传参来划；在大型仓库里手工挑文件不现实，--auto-context 的检索式上下文能显著减少你喂文件的工作量。表里按安装起步、上下文控制、交互与脚本分组，覆盖命令与标志的含义。用它做大规模重构时，一次把范围说清楚并逐个应用 diff，比反复单文件对话更稳。
安装与起步 4
pip install mentat-ai安装 Mentat
mentat在项目目录启动交互会话
mentat --help查看全部参数
export OPENAI_API_KEY=sk-xxxx设置 API 密钥
上下文控制 7
mentat src/main.py tests/把指定文件/目录纳入上下文
mentat "scripts/**/*.py"用 glob 纳入多个文件
mentat src/ --exclude tests/legacy/纳入目录但排除子路径
mentat --auto-context开启自动上下文检索
mentat -a --auto-tokens 8000限制自动上下文 token 数
mentat --model claude-3-5-sonnet指定模型
mentat --mcp-server "npx @modelcontextprotocol/server-postgres"接入 MCP 工具服务
交互与脚本 9
/include会话中追加文件到上下文
/exclude会话中排除文件
/model gpt-4o会话中切换模型
:save保存当前会话
:load加载已保存会话
mentat --run "生成文档字符串"非交互模式直接执行
git init首次使用 Mentat 前初始化 git（它依赖 git）
mentat --version查看版本
mentat src/ --exclude "**/*.test.ts"排除测试文件纳入上下文
提示
- Mentat 产出的是统一 diff，审阅后再应用，比聊天式工具更贴近「结对编程」。
--auto-context用 RAG 自动找相关片段，大仓库里能少手动挑文件。- 它尊重 .gitignore，只改你传入路径内的文件，是个不错的安全默认。
- 先用 --auto-context 让它自己定位相关文件，再人工补充关键文件，比一次性粘贴整个目录更省 token。
- 产出 diff 先落到分支上逐块审阅：git apply --stat 看改动规模，git apply --check 确认能干净应用。
- 在 CI 或脚本中加 --no-pretty 让输出保持机器可读格式，便于解析与二次处理。
常见问题
Mentat 和 Aider 有什么不同？
两者都是终端多文件编码代理，Mentat 以「统一 diff + 审阅」为核心交互，Aider 更强调 git 式的 /add 与聊天循环；可按手感选择。
必须联网用云端模型吗？
默认走 OpenAI，也支持 Anthropic 或经 LiteLLM 接本地模型；密钥通过环境变量或 .env 提供。
由 巧匠 维护
公开更新于 2026年9月10日，内容持续校对官方文档。