跳到正文

把你的工具接到 Fluxo

所有客户端都连接 API 域名 https://api.fluxorelay.com；网站主域名不处理 API 请求。

VS Code

VS Code 里的 Claude Code 插件底层运行的就是同一个 CLI，会从启动 VS Code 的环境里读取下面两个变量。

export ANTHROPIC_BASE_URL=https://api.fluxorelay.com
export ANTHROPIC_AUTH_TOKEN=flx_your_key_here
claude

Codex 插件读取 ~/.codex/config.toml，与 Codex CLI 用的是同一个文件；下面终端一节有现成的一份。

带「OpenAI 兼容」提供方的插件（Cline、Roo Code、Continue）只要填三项：Base URL https://api.fluxorelay.com/v1、你的 Fluxo 密钥、价格页里的模型 id。

Base URL : https://api.fluxorelay.com/v1
API key  : flx_your_key_here
Model    : gpt-6.1-sol

JetBrains 系列 IDE

Claude Code 插件在 IDE 终端里驱动 CLI：把两行 export 写进 shell 配置，重启 IDE 让它继承这两个变量。

能填自定义 OpenAI 端点的助手插件，URL 填 https://api.fluxorelay.com/v1，令牌填你的 Fluxo 密钥。

Cursor

在 Cursor 的模型设置里，把 Fluxo 密钥填进 OpenAI API Key，打开 Base URL 覆盖并填 https://api.fluxorelay.com/v1，再加上想用的模型 id，例如 gpt-6.1-sol。

Claude 模型无法通过 Cursor 的 OpenAI 覆盖调用，请改用 Claude Code（见终端一节的说明）。

终端

命令行 Agent 从环境变量或点文件读取配置，下面每个工具一份文件。

Claude Code 与 Claude Desktop

设置两个环境变量，然后运行 claude。Base URL 末尾不要加 /v1。

export ANTHROPIC_BASE_URL=https://api.fluxorelay.com
export ANTHROPIC_AUTH_TOKEN=flx_your_key_here
claude

PowerShell 写法：

$env:ANTHROPIC_BASE_URL = "https://api.fluxorelay.com"
$env:ANTHROPIC_AUTH_TOKEN = "flx_your_key_here"
claude

Claude 系列模型只向官方 Claude Code 与 Claude Desktop 客户端提供，且版本需 ≥ 2.1.285，这是上游的限制。GPT、Gemini 及其它厂商的模型可以用任意 OpenAI 兼容客户端或 SDK 调用。

Codex CLI

Codex 读取 ~/.codex/config.toml；其中 env_key 一行指定存放 Fluxo 密钥的环境变量名。

.codex/config.toml

# ~/.codex/config.toml  (Codex CLI and the Codex IDE extension both read it)
model = "gpt-5.6-sol"        # or any other GPT id from the Fluxo price list
model_provider = "fluxo"

[model_providers.fluxo]
name = "Fluxo relay"
base_url = "https://api.fluxorelay.com/v1"
env_key = "FLUXO_API_KEY"   # export FLUXO_API_KEY=flx_... before launching codex
wire_api = "responses"       # Fluxo passes /v1/responses straight through
export FLUXO_API_KEY=flx_your_key_here
codex   # reads ~/.codex/config.toml

Gemini CLI 与 Gemini API

GOOGLE_GEMINI_BASE_URL 填裸 API 域名（不要加 /v1beta），密钥放进 GEMINI_API_KEY，然后运行 gemini。

export GOOGLE_GEMINI_BASE_URL=https://api.fluxorelay.com
export GEMINI_API_KEY=flx_your_key_here
gemini
curl "https://api.fluxorelay.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: flx_your_key_here" \
  -H 'Content-Type: application/json' \
  --data-raw '{"contents":[{"role":"user","parts":[{"text":"ping from my editor"}]}]}'

在 Fluxo 上 Gemini 只走原生协议。流式请用 :streamGenerateContent?alt=sse；/v1/chat/completions 会拒绝 Gemini 模型。

可用的 Gemini id 一览：

  • gemini-3.1-pro
  • gemini-3.8-flash
  • gemini-4-argon

裸 cURL，不装 SDK

base_url 填 https://api.fluxorelay.com/v1，api_key 填你的 Fluxo 密钥；对话接口是 /v1/chat/completions。

curl https://api.fluxorelay.com/v1/chat/completions \
  -H "Authorization: Bearer flx_your_key_here" \
  -H 'Content-Type: application/json' \
  --data-raw '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"ping from my editor"}]}'

上手先试这几个 GPT id：

  • gpt-6.1-sol
  • gpt-6-astra
  • gpt-5.6-sol

密钥、错误码与计费

OpenAI 风格的调用用 Bearer 令牌携带密钥；Anthropic 风格放在 x-api-key；Gemini 调用用 x-goog-api-key。

每次调用按上游报告的 token 数计费。HTTP 402 表示余额为零或心流卡额度用完：充值后重试即可。