gptme 命令速查表 - 终端 AI 智能体 CLI 全参数
gptme 是跑在终端里的个人智能体：自带 shell、Python、网页访问与视觉工具，能直接读文件、执行命令、做多 agent 并发，且不绑定某一家 provider。它的定位和纯聊天助手的差别在于它会真的动手——所以决定价值的是上下文与权限的划定：接上项目文件做 RAG 索引，它才知道你的代码库长什么样；用 +tool 与 -tool 精确增删可用工具，比全开安全得多，尤其在自动执行的场景。脚本化则靠 -y 免交互确认与 --output-format json 拿结构化结果，这是把它接进 CI 或常驻任务的前提。表里按基础对话、工具与上下文、会话与工具管理三组列出命令与常用标志。
基础对话 6
gptme "hello"以提示词启动对话
gptme "fix TODOs" main.py带文件上下文启动
gptme -m anthropic/claude-sonnet-4-20250514指定模型
gptme -y "run tests and fix"自动确认工具执行
gptme -n "summarize git diff"非交互模式（CI 用）
gptme --output-format json "summarize diff"输出 JSON 便于解析
工具与上下文 6
gptme -t read-only "summarize repo"只读工具，不写不执行
gptme -t patch,save "fix typo" main.py仅允许指定工具
gptme -t +subagent "plan refactor"在默认工具上追加 subagent
gptme -t=-browser "summarize code"从默认工具移除 browser
gptme --tools none "what is 2+2"禁用全部工具纯聊天
gptme --context files "do task"跳过上下文命令保留项目文件
会话与工具管理 8
gptme -r恢复最近会话
gptme --name mytask指定会话名
gptme tools list列出可用工具
gptme chats list列出历史会话
gptme models list列出可用模型
gptme context index为 RAG 索引项目文件
gptme chats search "query"搜索历史会话
gptme --help列出全部参数
提示
-y自动确认、-n非交互配合--output-format json，是把它塞进 CI 的标准姿势。-t用+tool/-tool增删工具，细粒度控制权限，比全开更安全。gptme context index做 RAG 索引后，对话能带上项目文件上下文。- gptme -y --output-format json "任务" 可直接进 CI；解析返回里的 final 消息字段拿结论。
- 重名或版本冲突的子会话用 --session 显式指定会话名，避免多 agent 并发时上下文串线。
- 日志在 ~/.local/share/gptme/logs 下排障时会话异常，配合 --verbose 能看到工具调用的完整参数。
常见问题
gptme 和 Claude Code 有什么不同？
gptme 是 provider 无关、本地优先的通用终端智能体，支持 100+ 模型与并发 agent；Claude Code 是 Anthropic 官方、偏 Claude 原生的 agent。两者都能跑 shell/代码。
能在无界面的服务器上跑吗？
能。-n 非交互模式专为 SSH / tmux / headless / CI 设计，输出可机读。
由 巧匠 维护
公开更新于 2026年9月10日，内容持续校对官方文档。