Goose 本地部署快速指南10 分钟完成你的第一个 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/gooseGoose 是跑在你电脑上的开源 AI 智能体。你描述任务它自己规划、写代码、执行命令并自测还能接入 15 模型供应商和 70 MCP 扩展。本文带你走四步完成 Goose 本地部署装好 CLI、接入模型、跑完第一个会话、开启浏览器控制。先选形态桌面、CLI 还是 APIGoose 用 Rust 编写提供三种形态同一套能力形态适合谁典型用法桌面应用日常办公、非命令行用户可视化建会话、管理历史CLI开发者、脚本与 CI终端工作流、批量任务API要把智能体嵌进自己产品的人通过 SDK 调用三个平台 macOS / Linux / Windows 都支持协议开源Apache-2.0。本文走 CLI 路线。第一步5 步装好 Goose CLI仓库根目录自带安装脚本自动识别架构x86_64 / arm64把二进制放进~/.local/bin。克隆仓库后执行git clone https://gitcode.com/GitHub_Trending/goose3/goose cd goose bash download_cli.sh装完运行goose --version看到版本号即算成功。 自动化部署可跳过交互配置CONFIGUREfalse bash download_cli.sh固定版本则设GOOSE_VERSIONv1.0.25。需要改代码或做定制发行版装好 Rust 工具链后执行cargo build --release -p goose-cli --bin goose产物可直接当 CLI 用。更多细节见安装文档。第二步用 goose configure 接入 LLM 供应商Goose 不自带模型需要外接一个供应商完整清单见提供商列表goose configure向导里依次选Configure Providers→ 选供应商 → 填 API Key → 选模型。看到Configuration saved successfully即可开干。不想进向导也有替代方案在 shell 里先export OPENAI_API_KEY...再启动会话Goose 会自动读取适合写进 CI 或启动脚本。本机装了 Ollama 的话选该供应商用本地模型不花 API 费用。第三步跑通第一个任务——让 Goose 写个能玩的小程序⚠️ Goose 会真实执行命令、改写当前目录的文件。永远在你愿意让它动手的目录里开会话。新建一个空目录作为工作区再启动会话mkdir goose-demo cd goose-demo goose session输入一句自然语言需求「用 JavaScript 写一个井字棋玩家对战 AI」。Goose 先输出计划再逐个创建文件并自测。结束后目录里会多出 HTML 页面和 JS 文件浏览器打开 HTML 就能对局看到棋盘可点击即算跑通。想接着改就用-r恢复最近会话上下文完整保留goose session -r继续说「加个计分板」它会基于原代码修改而不是重写。给 Goose 装上浏览器能力启用 MCP 扩展手动开浏览器验证太麻烦让 Goose 自己来。它基于 MCP 开放标准接入外部工具70 扩展可选用法见扩展文档。内置的几个扩展干什么用Developer默认开跑命令、读写文件等开发工具Computer Controller浏览器控制、抓取网页、文件缓存Memory记住你的偏好Auto Visualiser会话中自动生成图表Tutorial交互式教程已知扩展名时一条命令直接启用goose mcp computercontroller或在goose configure里走Add Extension→Built-In Extension超时填 300 秒。看到Enabled computercontroller extension表示连接成功。回到会话说「在浏览器里打开这个游戏」它会自己执行。Goose 本地部署踩坑排查症状原因处理goose: command not found~/.local/bin不在 PATHshell 配置加export PATH$HOME/.local/bin:$PATH重开终端M3 Mac 桌面版无窗口~/.config无读写权限授予该目录读写权限后重启应用Windows 安装后 PATH 警告安装目录未登记先补 PATH 再跑goose configurekeyring 提示选「不存储」调模型 401 / 超时密钥失效或代理不通重新goose configure验证密钥检查代理设置Ollama 选不到模型本地服务未起或没下模型先ollama pull模型并确认服务在跑跑通之后再做这 4 件事在项目根目录放一份 goosehints 文件写明技术栈与代码规范Goose 每次会话都会遵守按需再开几个扩展GitHub、文件系统、数据库按需勾选定期执行goose update保持版本最新把一次成功会话的提示沉淀成 recipe发给团队复用官方还有 quickstart 可对照复跑。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
