跳到主要内容

安装 goose

桌面版和 CLI 请从中文社区下载页获取。

选择安装 goose 的桌面版和/或 CLI：

从浏览器直接安装 goose 桌面版。

方式一：下载安装

点下面的按钮下载 macOS 版 goose 桌面应用：

macOS Silicon macOS Intel
  1. 解压下载的 zip 文件。
  2. 运行可执行文件以启动 goose 桌面应用。
更新 goose

最好定期更新 goose。

上游官方安装方式

下面的方式安装的是上游项目，不是中文社区构建。

Homebrew 会下载同一应用，也可以负责更新。

brew install --cask block-goose
权限

如果你使用 Apple Mac M3，且 goose 桌面应用启动后没有窗口，请检查并更新以下内容：

确保 ~/.config 目录具有读写权限。

goose 需要此权限来创建日志目录和文件。授予权限后，应用应能正确加载。具体步骤见已知问题指南。

设置 LLM 提供商​

goose 使用受支持的 LLM 提供商，由它们提供 goose 理解你的请求所需的 AI 能力。首次使用时，系统会提示你配置偏好的提供商。

第一次打开 goose 时，在欢迎屏幕上选择如何配置提供商：

  • 用 API 密钥快速设置 — goose 会根据 API 密钥自动配置提供商
  • ChatGPT Subscription — 使用 ChatGPT Plus/Pro 登录，以使用 GPT-5 Codex 模型
  • Agent Router by Tetrate — 一次设置即可使用多个 AI 模型
  • OpenRouter — 用一个 API 按量使用 200 多个模型
  • 其他提供商 — 在设置里手动配置其他提供商
提示

goose 很依赖工具调用能力，目前和 Claude 4 系列模型配合得最好。

免费额度

第一次通过 goose 自动向 Tetrate 进行身份验证时，你会获得 10 美元免费额度。新用户和现有 Tetrate 用户都可以获得此优惠。

更新提供商​

你可以随时更改 LLM 提供商和/或模型，或更新 API 密钥。

  1. 点击左上角的 按钮打开侧边栏。
  2. 在侧边栏中点击 Settings 按钮。
  3. 点击 Models 选项卡。
  4. 选择更新提供商、切换模型，或点击 Reset Provider and Model 清除设置并返回欢迎屏幕。这些配置选项的细节见相应文档。
计费
Google Gemini 提供可以起步的免费额度。否则，你需要确保 LLM 提供商账户里有可用额度，请求才能成功。

有些提供商还会限制 API 调用频率，这会影响使用体验。可以看我们的 处理速率限制 指南，了解使用 goose 时如何应对这些限制。

运行 goose​

在 goose 桌面版中开始会话很直接。选择提供商后，你会看到准备就绪的会话界面。

把问题、任务或指令直接输入输入框，goose 会立刻开始工作。

共享配置​

goose CLI 和桌面 UI 共享所有核心配置，包括 LLM 提供商设置、模型选择和扩展配置。在任一界面安装或配置扩展时，设置会存储在中心位置，桌面应用和 CLI 都可以使用。这样在界面之间切换时仍能保持一致的设置。更多信息见配置文件指南。

信息

虽然核心配置在界面之间共享，扩展在存储身份验证凭据的方式上有灵活性。有些扩展使用共享配置文件，另一些则实现自己的存储方法。

通过以下方式进入共享配置：

  1. 点击左上角的 按钮打开侧边栏。
  2. 在侧边栏中点击 Settings 按钮。

在 CI/CD 中固定 goose 版本​

在 CI/CD（以及其他自动化、非交互环境）中，用 GOOSE_VERSION 固定特定版本，使安装可复现，并避免在 stable 发布标签不包含 goose CLI 二进制资源时下载出现 404。

完整示例和用法见 CI/CD 环境。

为 Linux 发行版生成 man 手册页​

如果你在为 Linux 发行版打包 goose，或创建自定义构建，可以从 CLI 命令定义生成 Unix man 手册页：

just generate-manpages

这会在 target/man/ 中创建 ROFF 格式的手册页（例如 goose.1、goose-session.1），可以安装到 /usr/share/man/man1/，以便通过 man 命令提供离线文档。

生成手册页需要 goose 源码仓库，面向为 Fedora、Debian 和其他 Linux 发行版准备软件包的发行版打包者。实现细节见 generate_manpages.rs 源码。

更多资源​

你也可以配置扩展来扩展 goose 的功能，包括添加新扩展或打开/关闭它们。详细说明见使用扩展指南。