内置服务商
goose 内置 50 多家服务商,用 goose configure → Configure Providers 选择即可:
- 商业模型:OpenAI、Anthropic、Google Gemini、Azure OpenAI、Groq、Mistral AI 等
- 网关:OpenRouter、LiteLLM 等
- 本地:Ollama、LM Studio、Docker Model Runner 等
- 企业:Amazon Bedrock、Databricks、Snowflake、Azure AI Foundry 等
常用的环境变量:
| 用途 | 变量 |
|---|---|
| 指定服务和模型 | GOOSE_PROVIDER、GOOSE_MODEL |
| OpenAI(可改地址) | OPENAI_API_KEY、OPENAI_HOST、OPENAI_BASE_PATH |
| Anthropic | ANTHROPIC_API_KEY、ANTHROPIC_HOST |
| Ollama | OLLAMA_HOST |
添加自定义服务
列表里没有的服务(公司网关、国产模型 API 等),可以添加自定义服务:
goose configure依次选择 Custom Providers → Add A Custom Provider,填写:
- API 类型:OpenAI、Anthropic 或 Ollama 兼容
- 名称和接口地址
- 鉴权方式和 Key
- 可用的模型列表
- 是否支持流式输出
每个自定义服务会保存为 ~/.config/goose/custom_providers/ 下的一个 JSON 文件:
{ "name": "custom_corp_api", "engine": "openai", "display_name": "Corporate API", "api_key_env": "CUSTOM_CORP_API_API_KEY", "base_url": "https://api.company.com/v1/chat/completions", "models": [{ "name": "gpt-4o", "context_limit": 128000 }], "supports_streaming": true, "requires_auth": true}base_url 和请求头里可以用 ${变量名} 引用环境变量。桌面端暂时不能设置自定义请求头,需要创建后手动编辑这个 JSON 文件。
连接 Ollama 本地模型
- 安装 Ollama,运行一个支持工具调用的模型,例如
ollama run qwen2.5 - 运行
goose configure,选择 Configure Providers → Ollama - 地址填
http://localhost:11434(默认值) - 模型名填 Ollama 里已经加载的模型
不支持工具调用的模型没法让 goose 读写文件和执行命令,选模型时要注意。