Skip to main content
Goose 是 Block 公司推出的开源本地编码智能体。虽然 Goose 并未内置 Tokios 提供商模块，但它支持通过 JSON 文件配置自定义提供商，借此即可让智能体连接至 https://api.tokios.com/v1 并调用连接器后端的任意模型。

​
前置条件

  • 已启动的 Tokios 连接器及其关联的本地模型——详情参见 连接器安装
  • 已注册的模型部署名称——详情参见 注册模型
  • 有效的 Tokios API 密钥（sk-tok-…）——详情参见 API 密钥管理
  • 已安装 Goose

​
自定义提供商配置流程

为 Goose 创建自定义提供商配置文件。鉴于不同版本的 Goose 对配置格式要求各异，请务必依据您当前使用的版本确认 JSON 结构规范，包括字段命名规则、必填/可选参数设置，以及是否需使用 models 数组或其他特定格式。
在 ~/.config/goose/custom_providers/ 目录下创建一个 JSON 文件：
tokios.json
该文件仅指定了 环境变量 的名称，并不包含实际的 API 密钥，因此只需在启动 Goose 前导出该环境变量即可：
Replace gemma-tunnel with the public deployment name you registered on the Models tab — not the local model id your backend (Ollama, llama.cpp, vLLM, or LM Studio) uses. Because api_key_env stores only the variable name, this file is safe to commit; the key never enters it.
If requests 404, check how your Goose release interprets base_url. Goose’s own custom-provider example writes the full endpoint path (.../v1/chat/completions) rather than just the /v1 root, and the two forms are not interchangeable — try https://api.tokios.com/v1/chat/completions if https://api.tokios.com/v1 fails.

​
备选方案：使用内置的 OpenAI 提供商

若不想创建额外的提供商配置文件，Goose 内置的 openai 提供商同样支持自定义主机设置。相关配置信息会被保存至 ~/.config/goose/config.yaml 中：
OPENAI_HOST 代表主机根地址，OPENAI_BASE_PATH 则是请求路径，其默认值为 v1/chat/completions——即 Tokios 的服务路径，因此通常无需另行设置。

​
备选方案：使用环境变量

除了创建自定义提供商文件外，您也可通过设置 OPENAI_HOST 环境变量来让 Goose 的 OpenAI 兼容客户端连接至 Tokios。请结合您安装的 Goose 版本确认 OPENAI_HOST 需要的是纯主机地址还是完整的 /v1 路径，以及是否需要配合 OPENAI_API_KEY 来完成身份验证。
Goose 将 Anthropic 视为独立的原生提供商，目前尚未提供通用的自定义 Anthropic 基础 URL 配置功能（相关需求已作为待办事项记录：block/goose#3777）。如需连接至 Tokios，请使用上文提到的 OpenAI 兼容提供商配置方式。

​
选择一款支持工具调用的模型

Goose 的智能体功能依赖工具调用来实现读取文件、执行命令以及编辑代码。并非所有本地模型都能稳定支持工具调用，因此在让 Goose 执行实际编辑操作前，请务必选用具备出色工具调用能力的模型进行部署。关于如何挑选适合智能体编程任务的模型，可参阅 按任务选择模型 指南。

​
故障排查

Goose 发送的 API 密钥缺失、格式有误或已被撤销。请确认 api_key（或 OPENAI_API_KEY）中存储的 sk-tok-… 密钥内容完整且不含多余空白字符，随后在 Keys 标签页中核查该密钥的状态。
The model name in models doesn’t match a registered deployment. Confirm it exactly matches the public name on the Models tab — not your Ollama, llama.cpp, vLLM, or LM Studio local model id.
对应部署所使用的连接器处于离线状态或已达到并发上限。请查看 Connectors 标签页：该连接器状态应显示为 Online，且运行该连接器的设备必须处于正常运行且可访问状态。

​
后续步骤

快速入门

配置连接器、注册模型并全新创建一条 API 密钥即可。

根据任务选择模型

在将本地模型接入 Goose 之前，请先确认它适合用于智能编程任务。