Goose 本地部署快速上手教程：10 分钟从零跑通第一个 AI Agent 开发任务-育师

Goose 本地部署快速上手教程：10 分钟从零跑通第一个 AI Agent 开发任务

【免费下载链接】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 是一个用 Rust 编写的开源 AI 智能体，跑在你自己的机器上，能自己规划、写代码、执行命令并测试验证。跟着这篇实操教程走完，你会在本机装好 goose CLI、接通 LLM 提供商，并跑通一个真实的写码任务，全程约 10 分钟。

先拿到结果

三条安装路线先选一条，后面都以 CLI 为主线：

路线	适用人群	耗时	典型场景
安装脚本装 CLI	终端党、脚本与 CI	5 分钟	日常开发、批量任务
桌面应用	非命令行用户	5 分钟	可视化操作、管理会话
源码构建	要改代码的人	30 分钟起	二次开发、定制发行版

桌面版从安装文档下载对应平台安装包，解压即运行；Debian/Ubuntu 也可用sudo dpkg -i装 .deb 包。

一条命令安装 CLI 二进制

仓库根目录自带安装脚本download_cli.sh，它自动识别系统架构（x86_64 / arm64），把二进制装到~/.local/bin。先克隆仓库再执行它：

git clone https://gitcode.com/GitHub_Trending/goose3/goose cd goose bash download_cli.sh

Windows 在 Git Bash 或 WSL 里跑同一个脚本。要固定版本可设GOOSE_VERSION=v1.0.25，跳过交互配置加CONFIGURE=false。需要改代码才走源码路线：装好 Rust 工具链后执行cargo build --release -p goose-cli --bin goose，产物直接当 CLI 用。

💡 脚本默认跑完会自动进入交互式配置向导，第一次安装不用单独再配。

冒烟测试：空目录开一个会话

新建一个空目录并进入，Goose 会把它当作工作目录，所有文件操作都发生在这里：

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

输入一句最简单的话，例如"用一句话介绍你自己"。能收到回复、退出正常，说明安装与提供商连接都通了，冒烟测试结束（Ctrl+C退出会话）。

补齐必要配置

冒烟测试只证明"能说话"，这里把模型和密钥配到位。

交互式向导设置模型提供商

在终端运行配置命令，按向导选：Configure Providers→ 选提供商 → 填 API Key → 选模型，全程约 2 分钟：

goose configure

goose 支持 15+ 家提供商（OpenAI、Anthropic、Google、Ollama、OpenRouter、Azure、Bedrock 等），每家的环境变量名清单见提供商文档。

⚠️ 云端提供商按 token 计费；本机装了 Ollama 的话，选 Ollama 提供商走本地模型，不花 API 费用，但需先ollama pull下载模型。

不想用向导时，也可以直接预置环境变量（例如先export OPENAI_API_KEY=...再开会话），适合写进 CI 或启动脚本。向导结束前会自动做配置校验，看到 "Configuration saved successfully" 即表示密钥有效。

用真实任务验收：让 Goose 写一个能玩的游戏

回到刚才的goose-demo目录，运行goose session开会话，输入这段自然语言：

用 JavaScript 写一个浏览器里能玩的井字棋，玩家对战一个 AI 机器人，单 HTML 文件加一个 JS 文件即可。

预期结果：Goose 先输出计划，然后逐个创建文件（一个 HTML 页面 + 一个 JS 文件），完成后你可以直接用浏览器打开页面验证：下三子能连线、AI 会落子。这就是部署成功的验收标准。

带着上下文继续改

退出会话后，用下面命令恢复上一次会话，之前创建的每个文件它都记得：

goose session -r

接着说"给棋盘加一个重置按钮和胜负计数"即可，它会直接在已有代码上改，不用重新交代背景。想要更多能力（浏览器控制、文件自动化）时，可在goose configure里加内置扩展 Computer Controller（超时建议填 300 秒），它基于 MCP 开放标准，goose 总共能接 70+ 扩展，详见 MCP 文档。

出问题了怎么办

症状	可能原因	处理
`goose: command not found`	`~/.local/bin`不在 PATH	shell 配置里加`export PATH="$HOME/.local/bin:$PATH"`，重开终端
Windows 装完提示 PATH 警告	安装目录未加入 PATH	按安装文档手动加 PATH 后再跑`goose configure`
Apple M 芯片桌面版启动无窗口	`~/.config`无读写权限	给该目录授予读写权限后重启应用
调模型频繁 401 或超时	密钥失效或网络不通	重新`goose configure`验证密钥，检查代理设置
装完跑配置卡在交互菜单	脚本默认带交互配置	用`CONFIGURE=false bash download_cli.sh`重装后再单独配置