> ## 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.

# Gptme

> 在 Gptme 中接入 AIHubMix：开源终端 AI 助手用单个 API key 写代码、跑脚本并自由切换模型。

**gptme** 是开发者 [@ErikBjare](https://github.com/ErikBjare) 开源的 **终端原生 AI Agent**，GitHub 仓库地址：[gptme/gptme](https://github.com/ErikBjare/gptme)。

它是目前最受欢迎的 **ChatGPT Code Interpreter 本地化平替方案**，最大特点是：

> 🚀 **「Agent in Your Terminal」**——只要有终端的地方，就能跑 AI Agent。\
> 笔记本、SSH 远程、tmux 会话、无头服务器、CI/CD 流水线，全部通吃。

#### 核心能力一览

| 能力                          | 说明                            |
| :-------------------------- | :---------------------------- |
| 💻 **代码执行（shell + python）** | 直接在本地环境跑命令、跑脚本                |
| ✏️ **文件编辑（patch 工具）**       | 增量修改文件，告别"全文重写"               |
| 🌐 **浏览器操作（Playwright）**    | 自动访问网页、抓取信息                   |
| 👁️ **视觉能力（Vision）**        | 看截图、读图片、识别桌面内容                |
| 🔄 **自我纠错**                 | 命令输出自动喂回模型，自动迭代               |
| 🤖 **长期自主 Agent**           | 参考实现 Bob 已自主运行近一年，自己提 PR、修 CI |

> 📚 PyPI 主页：[pypi.org/project/gptme](https://pypi.org/project/gptme/)\
> 📖 官方文档：[gptme.org](http://gptme.org)

###

#### 🎯 AIHubMix 为什么是 gptme 的完美拍档？

[AIHubMix](https://aihubmix.com/) 提供主流的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](http://aihubmix.com) 注册并拿到 API Key（以 `sk-` 开头）

\
项目部署后进入 \~/.config/gptme/config.toml 文件（位于用户主目录下）进行配置。\
配置文件例子：

```text theme={null}
[env]
OPENAI_API_KEY = "sk-xxx"
MODEL = "local/gpt-4o"
OPENAI_BASE_URL = "https://aihubmix.com/v1"
```

sk-xxx的位置换成输入[本站的Key](https://aihubmix.com/token)

### gptme 常用命令速查

| 命令           | 作用                     |
| :----------- | :--------------------- |
| `/help`      | 查看所有命令                 |
| `/tools`     | 查看当前可用工具               |
| `/model`     | 切换模型                   |
| `/edit`      | 编辑上一条消息                |
| `/undo`      | 撤销上一步                  |
| `/log`       | 查看会话日志                 |
| `/fork`      | 分叉会话                   |
| `/summarize` | 总结当前会话                 |
| `/tokens`    | 查看 token 用量            |
| `/export`    | 导出会话                   |
| `/commit`    | 让 gptme 直接做 git commit |
| `/exit`      | 退出                     |

***

### 常见问题（FAQ）

#### Q1：报错 `401 Unauthorized`？

检查三点：

1. `OPENAI_API_KEY` 前后是否有空格、引号是否完整
2. AIHubMix 账户是否已充值
3. 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 友好编辑   | 多文件重构                  |

gptme 的杀手锏是 **「能在服务器上裸跑」**，远程运维场景无可替代。

#### Q4：在 CI / 服务器上运行安全吗？

gptme 默认每个危险操作都会问你确认。如果在 CI 里全自动跑，可以加 `--no-confirm` 或 `--non-interactive` 参数，配合 Docker 沙盒更安全。

### 推荐工作流：把 gptme 变成你的"贴身工程师"

#### 💼 场景 1：服务器运维

```text theme={null}
ssh user@server
gptme --model deepseek-v4-flash "查一下昨天的 nginx 错误日志，统计 5xx 出现最多的接口"
```

#### 💼 场景 2：本地批量处理

```text theme={null}
gptme "把当前目录下所有 .png 转成 webp，压缩到 80%"
```

#### 💼 场景 3：项目代码审查

```text theme={null}
cd my-project
gptme --model claude-opus-4-7 "审查 src/ 目录下所有 TypeScript 文件，列出潜在的内存泄漏"
```

#### 💼 场景 4：自动化 commit

```text theme={null}
gptme "/commit"
# gptme 会读 git diff、自动生成 commit message、自动执行
```

***

立即开始：

👉 [前往 AiHubMix ](https://aihubmix.com/)\
👉 [前往 GitHub 安装 gptme](https://github.com/ErikBjare/gptme)\
👉 [查看 gptme 官方文档](https://gptme.org/)

最新更新日期：2026年5月13日