Mentat 命令速查表 - 终端多文件 AI 编码代理 CLI 全参数
Mentat 是终端原生的 AI 编码代理，核心动作是「产出跨多文件的 diff」：你给它文件与需求，它提出统一补丁，你审阅后应用。它尊重 .gitignore、支持自动上下文检索与 MCP 工具。本表覆盖上下文控制、模型与交互命令，读完即可在终端里做大规模重构。
安装与起步 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，只改你传入路径内的文件，是个不错的安全默认。
常见问题
Mentat 和 Aider 有什么不同？
两者都是终端多文件编码代理，Mentat 以「统一 diff + 审阅」为核心交互，Aider 更强调 git 式的 /add 与聊天循环；可按手感选择。
必须联网用云端模型吗？
默认走 OpenAI，也支持 Anthropic 或经 LiteLLM 接本地模型；密钥通过环境变量或 .env 提供。
由 巧匠 维护
公开更新于 2026年9月10日，内容持续校对官方文档。