karthink/gptel

这是什么？

核心功能

• 01在 Emacs 任意 buffer 中与大模型对话，回复支持 Markdown 或 Org 格式。
• 02支持 OpenAI、Claude、Gemini、Ollama、Llama.cpp 等多种服务。
• 03对话可保存为普通文件，随时恢复并编辑之前的内容。
• 04支持工具调用和 Model Context Protocol 集成。
• 05发送前可查看并修改实际请求内容。
• 06支持图片和文档等多模态输入。

适用场景

• 不离开编辑器即可提问或重构代码。
• 通过 Ollama 或 Llama.cpp 运行本地模型，数据保留在本机。
• 基于统一的客户端接口，用 Elisp 构建自定义的大模型工作流。

快速上手

1. 1

   在 Emacs 中通过包管理器安装 gptel

2. 2

   确保 Transient 版本为 0.7.8 或更高(启用 package-install-upgrade-built-in 或手动更新)

3. 3

   将 OpenAI API 密钥设置到 gptel-api-key,或保留默认的 authinfo 读取方式

使用前须知

• !大多数云端后端需要 API 密钥、订阅或云凭据。
• !需要 Transient 0.7.8 或更高版本,而 Emacs 默认不会自动升级它。
• !Ollama 或 Llama.cpp 等本地后端需要你自行运行服务器。

收录于专题

标签

常见问题

gptel 是什么？

一个为 Emacs 设计的简洁可扩展大模型客户端，支持多种模型与后端。 gptel 是一个运行在 Emacs 内部的大语言模型聊天客户端，可以在任意 buffer、shell 或 minibuffer 中调用，回复以 Markdown 或 Org 格式呈现。对话可以保存为普通的 Markdown、Org 或文本文件，之后继续编辑，也可以同时维护多个相互独立的会话。

gptel 可以免费使用吗？用的什么许可证？

gptel 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

gptel 还在维护吗？

活跃维护中。gptel 最近一次提交是在 2026年11月5日。

gptel 适合用来做什么？

不离开编辑器即可提问或重构代码。 通过 Ollama 或 Llama.cpp 运行本地模型，数据保留在本机。 基于统一的客户端接口，用 Elisp 构建自定义的大模型工作流。

gptel 怎么安装和运行？

在 Emacs 中通过包管理器安装 gptel 确保 Transient 版本为 0.7.8 或更高(启用 package-install-upgrade-built-in 或手动更新) 将 OpenAI API 密钥设置到 gptel-api-key,或保留默认的 authinfo 读取方式

在哪里获取 gptel？

源代码和安装说明在 GitHub 上：https://github.com/karthink/gptel