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/gooseGoose 是一个用 Rust 编写的开源 AI 智能体跑在你自己的机器上能自己规划、写代码、执行命令并测试验证。跟着这篇实操教程走完你会在本机装好 goose CLI、接通 LLM 提供商并跑通一个真实的写码任务全程约 10 分钟。先拿到结果三条安装路线先选一条后面都以 CLI 为主线路线适用人群耗时典型场景安装脚本装 CLI终端党、脚本与 CI5 分钟日常开发、批量任务桌面应用非命令行用户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.shWindows 在 Git Bash 或 WSL 里跑同一个脚本。要固定版本可设GOOSE_VERSIONv1.0.25跳过交互配置加CONFIGUREfalse。需要改代码才走源码路线装好 Rust 工具链后执行cargo build --release -p goose-cli --bin goose产物直接当 CLI 用。 脚本默认跑完会自动进入交互式配置向导第一次安装不用单独再配。冒烟测试空目录开一个会话新建一个空目录并进入Goose 会把它当作工作目录所有文件操作都发生在这里mkdir goose-demo cd goose-demo goose session输入一句最简单的话例如用一句话介绍你自己。能收到回复、退出正常说明安装与提供商连接都通了冒烟测试结束CtrlC退出会话。补齐必要配置冒烟测试只证明能说话这里把模型和密钥配到位。交互式向导设置模型提供商在终端运行配置命令按向导选Configure Providers→ 选提供商 → 填 API Key → 选模型全程约 2 分钟goose configuregoose 支持 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不在 PATHshell 配置里加export PATH$HOME/.local/bin:$PATH重开终端Windows 装完提示 PATH 警告安装目录未加入 PATH按安装文档手动加 PATH 后再跑goose configureApple M 芯片桌面版启动无窗口~/.config无读写权限给该目录授予读写权限后重启应用调模型频繁 401 或超时密钥失效或网络不通重新goose configure验证密钥检查代理设置装完跑配置卡在交互菜单脚本默认带交互配置用CONFIGUREfalse bash download_cli.sh重装后再单独配置跑通之后在项目根目录放一份.goosehints把技术栈与代码规范沉淀成固定提示词用法见goosehints 指南在goose configure的扩展列表里按需多开几个工具或按名称从 MCP 服务器目录 添加第三方服务器定期执行goose update保持 CLI 版本最新把这次写游戏的提示沉淀成可复用的 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考