OpenCode

OpenCode 通过自定义 OpenAI 兼容提供商连接 TokenFlux。调用费用从 TokenFlux 余额扣除。

本指南使用 OpenCode 1.19.3 和 gpt-6-luna 验证了流式回复。

开始前复制标题链接

1. 准备已安装的 OpenCode。配置详情请参阅官方自定义提供商指南和配置参考。
2. 在网页版的 API 密钥 页面创建并复制密钥。完整密钥只显示一次。
3. 在 账单 页面确认余额充足。
4. 在 模型与价格 页面复制模型 ID，并检查模型支持的协议。

配置提供商复制标题链接

在 Bash 或 Zsh 中设置密钥：

export TOKENFLUX_API_KEY="YOUR_TOKENFLUX_KEY"

在项目目录创建或更新 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenflux": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenFlux",
      "options": {
        "baseURL": "https://tokenflux.ai/v1",
        "apiKey": "{env:TOKENFLUX_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": { "name": "YOUR_MODEL_ID" }
      }
    }
  }
}

将 YOUR_TOKENFLUX_KEY 替换为刚复制的密钥。请勿将密钥提交到 Git。

OpenCode 通过 {env:TOKENFLUX_API_KEY} 读取密钥。@ai-sdk/openai-compatible 提供商发送 Chat Completions 请求。如果已有配置，请将 tokenflux 条目合并到已有 provider 对象中。

选择模型复制标题链接

将两处 YOUR_MODEL_ID 替换为支持 Chat Completions 和工具调用的目录模型。使用 --model tokenflux/YOUR_MODEL_ID，或启动 OpenCode 后通过 /models 选择模型。

验证连接复制标题链接

在临时目录中运行以下命令。如果客户端要求确认文件访问，请核对路径后批准。

printf 'TOKENFLUX_GUIDE_OK\n' > marker.txt
opencode run --model tokenflux/YOUR_MODEL_ID \
  "Read marker.txt with the read tool and return its contents"

回复应包含 TOKENFLUX_GUIDE_OK。在 使用记录 页面确认模型和密钥，并查看 token 数量与费用。测试完成后删除 marker.txt。

故障排查复制标题链接

提供商没有出现。 确认文件名为 opencode.json，且包含 provider.tokenflux.models。从该项目目录启动 OpenCode。

返回 401。 确认进程可以读取环境变量。如果曾使用 /connect，请通过 opencode auth list 检查已保存的凭据，并通过 /connect 更新凭据。

请求使用了 Responses。 此 Chat Completions 配置应使用 @ai-sdk/openai-compatible。@ai-sdk/openai 适配器的协议行为不同。

返回 401、429 或模型错误。 检查密钥是否启用、模型 ID 是否完整，以及余额和限流状态。请勿自动改用其他模型。

API 参考复制标题链接

请参阅 Chat Completions、模型列表 和 API 概览。