Goose 本地部署完整指南15 分钟安装 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/gooseGoose 是一个跑在你自己电脑上的开源 AI 智能体你用自然语言下任务它自己规划、写代码、执行命令、跑测试直到干完为止。这篇 Goose 本地部署教程带你走完装好 → 接上模型 → 让干完第一件活的全过程跟着敲命令就行。问题一Goose 一分钟装好我该怎么装先花 10 秒对号入座选错路线后面都费劲你的情况选这个理由平时不碰终端想要可视化界面桌面版解压即用图形界面管会话终端党、想写脚本或进 CICLI一条命令装好本文主线要改源码、做定制发行版源码构建用 Rust 编译出二进制CLI一条命令装好安装脚本就在仓库根目录的download_cli.sh会自动识别你的系统架构x86_64 / arm64并把二进制装到~/.local/bingit clone https://gitcode.com/GitHub_Trending/goose3/goose cd goose bash download_cli.sh 小贴士CI 或批量部署时用CONFIGUREfalse bash download_cli.sh跳过交互配置想锁版本就设GOOSE_VERSIONv1.0.25。Windows 在 Git Bash 或 WSL 里跑同样的脚本。桌面版下载即开macOS / Linux / Windows 都有对应安装包下载解压直接运行即可Debian/Ubuntu 用户拿到 .deb 包后sudo dpkg -i 包名.deb也行。细节看 安装指南。源码构建仅当你想改代码时装好 Rust 工具链后执行cargo build --release -p goose-cli --bin goose编译产物就是 CLI 本体。问题二Goose 没有大脑模型从哪里来Goose 本身不带模型需要你给它接一个 LLM 提供商。它支持 OpenAI、Anthropic、Google、Ollama、OpenRouter 等 15 家完整清单和环境变量见 提供商文档。两条路线按预算二选一路线成本适合谁API KeyOpenAI / Anthropic 等按 token 付费想要最强模型效果Ollama 本地模型免费本机有显卡、不想花一分钱API Key 路线三步接好goose configure向导里依次选Configure Providers→ 选提供商 → 填 API Key → 选一个模型完成。也习惯在 shell 里预置密钥的先export OPENAI_API_KEY你的密钥再启动会话即可方便写进 CI 脚本。零成本路线本地 Ollama本机装了 Ollama 的话直接在配置向导里选 Ollama挑一个已拉取的本地模型。代码和数据都留在自己机器上一分钱不花代价是模型能力弱一些——先拿小任务试水很合适。问题三第一个真实任务怎么让 Goose 真的干活关键认知Goose 把你启动会话的目录当作它的工作区所有文件操作都发生在这里。所以永远先建好目录再进会话mkdir goose-demo cd goose-demo goose session⚠️ 注意Goose 会真实执行命令、真实改文件。只在你愿意让它动的项目目录里开会话。像跟同事交代需求一样说人话比如用 JavaScript 写一个浏览器井字棋玩家对战 AI写完自测一下。 它会先给计划再逐个建文件、跑验证。干完活后想接着改不用重头再来goose session -r带着完整上下文继续直接说给棋盘加个重置按钮就行。问题四只会写代码用 MCP 给它装上手和眼写好的游戏还得你手动开浏览器验证这一步正该交给它。Goose 通过 MCPModel Context Protocol开放标准接入 70 扩展内置的 Computer Controller 就自带浏览器控制、网页抓取、文件缓存等工具goose configure选Add Extension→Built-in Extension→Computer Controller超时填 300 秒。然后goose session -r回会话里说在浏览器里打开这个游戏它自己就干了。更多第三方服务器按名称在 MCP 文档 里查操作方式见 扩展使用指南。⚠️ 注意Goose 执行敏感操作前会向你申请授权接入陌生扩展前建议先审查它有哪些工具、能碰哪些目录配置思路见 Computer Controller 文档。问题五新手必踩的坑一张表查完症状可能原因你怎么处理goose: command not found~/.local/bin不在 PATHshell 配置里加export PATH$HOME/.local/bin:$PATH重开终端Windows 装完报 PATH 警告安装目录未进 PATH按 安装指南 手动添加后再跑goose configureApple M3 桌面版点开无窗口~/.config无读写权限给该目录授予读写权限后重启见 已知问题调模型频繁 401 / 超时密钥失效或网络不通重新goose configure验证密钥检查代理设置扩展动作卡住或超时工具超时值太小重新配置该扩展把超时调大到 300 秒跑通之后4 个让你越用越顺手的动作喂它一份 goosehints在项目里放提示词文件让它记住你的技术栈和代码规范写法看 goosehints 指南按需多开扩展goose configure的扩展列表里挑着开别一次全开保持版本新定期跑goose update把成功会话沉淀成 recipe验证过的流程写成可复用配方团队共享玩法见 教程目录从零到跑通全程不到 15 分钟。剩下的时间就交给那只替你干活的鹅吧 【免费下载链接】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），仅供参考