文档 · 快速开始

把你的 CLI 指向 ObixHub。就这样。

一个 base URL —— https://obixhub.com —— 适用每个 CLI。每个 SDK 自己补上路径,所以不用记 /v1。设好 base URL,把你的 obx_ key 交给它,继续用你现有的工具。

一个 base url

同一个源,每个客户端。

把客户端的 base URL 设为下面这个裸源。SDK 会补上各自约定的路径 —— 它可能落到的端点如下。

客户端

SDK 命中的路径

协议格式

claude code

/v1/messages

anthropic messages

codex cli

/chat/completions · /v1/responses

openai chat / responses

鉴权

一把 obx_ key,多种请求头写法。

在面板里创建一把命名 key,然后按你客户端喜欢的方式发送。key 绑定团队套餐,绝不转发给模型厂商。

authorization: bearer

Authorization: Bearer obx_ER0B******dzKp

+ more

routeany route

x-api-key

x-api-key: obx_ER0B******dzKp

+ more

routePOST /v1/messages

配置各个 CLI

复制、粘贴、运行。

Claude Code 说 Anthropic Messages API;Codex CLI 说 OpenAI Responses API。两者都能到达 Claude 与 GPT。

claude code

# claude code — anthropic messages
export ANTHROPIC_BASE_URL="https://obixhub.com"
export ANTHROPIC_API_KEY="obx_ER0B******dzKp"

# pin a model in the catalog (optional)
export ANTHROPIC_MODEL="claude-opus-4-8"

$ claude

codex cli

# codex cli — openai responses
# ~/.codex/config.toml
model_provider = "obixhub"

[model_providers.obixhub]
name     = "obixhub"
base_url = "https://obixhub.com/v1"
wire_api = "responses"
env_key  = "OPENAI_API_KEY"

# then:
export OPENAI_API_KEY="obx_ER0B******dzKp"
$ codex -m gpt-5.5

或直接调用

原生协议格式。

无需 SDK —— 任何能 POST JSON 的工具都行。加 stream:true 即可走 SSE 流式。

POST /v1/messages — anthropic

curl https://obixhub.com/v1/messages \
  -H "x-api-key: obx_ER0B******dzKp" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d @-

body

{
  "model": "claude-opus-4-8",
  "max_tokens": 1024,
  "messages": [{ "role": "user", "content": "hello" }]
}

POST /chat/completions — openai

curl https://obixhub.com/chat/completions \
  -H "authorization: Bearer obx_ER0B******dzKp" \
  -H "content-type: application/json" \
  -d @-

body

{
  "model": "gpt-5.5",
  "messages": [{ "role": "user", "content": "hello" }]
}

模型

使用厂商的原生模型名。

按厂商命名原样传入模型 —— claude-opus-4-8、gpt-5.5。不要 provider/ 前缀;你调用的端点已经选定了厂商。

每把 key 都带模型允许列表(默认全部精选模型)。不在列表内、或与该端点厂商不符的模型,会以该端点自己的错误格式被拒绝。

浏览全部模型 →

anthropic/claude-opus-4-8 · sonnet · haiku
openai/gpt-5.5 · gpt-4o · o-series

拿到 obx_ key 了?发布吧。

创建 key →