在 goose 中使用 OceanToken
goose 通过一个自定义提供商在 OceanToken 上运行：它是一个 JSON 文件，告诉 goose 基础地址（Base URL）、存放你的 API Key 的变量名，以及一份模型列表。OceanToken 把这个文件发布在 https://docs.oceantoken.ai/goose/oceantoken.json。文件里不含 API Key。
以下步骤已于 2026-10-19 用 goose CLI 1.54.0 测试过：下表中的每个模型都用 goose 的文件和 shell 工具编写并运行了一个小程序。
开始之前
为 goose 创建一个 API Key，并给它设置 消费上限。智能体会发出大量请求，消费上限决定了这个 API Key 最多能花多少钱。如何把 API Key 保存在环境变量中并检查它，见开始之前。
添加提供商文件
goose 从它的 custom_providers 文件夹读取自定义提供商。在 macOS 和 Linux 上：
mkdir -p ~/.config/goose/custom_providers
curl -fsSL -o ~/.config/goose/custom_providers/oceantoken.json https://docs.oceantoken.ai/goose/oceantoken.json
在 Windows 上，这个文件夹是 %APPDATA%\Block\goose\config\custom_providers\；把文件以 oceantoken.json 为名保存到那里。
重新下载这个文件，即可获取更新的版本。
在 goose CLI 中使用
goose 从 OCEANTOKEN_API_KEY 读取 API Key：
export OCEANTOKEN_API_KEY=sk-...
goose session --provider oceantoken --model deepseek/deepseek-v4-pro
不启动会话，直接检查设置：
goose run --no-session --provider oceantoken --model deepseek/deepseek-v4-flash -t "Reply with the single word OK"
要把 OceanToken 设为默认提供商，运行 goose configure，选择 Configure Providers，再选择 OceanToken；或者把下面两行写进 ~/.config/goose/config.yaml：
GOOSE_PROVIDER: oceantoken
GOOSE_MODEL: deepseek/deepseek-v4-pro
在 goose Desktop 中使用
桌面应用读取同一个文件夹。添加文件后，重启 goose Desktop，打开 Settings → Models → Configure providers，选择 OceanToken，然后粘贴你的 API Key。goose Desktop 会把 API Key 保存在系统钥匙串中。
推荐模型
这个文件列出了下面这些模型，每个都用 goose 的工具测试过。每个模型的价格见它在 oceantoken.ai 上的页面，从 价格 一列点进去。
| 模型 ID | 上下文窗口 | 最大输出 | 图像 | 价格 |
|---|---|---|---|---|
deepseek/deepseek-v4-pro | 1,048,576 | 393,216 | 否 | 在官网查看 |
deepseek/deepseek-v4-flash | 1,048,576 | 393,216 | 是 | 在官网查看 |
moonshotai/kimi-k3 | 1,048,576 | 943,718 | 是 | 在官网查看 |
minimax/minimax-m3 | 524,288 | 512,000 | 是 | 在官网查看 |
它们只是一份起步列表，不是限制。--model 可以接受模型页上任何支持工具调用的文本模型，写法与该页相同，前面带上发布方。
费用
goose 发出的每个请求都是普通的 API 请求：按模型的价格从你的余额中扣费，并列在控制台的日志中。goose 每一轮都会重新发送很长的提示，所以 缓存输入 价格和输入价格一样重要。goose 自己显示的费用只是估算；每个请求的实际费用以 日志 中的为准。
故障排查
| 你看到的 | 怎么处理 |
|---|---|
missing required key OCEANTOKEN_API_KEY | goose 找不到 API Key。在运行 goose 的 shell 中 export OCEANTOKEN_API_KEY，或在 goose Desktop 或 goose configure 中填入 API Key。 |
Invalid API key. Check the key, or create one in the OceanToken console. | API Key 有误、已被撤销，或带了多余的空格。重新设置一次，或新建一个。 |
Unknown model '…'. GET /v1/models lists the models your key can use. | 模型 ID 要完全按照模型页的写法填写，前面带上发布方（写 deepseek/deepseek-v4-pro，而不是 deepseek-v4-pro）。 |
Insufficient balance - please add credit to continue. | 充值。 |
| 提供商列表里没有 OceanToken | 检查文件是否在上面所说的 custom_providers 文件夹中，且以 .json 结尾，然后重启 goose。 |