企业官网建设流程全解析

Goose 本地部署指南：5 分钟接入 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 分钟。读完你会在本机拥有可用的 Goose，并让它真实交付一个开发任务。

安装前快速自检：3 分钟确认环境

目标：确认你的机器满足运行条件，避免装到一半卡住。

• 系统：macOS、Linux（含 WSL）或 Windows（Git Bash / MSYS2 / PowerShell 任选其一）。
• 网络：需能访问你选择的 LLM 提供商 API；国内网络不稳时先确认代理可用。
• 模型来源，二选一：云 API 密钥（OpenAI、Anthropic、Google 等），或本机已装好 Ollama 的本地模型。
• 工具链：安装脚本依赖curl和tar，macOS 与 Linux 系统自带，Windows 用 Git Bash 也齐备。

怎么算成功：三项条件全部成立，进入下一步。若走本地模型路线，先执行ollama --version确认已安装。更多细节可查 安装文档。

装进本机的三条路线：桌面版、CLI 脚本与源码构建

本文走CLI 路线，终端工作流最通用。源码构建只提一句：装好 Rust 工具链后执行cargo build --release -p goose-cli --bin goose，产物即 CLI，源码在 crates/goose-cli/。

安装脚本就在仓库根目录的 download_cli.sh，它自动识别 x86_64 / arm64 架构，把二进制装到~/.local/bin（Windows 为%USERPROFILE%\goose）：

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

作用：下载当前 stable 版二进制并直接拉起配置向导，装完即可用。

goose --version

作用：验证命令已进 PATH 并打印版本号，这就是本步的验收标准。

💡 自动化或 CI 场景加CONFIGURE=false跳过交互配置；要固定版本就设GOOSE_VERSION=v1.0.25，避免 stable 标签变动导致 404。

让模型第一次应答：向导与环境变量两种写法

目标：完成 LLM 接入，让 Goose 的第一次推理真正出结果。

方式一，交互式向导：

goose configure

进入后依次选Configure Providers→ 提供商（如 OpenAI）→ 粘贴 API Key → 模型名（如gpt-4o）。15+ 家提供商及各自所需环境变量的完整清单见 提供商文档。

方式二，环境变量直连：

export OPENAI_API_KEY=你的密钥 goose session

作用：会话启动时 Goose 检测到密钥会自动完成该提供商配置，适合写进启动脚本或 CI。选型提示：个人日常用向导，密钥随存随取；脚本化、多会话复用同一密钥，用环境变量。两种方式最终写入同一份全局配置，桌面版与 CLI 共享（见 配置文件指南）。

💡 选 Ollama 作提供商即可用本地模型，不花 API 费用；向导里选模型前先用ollama pull把模型拉下来。

怎么算成功：向导末尾显示Configuration saved successfully且连接测试通过，说明密钥有效、模型可调。

跑通第一个真实任务：从一句需求到看得见的成果

目标：让 Goose 完整执行一次"规划 → 写码 → 自测"循环。

先建一个干净目录再进会话，Goose 会把当前目录当作工作区：

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

⚠️ 会话内 Goose 会真实执行命令、修改当前目录文件。务必在你能承受改动的项目里开会话。

输入一句需求：

用原生 JavaScript 写一个待办事项小应用： 支持增删、标记完成，用 localStorage 保存数据。

屏幕上会发生的事：Goose 先给一份简短方案（文件划分、功能点）；确认后依次创建index.html、style.css、app.js，边写边说明每个文件干什么；最后建议你用本地静态服务打开验证。

怎么算成功：goose-demo里真实多出这几个文件，浏览器打开后增、删、刷新不丢数据都正常。想接着改，执行goose session -r可带上下文继续：

goose session -r

让它"看见"浏览器：用 MCP 接入外部能力

目标：给 Goose 装上手脚——控制浏览器、抓取网页，不用你手动开页面验证。

Goose 通过 MCP（Model Context Protocol）开放标准接入 70+ 扩展。内置的Computer Controller提供浏览器控制、网页抓取、文件缓存工具；Developer扩展默认已启用，负责终端命令与文件读写（详见 Computer Controller 文档、内置扩展列表）。

添加 Computer Controller 的精确路径：goose configure→Add Extension→Built-In Extension→Computer Controller→ 超时填300秒。

配置完回到会话直接说："在浏览器里打开 index.html，验证待办的增删和刷新保留。"它自己会调浏览器完成操作。

⚠️ Goose 默认自主运行，扩展启用后工具能力更强。建议先按 权限模式指南 设定哪些工具免确认，把风险动作拦下来。

怎么算成功：你全程没碰浏览器，屏幕上能看到 Goose 调用了浏览器工具、页面被打开并完成操作。

不动的时候怎么办：快速定位常见问题

跑通之后：四个值得做的动作

1. 放一份goosehints文件，把团队技术栈、命名规范写进去，Goose 每次会话都会带上这份记忆。
2. 在goose configure的扩展列表里按需再开几个扩展，MCP 目录按名称查找，见 MCP 服务器文档。
3. 定期执行goose update保持 CLI 为最新版：

goose update

4. 把一次成功会话的提示词沉淀成 YAML recipe，团队直接复用，参考 recipe 示例目录。

【免费下载链接】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