Goose AI Agent 入门指南：10 分钟装好跑通第一次会话，MCP 扩展 70+ 外部工具

Goose AI Agent 入门指南：10 分钟装好跑通第一次会话，MCP 扩展 70+ 外部工具

【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goose

Goose 是一个运行在你本地机器上的开源 AI Agent，提供桌面应用、命令行（CLI）和 API 三种形态，不局限于写代码——研究、写作、数据分析、自动化都能做。如果你还没有各家 API Key，可以直接从 Ollama 这类本地模型提供商起步；如果你熟悉终端，CLI 路径最短。本文按"它是什么 → 快速上手 → 实战一个完整闭环 → 扩展生态 → 常见坑"的顺序带你走一遍，目标是一小时之内让 Goose 真正干活。

它是什么：一个跑在你自己机器上的通用 Agent

一句话结论：Goose 不是代码补全插件，而是能替你执行命令、编辑文件、运行测试的通用代理，且模型和工具都可以自由更换。

• 本地运行：用 Rust 编写，数据留在你的机器上；项目隶属 Linux 基金会旗下的 Agentic AI Foundation（AAIF）。
• 15+ 模型提供商：Anthropic、OpenAI、Google、Ollama、OpenRouter、Azure、Amazon Bedrock 等任选；还支持通过 ACP 接入你已有的 Claude、ChatGPT 订阅。
• 70+ 扩展：基于 MCP（Model Context Protocol）开放标准接入外部工具，从数据库到浏览器都能连。
• 三种入口：
  • 桌面应用：覆盖 macOS、Linux、Windows，图形界面，适合日常使用；
  • CLI：goose命令，适合终端流和自动化脚本；
  • API：嵌入你自己的产品，对应仓库中的 goose-sdk 模块。

想先了解全貌，可参考 官方快速上手文档。

快速上手：10 分钟装好并配置第一个 LLM 提供商

一句话结论：安装脚本跑一行、goose configure选个提供商、goose session开会话，三件事做完就能对话。

两种安装方式

• 桌面版：到安装页下载对应系统的安装包解压运行即可，Linux 用 DEB/RPM 包，macOS 也可以走 Homebrew；
• CLI：在终端执行官方安装脚本，一条命令完成下载和安装：

curl -fsSL https://gitcode.com/GitHub_Trending/goose3/goose/releases/download/stable/download_cli.sh | bash

详细步骤与更新方式（goose update）见 安装指南。

装完立刻做的三件事

1. 配置 LLM 提供商：桌面版欢迎界面会引导你选择；CLI 运行goose configure后选Configure Providers。新手推荐Tetrate Agent Router——它聚合多家模型，内置限流和自动故障转移，首次自动认证还送 $10 额度；已有 API Key 的话选 Anthropic、OpenAI 等对应项填入即可，最后从列表里挑一个模型。
2. 启动会话：建一个空的工作目录（比如goose-demo），进入该目录运行goose session。会话（session）就是你与 Goose 的一段连续对话。
3. 下第一个任务：像跟开发者口头交代任务那样说，例如："用 JavaScript 做一个浏览器可玩的井字棋，玩家对战一个 bot"。Goose 会先给出计划，再动手写码，完成后目录里就会出现 HTML 页面和 JS 文件。

让 Goose 开发井字棋，并替你打开浏览器

一句话结论：Goose 最有价值的闭环是"生成代码 → 验证能跑 → 收尾工作也交给它"，其中"替你打开浏览器"这一步靠内置的Computer Controller扩展完成。

井字棋生成后，不必自己找文件再拖进浏览器。先在扩展面板启用 Computer Controller（桌面版：侧边栏Extensions中打开对应开关；CLI：按Ctrl+C退出会话后运行goose configure，选择Add Extension > Built-in Extension > Computer Controller，超时设为 300 秒），再用goose session -r恢复刚才的会话，然后对它说："open the tic-tac-toe game in a browser"。它会在默认浏览器中打开游戏页面，整个过程你不需要碰鼠标。

这个扩展同时还提供网页抓取、文件缓存等能力，是 Goose 从"写代码"走向"操作你的电脑"的入口，文档见 Computer Controller 扩展。

🔌 扩展能力边界：启用 70+ 个 MCP 扩展

一句话结论：内置工具不够用时，加扩展——内置的 Developer 扩展（默认启用）提供通用开发工具，外部生态还有 70+ 个 MCP 服务器可选。

• 内置扩展：Developer（开发工具，默认开）、Computer Controller（电脑控制）、Memory（记住你的偏好）、Auto Visualiser（对话中自动生成图表）等，可在桌面版侧边栏或goose configure中开关；
• 外部扩展：GitHub、PostgreSQL、Netlify、Vercel、Figma、Google Drive 等都在官方目录里，完整清单见 MCP 服务器文档目录；
• 安装方式：桌面版在扩展面板中直接搜索安装；CLI 运行goose configure→Add Extension浏览目录，若已知扩展名也可直接运行goose mcp {name}；
• 安全机制：外部扩展在激活前会被自动扫描已知恶意包，命中即阻止并给出明确报错。

🪿 常见问题：避坑清单与进阶路径

一句话结论：动手做进阶配置之前，先确认下面四个高频问题，能避开新手绝大多数弯路。

1. Goose 会不会不经过我就执行命令？会。它默认自主运行，配合默认开启的 Developer 扩展可以执行命令、改文件。想收紧权限，请阅读 developer-mcp 的访问控制配置，设置权限模式让高危操作先向你确认。
2. 没有 API Key 能用吗？可以。Ollama、LM Studio 等本地模型提供商先在本地下载并运行模型，再在 Goose 中指向它即可；各提供商需要的环境变量全部列在 提供商文档 中。
3. Windows 装完提示找不到 goose？安装后若出现 PATH 警告，需先把 goose 加入 PATH 再运行goose configure；若提示 keyring 错误，选择"不存储到 keyring"即可，细节见 Windows 安装说明。
4. 会话可以接着聊吗？可以。goose session开新会话，goose session -r恢复最近一次；更多管理操作（切换、导出）见 会话管理文档。

进阶路线：需要定时或批量执行任务时，看 任务运行指南；想让 Goose 在每次会话中记住你的项目约定，研究 goosehints 机制（使用 goosehints）。

【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goose