在 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 |
| Provider | GOOSE_PROVIDER=openai |
准备工作
安装
使用 Goose 官方安装脚本:
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bashgoose --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 扩展。 |
| 请求仍使用 Responses | Goose 1.55.0 测试中,即使设置 OPENAI_BASE_PATH=v1/chat/completions,被测模型仍使用 /v1/responses。请检查实际请求路径。 |
相关文档
技术说明
被测文本请求和文件读取请求均使用 /v1/responses。仅凭 provider 名称和环境变量名,无法确定 Goose 为其他模型选择的协议。

