跳到正文
funcoding.ai
← goose

goose · 自定义模型

goose 配置自定义模型:内置服务商、自定义服务与 Ollama

用 goose configure 连接 50+ 内置服务,添加 OpenAI / Anthropic / Ollama 兼容的自定义服务,以及连接本地 Ollama 模型。

1 分钟读完

内置服务商

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 等),可以添加自定义服务:

Terminal window
goose configure

依次选择 Custom Providers → Add A Custom Provider,填写:

  • API 类型:OpenAI、Anthropic 或 Ollama 兼容
  • 名称和接口地址
  • 鉴权方式和 Key
  • 可用的模型列表
  • 是否支持流式输出

每个自定义服务会保存为 ~/.config/goose/custom_providers/ 下的一个 JSON 文件:

~/.config/goose/custom_providers/custom_corp_api.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 本地模型

  1. 安装 Ollama,运行一个支持工具调用的模型,例如 ollama run qwen2.5
  2. 运行 goose configure,选择 Configure Providers → Ollama
  3. 地址填 http://localhost:11434(默认值)
  4. 模型名填 Ollama 里已经加载的模型

不支持工具调用的模型没法让 goose 读写文件和执行命令,选模型时要注意。