5 分钟上手 goose
goose 是一个可扩展的开源 AI 代理,通过自动化编码任务来增强你的软件开发。
这篇快速教程将带你完成:
- ✅ 安装 goose
- ✅ 配置 LLM
- ✅ 做一个小应用
- ✅ 添加 MCP 服务器
开始吧 🚀
安装 goose
桌面版和 CLI 请从中文社区下载页获取。
- macOS
- Linux
- Windows
选择安装 goose 的桌面版和/或 CLI:
选择安装 goose 的桌面版和/或 CLI:
- goose Desktop
- goose CLI
选择安装 goose 的桌面版和/或 CLI:
- goose Desktop
- goose CLI
点下面的按钮下载 Windows 版 goose 桌面应用:
- 解压下载的 zip 文件。
- 运行可执行文件以启动 goose 桌面应用。
从中文社区下载页获取 Windows 上的 goose CLI。
上游官方安装方式
下面的命令安装的是上游项目,不是中文社区构建。
在 Git Bash、MSYS2 或 PowerShell 中运行以下命令,在 Windows 上原生安装 goose CLI:
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
前提条件见安装指南。
如果安装后看到 PATH 警告,需要先把 goose 加入 PATH,再运行 goose configure。详细步骤见 Windows CLI 安装说明。
如果配置过程中出现提示,请选择不要存入密钥环。如果遇到密钥环错误,更多信息见 Windows 设置说明。
配置提供商
goose 使用受支持的 LLM 提供商,由它们提供 goose 理解你的请求所需的 AI 能力。首次使用时,系统会提示你配置偏好的提供商。
- goose Desktop
- goose CLI
在欢迎屏幕上,你有这些选项:
- 用 API 密钥快速设置 — goose 会根据 API 密钥自动配置提供商
- ChatGPT Subscription — 使用 ChatGPT Plus/Pro 登录,以使用 GPT-5 Codex 模型
- Agent Router by Tetrate — 一次设置即可使用多个 AI 模型
- OpenRouter — 用一个 API 按量使用 200 多个模型
- 其他提供商 — 在设置里手动配置其他提供商
在本快速开始中,选择 Agent Router by Tetrate。Tetrate 提供多个 AI 模型的访问,并带有内置速率限制和自动故障转移。关于其他提供商的更多信息,见配置 LLM 提供商。
goose 会打开浏览器,让你向 Tetrate 进行身份验证;如果还没有账户,可以创建一个。回到 goose 桌面应用后,就可以开始第一次会话。
第一次通过 goose 自动向 Tetrate 进行身份验证时,你会获得 10 美元免费额度。新用户和现有 Tetrate 用户都可以获得此优惠。
- 在终端中运行以下命令:
goose configure
- 从菜单中选择
Configure Providers并按 Enter。
┌ goose-configure
│
◆ What would you like to configure?
│ ● Configure Providers (Change provider or update credentials)
│ ○ Add Extension
│ ○ Toggle Extensions
│ ○ Remove Extension
│ ○ goose settings
└
- 选择模型提供商。在本快速开始中,选择
Tetrate Agent Router Service并按 Enter。Tetrate 提供多个 AI 模型的访问,并带有内置速率限制和自动故障转移。关于其他提供商的信息,见配置 LLM 提供商。
┌ goose-configure
│
◇ What would you like to configure?
│ Configure Providers
│
◆ Which model provider should we use?
│ ○ Amazon Bedrock
│ ○ Amazon SageMaker TGI
│ ○ Anthropic
│ ○ Azure OpenAI
│ ○ ChatGPT Codex
│ ○ Claude Code CLI
│ ○ ...
| ● Tetrate Agent Router Service (Enterprise router for AI models)
│ ○ ...
└
第一次通过 goose 自动向 Tetrate 进行身份验证时,你会获得 10 美元免费额度。新用户和现有 Tetrate 用户都可以获得此优惠。
- 在提示时输入 API 密钥(以及任何其他配置细节)。
┌ goose-configure
│
◇ What would you like to configure?
│ Configure Providers
│
◇ Which model provider should we use?
│ Tetrate Agent Router Service
│
◆ Provider Tetrate Agent Router Service requires TETRATE_API_KEY, please enter a value
│ ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪
└
GitHub Copilot 不使用 API 密钥。配置过程中会生成一个身份验证码。要生成该码,请选择 GitHub Copilot 作为提供商。身份验证码会复制到剪贴板,并打开浏览器窗口,你可以在其中粘贴以完成身份验证。
更多细节见 GitHub Copilot 身份验证。
- 选择或搜索你想使用的模型。
│
◇ Model fetch complete
│
◆ Select a model:
│ ○ Search all models...
│ ○ gemini-2.5-pro
│ ○ gemini-2.0-flash
| ○ gemini-2.0-flash-lite
│ ● gpt-5 (Recommended)
| ○ gpt-5-mini
| ○ gpt-5-nano
| ○ gpt-4.1
│
◓ Checking your configuration...
└ Configuration saved successfully
开始会话
会话是你与 goose 之间单次、连续的对话。让我们开始一个。
- goose Desktop
- goose CLI
选择 LLM 提供商后,点击侧边栏中的 Home 按钮。
把问题、任务或指令直接输入输入框,goose 会立刻开始工作。
- 创建一个空目录(例如
goose-demo),并在终端中进入该目录。 - 要开始新会话,运行:
goose session
编写提示
在提示中,你可以像跟开发者说话一样输入指令,与 goose 交互。
让我们请 goose 做一个井字棋游戏!
create an interactive browser-based tic-tac-toe game in javascript where a player competes against a bot
goose 会制定计划,然后立刻着手实现。完成后,你的目录里应有一个 JavaScript 文件,以及一个用来玩游戏的 HTML 页面。
启用扩展
你可以手动进入工作目录并在浏览器中打开 HTML 文件,但如果让 goose 来做会更好。让我们启用 Computer Controller 扩展,赋予 goose 打开网页浏览器的能力。
- goose Desktop
- goose CLI
- 点击左上角的 按钮打开侧边栏。
- 在侧边栏菜单中点击
Extensions。 - 打开
Computer Controller扩展的开关以启用它。该扩展支持网页抓取、文件缓存和自动化。 - 返回会话继续。
- 既然 goose 已具备浏览器能力,让它在浏览器中启动你的游戏:
- 输入
Ctrl+C结束当前会话,以便回到终端命令提示符。 - 运行配置命令
goose configure
- 选择
Add Extension>Built-in Extension>Computer Controller,并把超时设为 300 秒。该扩展支持网页抓取、文件缓存和自动化。
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Built-in Extension
│
◇ Which built-in extension would you like to enable?
│ Computer Controller
│
◇ Please set the timeout for this tool (in secs):
│ 300
│
└ Enabled computercontroller extension
- 既然 goose 已具备浏览器能力,恢复上一次会话:
goose session -r
- 让 goose 在浏览器中启动你的游戏:
open the tic-tac-toe game in a browser
去玩你的游戏吧,我知道你想玩 😂 ……祝你好运!
后续步骤
恭喜,你已经成功用 goose 开发了一个 Web 应用!🎉
接下来可以试试: