Goose实战:0元本地AI编程Agent,跑了一周我的完整配置和踩坑记录
背景
Claude Code用量限制卡脖子,每5小时40次提示,写到关键逻辑被打断。上个月开始试Block公司开源的Goose(github.com/block/goose),记录一下完整的配置过程和一周使用体验。
Goose是什么
Block(Square和Cash App母公司)开源的AI编程Agent,GitHub 26000+星,102个版本。核心特点:跑在本地,支持任意模型(Anthropic/OpenAI/Gemini/Ollama),支持MCP协议接外部工具。
不是Copilot那种补全工具,是能自己读文件、跑命令、调API、写测试的Agent。
安装
# macOS
brew install block/tap/goose
# Linux
curl -fsSL https://github.com/block/goose/releases/latest/download/goose-linux-amd64 -o goose
chmod +x goose && sudo mv goose /usr/local/bin/
# 验证
goose --version
配置模型
goose configure 进入配置向导。
方案一:Claude API(效果最好)
选 Anthropic,填API Key,模型选 claude-sonnet-4-20250514。按量计费,每天0.5到2美元,没有速率限制。
方案二:OpenRouter(灵活)
一个Key切几十个模型,包括DeepSeek R1。
方案三:Ollama本地(免费)
# 装Ollama
brew install ollama # macOS
# 拉编程模型
ollama pull qwen3-coder
# Goose里配置
goose configure
# Provider: Ollama
# API Host: http://localhost:11434
# Model: qwen3-coder
内存需求:8GB跑7B(勉强),16GB跑14B(够用),32GB跑34B+(接近云端体验)。
配MCP
编辑 ~/.config/goose/config.yaml:
mcpServers:
filesystem:
command: npx
args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/projects"]
github:
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"
sqlite:
command: npx
args: ["-y", "@modelcontextprotocol/server-sqlite", "/path/to/db.db"]
前提:Node.js 18+。
一周实测
Day 1:初始化项目
> 创建Next.js 15项目,TypeScript + Tailwind CSS + ESLint,建好目录结构
自动跑 create-next-app、改配置、建目录,没出错。标准化任务没问题。
Day 3:定位Bug
API路由偶发500,报错 "TypeError: Cannot read properties of undefined"。把报错贴进去,Goose自己读源文件,定位到异步函数缺await,加了await还补了try-catch。
用Claude API修复率高,换本地14B模型开始瞎猜。
Day 5:碰到上限
重构2000行文件拆模块。Claude API能理解整个文件逻辑,拆得合理。Ollama本地模型读到一半丢上下文,模块间引用对不上。
硬伤:本地模型上下文窗口4096-8192 token,Claude有200K。
踩坑清单
- Ollama首次加载慢:qwen3-coder约30秒加载到内存,后续快
- config.yaml格式严格:多一个空格报错,建议用
goose configure不要手动改 - 桌面版和CLI共享配置:别同时改,会冲突
- MCP依赖Node.js:确保18+版本
对比
| 场景 | Goose+Claude API | Goose+Ollama | Claude Code |
|---|---|---|---|
| 新建项目 | OK | OK | OK |
| 改Bug | OK | 简单的OK | OK |
| 重构大文件 | OK | 不行 | OK |
| 离线 | 不行 | OK | 不行 |
| 月费 | 30-60元 | 0 | 1400+元 |
我的用法
日常开发 Goose+Claude API,出差 Goose+Ollama,复杂代码库偶尔开Claude Code。
GitHub:github.com/block/goose
关注公众号 92year,每天一篇AI工具深度实测