Goose 使用教程

📖 项目简介

Goose 是一个开源通用 AI Agent，由 Linux 基金会旗下的 Agentic AI Foundation (AAIF) 维护。它不只是写代码的工具——研究、写作、自动化、数据分析，什么都能干。

提供原生桌面应用（macOS/Linux/Windows）、命令行 CLI 和 API 三种使用方式，使用 Rust 编写，性能极强。支持 15+ LLM 供应商，包括 Anthropic、OpenAI、Google、Ollama 等，还能直接使用你的 ChatGPT Plus、Claude Pro 订阅。通过 MCP 协议连接 70+ 扩展，功能无限扩展。

💡

GitHub 地址： https://github.com/aaif-goose/goose
官方文档： https://goose-docs.ai/

✨ 核心亮点

🤖

15+ 大模型支持

Anthropic、OpenAI、Google、Ollama、OpenRouter、Azure 等随意切换

🔌

70+ MCP 扩展

GitHub、Slack、数据库、浏览器等扩展即插即用

🖥️

全平台支持

桌面端、CLI、API 三种使用方式，macOS/Linux/Windows 全覆盖

🦀

Rust 编写

高性能、低资源占用，启动秒级响应

📋

Recipe 工作流

将常用任务定义为 YAML 配方，团队共享复用

🔒

安全可控

注入检测、权限控制、沙箱模式、对抗审查

🚀 安装方式

方式一：桌面应用（推荐新手）

下载桌面应用

访问官方安装页面，下载对应平台的安装包（macOS / Linux / Windows）。

配置 LLM 供应商

首次启动后，选择你要使用的 LLM 供应商。可以用 API Key，也可以直接用你现有的 ChatGPT Plus、Claude Pro 或 Gemini 订阅（通过 ACP 协议）。

开始使用

在对话框中输入你的任务，Goose 会自动规划、执行、验证，全程零干预。

方式二：CLI 命令行安装

                bash
                # macOS / Linux
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

# macOS (Homebrew)
brew install --cask block-goose
            

⚠️

Windows 用户：推荐下载桌面应用。CLI 版本也支持 Windows，可从 GitHub Releases 页面下载。

💡 基础使用

CLI 常用命令

                bash
                # 启动新会话
goose session

# 配置供应商和扩展
goose configure

# 使用 Recipe 执行任务
goose run --recipe my-recipe.yaml

# 查看帮助
goose --help
            

使用场景示例

写代码："帮我用 Python 写一个 REST API 服务"
修 Bug："分析这个错误日志并修复问题"
自动化："每天自动备份数据库到 S3"
研究："调研 2026 年最流行的 AI Agent 框架并生成对比报告"
GitHub 操作："帮我审查这个 PR 并提出修改建议"

配置扩展

Goose 通过 MCP 协议连接各种工具和服务。在设置中启用你需要的扩展：

Developer 扩展：Shell 命令、文件编辑、代码分析
GitHub 扩展：PR、Issue、代码审查
Memory 扩展：跨会话持久化记忆
Computer Controller：系统自动化、网页抓取

✅

扩展市场：访问 goose-docs.ai/extensions 浏览全部 70+ 扩展。

⚙️ 配置说明

Goose 的配置文件存储在 ~/.config/goose/ 目录下：

profiles.yaml — 供应商和扩展配置
config.yaml — 全局偏好设置

项目级别的定制可以通过根目录的 .goosehints 或 AGENTS.md 文件来实现，让 Goose 了解你的项目上下文。

❓ 常见问题

Q: Goose 和 Claude Code / Cursor 有什么区别？

Goose 是完全开源免费的，不绑定任何特定 LLM 供应商。你可以自由选择 15+ 大模型供应商，还能用自己的订阅。Claude Code 需要付费使用 Anthropic API，而 Goose 甚至可以用本地的 Ollama 模型完全离线运行。

Q: 支持哪些大模型？

支持 Anthropic (Claude)、OpenAI (GPT)、Google (Gemini)、Meta (Llama)、Ollama（本地模型）、OpenRouter、Azure、AWS Bedrock 等 15+ 供应商。你可以随时切换，不受绑定。

Q: 需要编程基础吗？

不需要！桌面应用提供了图形化界面，像聊天一样用自然语言描述你的需求即可。当然，如果你是开发者，CLI 和 API 模式会给你更强的控制力。

Q: 数据安全吗？

Goose 运行在你的本地机器上，代码和数据不会上传到任何第三方服务器。内置注入检测、权限控制和沙箱模式，安全性有保障。如果使用 Ollama 等本地模型，可以完全离线运行。