agent-shell

在 Emacs 里直接跑 AI 代理，边写代码边对话

agent-shell 是一个 Emacs 插件，它提供了一个原生 Emacs buffer 来与基于 ACP（Agent Client Protocol）的 LLM 代理进行交互。它解决的是在 Emacs 环境中无缝集成 AI 代理工作流的问题，让用户无需离开编辑器即可使用强大的 AI 编程助手。其核心能力包括：通过 ACP 协议连接各种 LLM 代理（如 Claude Code），在 Emacs 中创建专用 buffer 展示代理输出，支持交互式输入、流式响应显示，并深度集成 Emacs 的编辑和导航功能。它利用 Emacs Lisp 实现，轻量且可高度定制，为 Emacs 用户提供了类似终端但更原生的 AI 交互体验。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1885

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队xenodium

所属国家

官网地址https://xenodium.com

GitHubhttps://github.com/xenodium/agent-shell

定价模式free

价格说明开源项目，GPL-3.0许可，可免费使用和自行部署。

访问状态

是否开源是

开源协议GPL-3.0

主要语言Emacs Lisp

技术栈/模型ai,claude,claude-code,codex,emacs,emacs-lisp,gemini,goose,llm,openai

GitHub 星标★ 1885

30天Star增速

HF 下载量

上线时间2025-09-09 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：进阶约 10 分钟部署方式：本地安装 4 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Emacs（README 未标注最低版本要求）
可访问 MELPA 包仓库的网络环境
已安装并配置好的 ACP 代理 CLI（如 Claude Agent、Gemini CLI、Goose 等）
所用 LLM 代理对应的 API 密钥或登录凭证

安装与启动步骤

1配置 MELPA 源

在 Emacs 配置文件（如 init.el）中加入 MELPA 包仓库并初始化 package，否则无法搜索到 agent-shell。
```
(require 'package)
(add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t)
(package-initialize)
```
2安装 agent-shell

刷新包索引后从 MELPA 安装 agent-shell，README 中的 MELPA 徽章表明这是官方发布渠道。
```
(progn
  (package-refresh-contents)
  (package-install 'agent-shell))
```
3安装 ACP 代理

agent-shell 只负责在 Emacs 中展示，需另行按各代理官方文档安装 CLI，README 列出了可选代理链接。
4启动 agent-shell

在 Emacs 中打开 agent-shell 提供的原生 buffer 与代理交互，具体启动入口请以项目 README 为准。

如何确认成功

Emacs 中成功加载 agent-shell 并打开其专用 buffer，能收到 ACP 代理的流式响应即表示可用。

常见问题

Q：agent-shell 支持哪些 LLM 代理？

A：任何基于 ACP（Agent Client Protocol）的代理，README 列举了 Claude Agent、Codex、Gemini CLI、Goose、Grok Build、Cursor、Kimi Code CLI、CodeBuddy、Kiro CLI、Qwen Code、Auggie 等。

Q：必须通过 MELPA 安装吗？

A：README 顶部提供了 MELPA 徽章链接，说明包已发布到 MELPA，这是最直接的安装渠道；其他方式 README 未说明。

Q：使用需要额外付费吗？

A：agent-shell 本身开源，但调用 LLM 代理产生的 token 费用由你自己承担，作者也呼吁赞助以维持项目发展。

Q：装好后代理无响应怎么办？

A：检查对应 ACP 代理 CLI 是否已按官方文档安装、是否已登录或配置 API 密钥，并确认其在终端中可独立运行。

注意事项

README 节选中未包含正式安装与配置章节，上述安装步骤依据 MELPA 徽章和项目描述推断，请以仓库最新 README 为准。
每个 ACP 代理都需要单独安装并配置凭证，agent-shell 不会代为安装。
若包列表里搜不到 agent-shell，先执行 package-refresh-contents 刷新索引。
项目维护依赖赞助支持，README 中有 GitHub Sponsors 链接。

核心亮点

原生 Emacs buffer 集成，支持熟悉的编辑键位和导航
基于 ACP 协议，可连接多种主流 LLM 代理，不锁定单一厂商
流式输出显示，交互响应实时，体验流畅

不足之处

依赖外部 ACP 代理，需额外配置环境
文档/社区待观察

适用场景

在 Emacs 中使用 Claude Code 等 AI 代理辅助编程
在 Emacs 中执行自然语言驱动的代码生成和重构任务
结合 Emacs 的 org-mode 或 magit 进行 AI 辅助的文档和 Git 操作

替代项目

gptel、llm.el、copilot.el

项目介绍

agent-shell 是智能体领域的开源项目，由 xenodium 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,885）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,722 增加到 1,885，净增 163。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。GPL-3.0许可，可免费使用和自行部署。

它主要面向的使用场景是：在Emacs中使用ClaudeCode等AI代理辅助编程。同类可对比的替代方案包括 gptel、llm.el、copilot.el。

上一篇：mcp-brasil

下一篇：Auto-Deep-Research