跳转到内容
免费注册
在 Coding Agent 接入

Goose 配置指南:API Key、Base URL 与模型选择

安装 Goose 并接入 BetterToken,配置 API Key、OpenAI 主机地址和 Model ID,启用开发者扩展,验证文本请求与文件读取工具调用。

通过 Goose 的 OpenAI provider 接入 BetterToken。在 macOS 搭配 GPT 模型的测试中,Goose 1.55.0 通过 /v1/responses 完成了文本请求和文件读取工具调用。

重点信息

字段值
API Key在 OPENAI_API_KEY 中设置 BetterToken API Key
Base URL在 OPENAI_HOST 中设置 https://bettertoken.ai,不带 /v1
Model在 GOOSE_MODEL 中设置 YOUR_MODEL_ID
ProviderGOOSE_PROVIDER=openai

准备工作

安装

使用 Goose 官方安装脚本:

终端窗口
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
goose --version

手动配置

运行前替换 YOUR_API_KEY 和 YOUR_MODEL_ID:

终端窗口
export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="YOUR_MODEL_ID"
export OPENAI_API_KEY="YOUR_API_KEY"
export OPENAI_HOST="https://bettertoken.ai"

OPENAI_HOST 使用网站根地址。即使选择的是 OpenAI provider,也不要在此字段中添加 /v1。

如需访问文件,运行 goose configure,选择 Toggle Extensions 并启用 developer。开发者扩展提供文件和终端工具。

验证连接

在同一终端中运行:

终端窗口
goose run --no-session --max-turns 4 -t "Reply with only: OK"

确认最终回复为 OK。如需单独验证文件访问,在项目中运行 Goose,让它读取一个已知文件,同时核对工具结果和最终回复。

切换模型

将 GOOSE_MODEL 设为模型广场中的另一个完整 Model ID,然后重新运行。

常见错误

现象排查方式
认证失败检查运行 Goose 的终端中的 OPENAI_API_KEY。
请求地址错误将 OPENAI_HOST 设为 https://bettertoken.ai,不要添加 /v1 或具体接口路径。
文件工具不可用运行 goose configure,启用内置 developer 扩展。
请求仍使用 ResponsesGoose 1.55.0 测试中,即使设置 OPENAI_BASE_PATH=v1/chat/completions,被测模型仍使用 /v1/responses。请检查实际请求路径。

相关文档

技术说明

被测文本请求和文件读取请求均使用 /v1/responses。仅凭 provider 名称和环境变量名,无法确定 Goose 为其他模型选择的协议。