agent-shell新手配置指南5种认证方式与API密钥5分钟快速设置【免费下载链接】agent-shellA native Emacs buffer to interact with LLM agents powered by ACP项目地址: https://gitcode.com/gh_mirrors/ag/agent-shellagent-shell是一个运行在 Emacs 内的原生缓冲区buffer让你直接在编辑器里与 Claude、Gemini、Codex 等 LLM AI 编程智能体对话底层基于 ACPAgent Client Protocol协议与各类智能体通信。作为新手你最大的顾虑往往是认证怎么配——别担心本文带你用5 分钟搞定 API 密钥设置一次性讲清 5 种认证方式从安装到跑通会话一气呵成。 快速安装 agent-shell3 步启动第一步安装 Emacs 包agent-shell 依赖acp.el和shell-maker推荐用use-package一条搞定(use-package agent-shell :ensure t :ensure-system-package ((claude . npm install -g agentclientprotocol/claude-agent-acp)))如果你更喜欢从源码浏览仓库地址为git clone https://gitcode.com/gh_mirrors/ag/agent-shell第二步安装对应的智能体 CLI以 Claude 为例全局安装 ACP 适配的二进制命令npm install -g agentclientprotocol/claude-agent-acp which claude-agent-acp # 确认已加入 PATH 其他智能体Codex、Gemini CLI、Goose、Grok 等的安装方式各不相同完整清单见 README.org 的 Setup 章节。第三步启动在 Emacs 中执行M-x agent-shell从列表选择智能体即可开始聊天。加前缀参数C-u M-x agent-shell可强制开启新会话多窗口并行使用多个智能体。 5 种认证方式全解析agent-shell 的认证配置统一通过各智能体文件提供的*-make-authentication函数完成比如 agent-shell-anthropic.el 中的agent-shell-anthropic-make-authentication。下表帮你 30 秒看懂选型认证方式适用场景配置难度推荐指数① 账号登录Login已订阅 Claude/ChatGPT 等会员⭐ 最简单② API 密钥按量付费、CI 环境⭐ 简单③ OAuth Token长期使用固定令牌⭐⭐④ 环境变量注入密钥存于 .env 或系统环境⭐⭐⑤ 免认证外部已登录Cursor、Goose 等 CLI 自带登录⭐ 零配置认证方式一账号登录推荐订阅用户如果你有 Claude 或 Google 的订阅账号直接在 Emacs 外先登录一次然后配置登录认证(setq agent-shell-anthropic-authentication (agent-shell-anthropic-make-authentication :login t))Google Gemini 同理见 agent-shell-google.el(setq agent-shell-google-authentication (agent-shell-google-make-authentication :login t))认证方式二API 密钥最通用在服务商控制台申请 API Key 后直接以字符串传入(setq agent-shell-anthropic-authentication (agent-shell-anthropic-make-authentication :api-key 你的-sk-ant-开头密钥))OpenAI Codex 的对应配置在 agent-shell-openai.el 中(setq agent-shell-openai-authentication (agent-shell-openai-make-authentication :api-key 你的-openai-密钥))⚠️ 注意认证参数:login、:api-key、:oauth三选一同时传多个会报错源码见 agent-shell-anthropic.el 的校验逻辑。认证方式三OAuth Token适合长期使用固定令牌的用户例如 Claude 的setup-token生成的 OAuth 令牌(setq agent-shell-anthropic-authentication (agent-shell-anthropic-make-authentication :oauth 你的-oauth-token))认证方式四环境变量注入.env 一把梭不想把密钥写死在配置里用agent-shell-make-environment-variables帮助函数支持从.env文件加载(setq agent-shell-anthropic-claude-environment (agent-shell-make-environment-variables :load-env ~/.env ; 从 .env 文件读取 :inherit-env t)) ; 同时继承 Emacs 的 PATH、HOME 等.env文件按KEYvalue格式一行一条支持#注释ANTHROPIC_API_KEYsk-ant-xxxx OPENAI_API_KEYsk-xxxx也可以直接传键值对或让密钥来自系统环境的继承​:inherit-env t。这一方式在需要走代理或切换第三方兼容端点时同样适用设置ANTHROPIC_BASE_URL等变量即可。认证方式五外部已认证零配置部分智能体如 Cursor、Goose、Qoder 的 CLI 自带登录态agent-shell 直接复用外部登录无需任何配置。如果你想显式声明不发送认证请求可以传:none t例如 agent-shell-cursor.el(setq agent-shell-cursor-authentication (agent-shell-cursor-make-authentication :none t))️ API 密钥安全最佳实践把明文密钥写进~/.emacs不是好习惯。推荐传一个返回密钥的函数从系统密钥管理器如 pass、Keychain动态读取(setq agent-shell-anthropic-authentication (agent-shell-anthropic-make-authentication :api-key (lambda () (auth-source-pass-get secret anthropic-api-key))))这样密钥只存在加密的密码管理器里配置文件保持干净也方便多机同步。✅ 5 分钟自检清单如何确认配置成功保存配置后重启 Emacs执行M-x agent-shell选择你配置的智能体若认证成功缓冲区会显示模型列表并进入可输入状态输入/还能看到智能体支持的斜杠命令配置有误时会看到认证失败提示回到上面对应方式核对即可。进阶查看 ACP 通信流量可选想确认 agent-shell 与智能体之间的协议交互是否正常可以用 Emacs 的tcp-traffic库观察 JSON-RPC 流量例如权限请求session/request_permission、工具调用等事件都会清晰可见项目自带的测试流量样例见 tests/gemini-permission.traffic 小结有订阅→ 选:login最省事按量付费→ 选:api-key建议配合函数从密钥管理器读取多智能体/代理环境→ 用环境变量 .env文件统一管理CLI 自带登录→ 选:none零配置直接开聊。配置完成后你的 Emacs 就变成了一个多智能体工作台在同一个编辑器里并行驱动 Claude、Gemini、Codex 完成代码任务配合C-c C-o的视口模式逐条审阅回答。更多命令、事件订阅与容器化运行方案可以继续翻阅 README.org 和主入口 agent-shell.el。祝你 5 分钟后就能和 AI 智能体愉快开聊【免费下载链接】agent-shellA native Emacs buffer to interact with LLM agents powered by ACP项目地址: https://gitcode.com/gh_mirrors/ag/agent-shell创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考