← 博客
Goose接入教程编程 Agent

Goose 配置 Claude 和 GPT：自定义 API 教程（CLI 与桌面版）

（文中价格随实时价格表更新）

简短回答

在 Goose 中使用 APIVAI：运行 goose configure，选择 Configure Providers，再选 OpenAI，把 APIVAI 密钥作为 OPENAI_API_KEY 粘贴进去，在询问高级设置时回答 Yes，把 OPENAI_HOST 设为不带 /v1 的 https://api.apivai.com，然后选择模型，例如 claude-sonnet-4-6 或 gpt-5.5。路径由 Goose 自己添加：OPENAI_BASE_PATH 默认是 v1/chat/completions，所以 host 只填域名即可。如果只用 Claude，也可以改选 Anthropic 提供方，把 ANTHROPIC_HOST 设为同样的 https://api.apivai.com，因为 Goose 会自动加上 v1/messages。截至 2026-10-10，通过 APIVAI 使用 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.15 / $5.74，官方价为 $3.00 / $15.00，按 token 从预付余额扣费，无需订阅。

Goose 是什么？为什么要用自己的 API 密钥？

Goose 是一个开源 AI Agent，最初由 Block 开发，运行在你自己的电脑上，提供命令行工具（goose CLI）和桌面应用（goose Desktop）两种形态。它会修改文件、运行命令，并通过扩展（MCP 服务器）连接其他工具。Goose 本身不带模型：你需要接入一个 LLM 提供方，会话中的每一步都是一次由该提供方计费的请求。

本文已对照 Goose 1.54 版（2026 年 10 月）的文档和源码核实。

APIVAI 提供一个可调用 Claude 和 GPT 的密钥，按 token 计费，大多数模型低于官方标价，从你自己充值的余额中扣除。同一个密钥同时支持 OpenAI 格式和 Anthropic 格式，因此适用于这里用到的两个 Goose 内置提供方。

Goose 接入 APIVAI 应该用哪个提供方？

Goose 提供方设置项值模型
OpenAI（内置）OPENAI_HOSThttps://api.apivai.comClaude 和 GPT
Anthropic（内置）ANTHROPIC_HOSThttps://api.apivai.com仅 Claude
自定义提供方，OpenAI CompatibleAPI URLhttps://api.apivai.com/v1Claude 和 GPT
自定义提供方，Anthropic CompatibleAPI URLhttps://api.apivai.com仅 Claude

两个 host 设置项只填服务器根地址。Goose 会把 host 和请求路径拼接起来：v1/chat/completions（来自 OPENAI_BASE_PATH）、v1/responses 或 v1/messages。如果 host 以 /v1 结尾，就会变成 /v1/v1/...，返回 404。

选 OpenAI：一套配置覆盖所有模型。使用这个提供方时，Goose 会把 GPT-5 和 GPT-6 系列模型发到 Responses API（v1/responses），把 Claude 等其他模型发到 v1/chat/completions；APIVAI 两个端点都支持。选 Anthropic：只用 Claude。Goose 在 Anthropic 提供方上会为 Claude 模型自动开启提示缓存，重复的上下文按缓存读取价计费，Claude Sonnet 4.6 为每百万 token $0.12，而不是完整的输入价。缓存写入为每百万 $1.44。

如何一步步把 Goose 接入 APIVAI？

第 1 步：创建 APIVAI 密钥

  1. 在 apivai.com 用邮箱注册。
  2. 充值 $10 起，支持银行卡、加密货币、支付宝和微信支付。没有免费试用，也没有订阅。
  3. 在控制台创建密钥并复制。如果想严格限制 Goose 的花费，可以给密钥设置预算上限。

第 2 步：在 goose CLI 中配置 OpenAI 提供方

  1. 运行 goose configure。
  2. 选择 Configure Providers 并按 Enter。
  3. 选择 OpenAI。
  4. 提示输入 OPENAI_API_KEY 时，粘贴你的 APIVAI 密钥。
  5. 出现 Would you like to configure advanced settings? 时回答 Yes，然后按下表填写。其余提示（组织、项目、自定义请求头、超时）直接按 Enter 跳过。
  6. 从列表中选择模型、搜索模型，或者选择 Enter a model not listed... 并输入准确的 ID。
  7. 用 goose session 开始工作。
提示值
OPENAI_API_KEY你的 APIVAI 密钥
OPENAI_BASE_URL留空（按 Enter）
OPENAI_HOSThttps://api.apivai.com
OPENAI_BASE_PATH留空：默认是 v1/chat/completions
模型claude-sonnet-4-6（或 GET /v1/models 返回的任意 ID）

在较早的 Goose 版本中，输入密钥后会直接询问 host，没有高级设置这一问；填写的值相同。Goose 把密钥存在系统钥匙串里（没有钥匙串时存在 secrets.yaml），不会写进 config.yaml。

查看你的密钥可用哪些 ID：

curl https://api.apivai.com/v1/models \
  -H "Authorization: Bearer YOUR_APIVAI_KEY"

模型会随时间上新或下线，请从这个列表或价格页复制 ID。

第 3 步（可选）：为 Claude 使用 Anthropic 提供方

再次运行 goose configure，选择 Configure Providers，再选 Anthropic。把同一个密钥作为 ANTHROPIC_API_KEY 粘贴进去，高级设置回答 Yes，把 ANTHROPIC_HOST 设为 https://api.apivai.com，再选择一个 Claude 模型。不要加 /v1：Goose 会把 Anthropic 请求发到 host 加 v1/messages，也就是 https://api.apivai.com/v1/messages。Anthropic 格式的说明见 Claude API 代理页面。

第 4 步：或者在 goose Desktop 中配置

  1. 打开侧边栏，点击 Settings，进入 Models 标签页，点击 Configure providers。
  2. 点击 OpenAI，填入 APIVAI 密钥，把 host（OPENAI_HOST）设为 https://api.apivai.com，点击 Submit。
  3. 在 Models 中点击 Switch models，选择 OpenAI 提供方，选择 Use custom model，输入 claude-sonnet-4-6，再点击 Select model。

也可以点击提供方列表底部的 Add Custom Provider：Provider Type 选 OpenAI Compatible，Display Name 填 APIVAI，API URL 填 https://api.apivai.com/v1，粘贴密钥，在 Available Models 中填入模型 ID（用逗号分隔），然后点击 Create Provider。自定义提供方可以让 APIVAI 和真正的 OpenAI 配置互不干扰。

第 5 步：用于脚本和 CI 的环境变量

export OPENAI_API_KEY="YOUR_APIVAI_KEY"
export OPENAI_HOST="https://api.apivai.com"
export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="claude-sonnet-4-6"
export GOOSE_MAX_TOKENS=8192
goose session

在 Windows PowerShell 中写成 $env:OPENAI_HOST = "https://api.apivai.com"，其余同理。环境变量会在当前进程中覆盖配置文件。不要把 API 密钥写进 config.yaml：Goose 不会从那里读取提供方密钥。

在 Goose 中该选哪个模型？

每百万输入 / 输出 token 价格，截至 2026-10-10：

模型 ID价格（输入 / 输出）适合
claude-sonnet-4-6$1.15 / $5.74日常 Agent 工作：默认选择
claude-sonnet-5-5$0.77 / $3.82更新的 Sonnet，适合写代码
claude-opus-5-5$1.54 / $7.65最难的任务、长计划
claude-haiku-4-5$0.38 / $1.92快速便宜的会话和 recipe
gpt-5.5$0.77 / $4.56GPT 方案
gpt-6-luna$0.0144 / $0.0768非常便宜的运行

Goose 的所有操作都依赖工具调用，所以要选支持工具调用的模型；上表中的模型都支持。GPT 模型需要使用 OpenAI 提供方或 OpenAI Compatible 自定义提供方。

Goose 配合 APIVAI 要花多少钱？

Goose 会话的每一轮都会重新发送对话、工具结果和扩展说明，所以输入 token 占大头。两个计算示例：

  • 一次工作会话，使用 Claude Sonnet 4.6：约 30 次请求，每次约 30,000 输入和 1,500 输出 token。费用：APIVAI $1.29，官方价 $3.38。
  • 一个月，每天两次这样的会话，共 22 天（1,320 次请求）：APIVAI $56.91，官方价 $149。如果每天用 Claude Haiku 4.5 跑一个小 recipe（10 次请求，每次 10,000 输入、1,000 输出 token，每月 220 次），费用为 $1.26。

以上数字未计入 Anthropic 提供方上的提示缓存。思考 token 按输出 token 计费。每次请求的真实数据都在控制台里。更全面的对比见 2026 年 Claude API 价格对比。

Goose 常见报错怎么解决？

  • 401 Unauthorized： 密钥错误、已删除或超出预算上限，或者被写进了 config.yaml，而 Goose 会忽略那里的密钥。重新运行 goose configure，或设置 OPENAI_API_KEY / ANTHROPIC_API_KEY。
  • 404 Not Found： /v1 写错了。OPENAI_HOST 和 ANTHROPIC_HOST 都是不带路径的 https://api.apivai.com，OPENAI_BASE_PATH 保持 v1/chat/completions。不要让 OPENAI_BASE_URL 和 OPENAI_HOST 的值互相矛盾。
  • 找不到模型： 使用准确的 ID，例如 claude-sonnet-4-6，而不是显示名称。用 GET /v1/models 核对。
  • 回复为空或被截断： 思考默认开启并消耗输出 token。把 GOOSE_MAX_TOKENS 设为 8192（至少 4096）。
  • 429 Too Many Requests： 每个密钥默认每分钟 60 次请求。稍等片刻，或联系客服提高限额。

请求格式的更多说明见文档和 OpenAI 兼容 API 页面。

常见问题

在 Goose 中能用一个密钥同时使用 Claude 和 GPT 吗？

可以。一个 APIVAI 密钥适用于所有模型。使用 OpenAI 提供方时，只需修改 GOOSE_MODEL 或在应用中切换模型。

为什么 OPENAI_HOST 不带 /v1？

Goose 用 host 加上 OPENAI_BASE_PATH 组成地址，而后者已经以 v1/ 开头。完整请求会发到 https://api.apivai.com/v1/chat/completions。

选 OpenAI 还是 Anthropic 提供方？

GPT 模型，或者想用一套配置搞定所有模型，选 OpenAI。只用 Claude 时选 Anthropic，Goose 会开启提示缓存；它的 host 同样是 https://api.apivai.com。

APIVAI 能为 Goose 提供 embeddings 吗？

不能。APIVAI 只提供对话模型；对话、工具调用和扩展都能正常使用，但需要 embedding 模型的功能必须另外配置提供方。

APIVAI 会保存我的数据吗？

不会。请求和响应的内容不会被记录，只保留模型、token 数和费用等用于计费的使用数据。

还有类似的终端 Agent 教程吗？

注册账号，充值 $10 起，把密钥粘贴到 Goose 即可。

准备好了吗？

30 秒获取 API 密钥，按量付费使用 Claude 和 GPT

开始使用