gptme 是开发者 @ErikBjare 开源的 终端原生 AI Agent,GitHub 仓库地址:gptme/gptme。 它是目前最受欢迎的 ChatGPT Code Interpreter 本地化平替方案,最大特点是:Documentation Index
Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
Use this file to discover all available pages before exploring further.
🚀 「Agent in Your Terminal」——只要有终端的地方,就能跑 AI Agent。
笔记本、SSH 远程、tmux 会话、无头服务器、CI/CD 流水线,全部通吃。
核心能力一览
| 能力 | 说明 |
|---|---|
| 💻 代码执行(shell + python) | 直接在本地环境跑命令、跑脚本 |
| ✏️ 文件编辑(patch 工具) | 增量修改文件,告别”全文重写” |
| 🌐 浏览器操作(Playwright) | 自动访问网页、抓取信息 |
| 👁️ 视觉能力(Vision) | 看截图、读图片、识别桌面内容 |
| 🔄 自我纠错 | 命令输出自动喂回模型,自动迭代 |
| 🤖 长期自主 Agent | 参考实现 Bob 已自主运行近一年,自己提 PR、修 CI |
📚 PyPI 主页:pypi.org/project/gptme
📖 官方文档:gptme.org
🎯 AIHubMix 为什么是 gptme 的完美拍档?
AIHubMix 提供主流的LLM,专为 gptme 这类「多模型切换」场景设计:- ✅ 一个 Key 调用全部模型:GPT-5.5 / Claude Opus 4.7 / DeepSeek V4 Flash / Gemini 3 Pro 全聚合
- ✅ 完全兼容 OpenAI 接口格式——gptme 只需改一行
OPENAI_BASE_URL - ✅ 接入即生效,无需重新登录任何模型厂商账户
gptme + AIHubMix 配置教程(3 步搞定)
💡 前置条件:
- 已安装 Python 3.10+
- 已通过 pipx / pip 安装 gptme(
pipx install gptme)- 已在 aihubmix.com 注册并拿到 API Key(以
sk-开头)
项目部署后进入 ~/.config/gptme/config.toml 文件(位于用户主目录下)进行配置。
配置文件例子:
gptme 常用命令速查
| 命令 | 作用 |
|---|---|
/help | 查看所有命令 |
/tools | 查看当前可用工具 |
/model | 切换模型 |
/edit | 编辑上一条消息 |
/undo | 撤销上一步 |
/log | 查看会话日志 |
/fork | 分叉会话 |
/summarize | 总结当前会话 |
/tokens | 查看 token 用量 |
/export | 导出会话 |
/commit | 让 gptme 直接做 git commit |
/exit | 退出 |
常见问题(FAQ)
Q1:报错 401 Unauthorized?
检查三点:
OPENAI_API_KEY前后是否有空格、引号是否完整- AIHubMix 账户是否已充值
- Key 是否被复制全
Q2:MODEL 字段里 local/gpt-4o 的 local/ 是什么意思?
local/ 是 gptme 内部的 provider 前缀,表示「按本地 BASE_URL 路由」。保留 local/ 即可,不要去掉。也可以直接写模型名(如 gpt-5.5),gptme 会自动按 OpenAI 格式调用。
Q3:和 Cursor / Claude Code / Aider 比,gptme 优势是什么?
| 工具 | 定位 | 适合场景 |
|---|---|---|
| gptme | 终端原生 Agent | SSH / 服务器 / 自动化脚本 / CI |
| Cursor | IDE 集成 | 桌面写代码 |
| Claude Code | 官方 CLI | Anthropic 生态深度用户 |
| Aider | Git 友好编辑 | 多文件重构 |
Q4:在 CI / 服务器上运行安全吗?
gptme 默认每个危险操作都会问你确认。如果在 CI 里全自动跑,可以加--no-confirm 或 --non-interactive 参数,配合 Docker 沙盒更安全。
推荐工作流:把 gptme 变成你的”贴身工程师”
💼 场景 1:服务器运维
💼 场景 2:本地批量处理
💼 场景 3:项目代码审查
💼 场景 4:自动化 commit
立即开始: 👉 前往 AiHubMix
👉 前往 GitHub 安装 gptme
👉 查看 gptme 官方文档 最新更新日期:2026年5月13日