goose 安装指南：15 分钟跑通 AI 智能体的第一次会话-开发者社区

goose 安装指南：15 分钟跑通 AI 智能体的第一次会话

【免费下载链接】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 智能体，能写代码、跑测试、操作文件，还能接上浏览器——并且完成你的第一次会话：让 goose 现场生成一个小游戏。全程只需要三条命令：装、配、开聊。它支持 15+ 家 LLM 提供商（Anthropic、OpenAI、Google、Ollama 等），还内置 MCP 扩展生态。

🧭 先看清自己的用法：装哪个版本

goose 有三个入口：CLI（终端）、Desktop（图形应用）、API。前两个共享同一份配置，密钥配一次，两边通用。对号入座：

你平时在哪干活	推荐路径	一句话理由
常挂服务器 / 天天泡终端	装 CLI	脚本一条命令搞定，能进 CI 流水线
不太碰终端，想要界面感	装 Desktop	双击启动，欢迎页里点选完成配置
主要想接 MCP 工具扩展	先装 CLI	命令行里加扩展最顺手，桌面版后补即可

三条路径共享配置，所以不会选错。我的建议：先装 CLI 跑通，Desktop 什么时候想要什么时候加——这样能最快确认环境没问题。

📦 各系统的安装命令与验证

macOS / Linux / WSL：一条命令走完

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

脚本把最新稳定版装到~/.local/bin，跑完自动带你进配置界面。新终端窗口执行：

goose --version

打印出版本号即安装成功；再跑which goose，输出应是~/.local/bin/goose。CI 或写自动化脚本时不想被交互界面卡住，命令末尾加CONFIGURE=false。macOS 用户用 Homebrew 也行：brew install block-goose-cli，更新都归它管。脚本源码就在仓库根目录的 download_cli.sh。

Windows：Git Bash 优先

装好 Git for Windows 后打开 Git Bash，跑和上面完全相同的 curl 命令。偏爱 PowerShell 的话分两步：

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1" .\download_cli.ps1

只想要桌面应用的话按系统走三步：

系统	操作	装好的信号
macOS	`brew install --cask block-goose`	程序坞出现 goose 图标
Linux（Debian/Ubuntu）	`sudo dpkg -i goose-desktop_*.deb`	应用菜单能启动 Goose
Windows	解压官方 zip，双击`goose.exe`	弹出欢迎配置页

第一次会话：输入这条就算进门了

goose session

出现对话界面、能打字回车，说明 CLI 链路已通。到这里就算"装好了"，剩下的是接大脑。

🧠 给 goose 接上大脑：密钥与模型

最短路径就是安装脚本自动带你走的那套：选提供商（Anthropic、OpenAI、Google、Ollama 等 15+ 家任选）→ 粘贴 API 密钥 → 从列表挑一个模型。中途想改，随时goose configure→Configure Providers重进菜单。

配置成功的标志只有一句：屏幕底部出现Configuration saved successfully。Desktop 用户在欢迎页选提供商、浏览器里完成授权即可，效果相同；完整提供商列表见提供商文档。

不想在界面里存密钥？环境变量是等价写法：

export OPENAI_API_KEY=你的密钥

再跑一次goose configure，它会显示OPENAI_API_KEY is set via environment variable，表示已识别。想跨会话生效，把 export 追加进~/.bashrc再source一次。

🕹️ 第一件真事：让 goose 写个能玩的游戏

配置好了，进一个空目录：

mkdir goose-demo && cd goose-demo goose session

像跟同事布置任务一样输入：

写一个可以在浏览器玩的五子棋，单个 HTML 文件，我和电脑对战

它会先给一份简短计划再动手写文件。完成后目录里多出一个 HTML 文件，浏览器打开就能落子——能玩起来，说明从配置到执行整条链路都是通的。

想让它替你打开浏览器？goose configure→Add Extension→Built-in Extension→Computer Controller，然后用goose session -r恢复会话，对它说"在浏览器里打开这个游戏"。goose 靠 MCP 协议接外部工具，官方生态里有 70+ 现成扩展，教程见使用扩展。

🛠️ 排错速查表

现象	原因	一条修复命令
`goose: command not found`	`~/.local/bin`没进 PATH	`echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc`（Windows 手动把`%USERPROFILE%\.local\bin`加入系统 PATH）
下载时报`bzip2: (unknown member)`	缺解压工具	`sudo apt update && sudo apt install bzip2 -y`
Windows 配密钥时报 keyring 错误	系统钥匙串不可用	配置时选"不存入 keyring"，改用`export OPENAI_API_KEY=你的密钥`
macOS 桌面版点开没窗口	`~/.config`缺读写权限	给`~/.config`授予读写权限，步骤见已知问题
提示连不上 Ollama	Ollama 没启动或未拉取模型	`ollama pull qwen2.5`
会话卡死 / 无响应	长会话陷入循环	`Ctrl+C`中断，重新`goose session`