API Guide
STABLE
接入文档 OpenAI 兼容接入 管理 API Key

欢迎,了解 VibeDex

接入文档覆盖 OpenAI 兼容接入、Codex CLI 配置、客户门户与管理 API Key。按量计费,专为 Claude Code、Codex、Gemini CLI 用户提供的高质量 API 服务。

Claude Code Codex CLI Gemini CLI Pay-as-you-go

价格优势

全站汇率 1 人民币 = 1 美元
  • Codex 分组 0.5 倍率 (0.5 rmb 等价于官方 1 $)

产品介绍

Claude Code

Anthropic 官方 CLI
  • 终端 AI 助手,命令行编程。
  • 文件编辑、命令执行、多步骤推进。
  • 复杂重构、排错、跨文件修改。

Codex

OpenAI 代码助手
  • 代码生成、重构、审查。
  • 长上下文工程级问题拆解。
  • 个人开发与团队协作。

Gemini CLI

Google CLI 工具
  • 联网检索和任务链处理。
  • 兼容主流终端工作流。
  • 文档整理、脚本开发。

核心功能特性

围绕稳定接入与开发效率,提供更直接的 API 使用体验。

按量计费

无需月费,按实际用量计费。

🧠
多工具兼容

覆盖三类主流 CLI 方案。

🛡️
稳定接入

优化链路,减少中断与重试。

🔍
问题定位

统一入口快速定位问题。

📈
团队扩展

个人到团队的平滑增长。

🧩
低迁移成本

最少改动即可切换。

当前支持模型

面向编码、调试、重构、推理和高频调用场景,统一提供稳定可用的主力模型接入。

7 个生产可用模型
OpenAI 系列 OpenAI

覆盖通用主力、工程执行和快速响应等编码场景。

gpt-5.4 gpt-5.3-codex gpt-5.3-codex-spark gpt-5.2
主力开发:gpt-5.4 适合复杂任务、稳定产出与日常主模型场景。 工程执行:gpt-5.3-codex 更偏代码修改、修复与成体系执行。 高速交互:gpt-5.3-codex-spark 适合更快响应和轻量任务。
Claude 系列 Claude

覆盖轻量高频、均衡主力和高强度深度分析输出。

claude-haiku-4-5-20251001 claude-sonnet-4-6 claude-opus-4-6
轻量高频:Haiku 适合摘要、整理与低成本快速调用。 均衡主力:Sonnet 适合日常开发、问答和质量与速度平衡。 深度任务:Opus 适合复杂分析、长链路推理和高要求输出。
codexCliSetup Windows/Mac/Linux

Codex CLI 安装步骤 — OpenAI 代码助手工作流。

1. 安装

bash
npm install -g @openai/codex@latest
codex --version

2. 获取密钥

重要:Codex 需要使用专门的分组令牌,与 Claude Code 的令牌不同!
访问 https://www.vibedex.cn/login,创建 Codex 专用密钥。
创建配置文件夹:mkdir %USERPROFILE%\.codex

3. 配置文件

approval_policy = "never"
sandbox_mode = "danger-full-access"
model_provider = "vibedex"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_reasoning_summary = "detailed"
network_access = "enabled"
disable_response_storage = true
model_verbosity = "high"

[model_providers.vibedex]
name = "vibedex"
base_url = "https://www.vibedex.cn/codex"
wire_api = "responses"
requires_openai_auth = true
{
  "OPENAI_API_KEY": "粘贴为Codex专用分组密钥key"
}
字段
model_provider "vibedex" required
model "gpt-5.4" required
base_url https://vibedex.cn/claude required
OPENAI_API_KEY Codex 专用密钥 required
model_reasoning_effort "xhigh" optional
sandbox_mode "danger-full-access" optional

4. 启动

bash
mkdir my-codex-project && cd my-codex-project
codex

Cursor 自定义 API 路由使用 OpenAI /v1/chat/completions 兼容格式。你可以直接在 Cursor 的 Other 配置里接入 vibedex。

提示:Cursor Pro Plan 账号可按本教程接入,官方 OpenAI 额度为空时也可使用。
进入 Cursor Settings → Models,确保你是 Cursor Pro 账号。
打开 OpenAI API Key 开关,粘贴在 vibedex 后台创建的 key。
打开 Override OpenAI Base URL,填写下方地址。
Claude 系列直接在 Cursor 模型列表中选择;GPT 系列需要在 Add model 输入自定义模型名称。

Cursor Base URL

Base URL
https://www.vibedex.cn/v1

Claude 模型说明

Claude 模型不需要输入自定义模型名,直接在 Cursor 自带模型列表中选择即可。可选:Opus 4.6、Opus 4.5、Sonnet、Haiku。

GPT 模型说明(需要自定义模型名)

Add or search model 里输入下方模型名称。基础模型不带强度后缀;强度模型在末尾追加 -low/-medium/-high/-xhigh

类别 Cursor 自定义模型名 对应基础模型 思考强度
基础模型 vibedex-g-5 gpt-5 默认
强度模型 vibedex-g-5-low gpt-5 low
强度模型 vibedex-g-5-medium gpt-5 medium
强度模型 vibedex-g-5-high gpt-5 high
强度模型 vibedex-g-5-xhigh gpt-5 xhigh
基础模型 vibedex-g-5-codex gpt-5-codex 默认
强度模型 vibedex-g-5-codex-low gpt-5-codex low
强度模型 vibedex-g-5-codex-xhigh gpt-5-codex xhigh
基础模型 vibedex-g-5.1 gpt-5.1 默认
强度模型 vibedex-g-5.1-low gpt-5.1 low
强度模型 vibedex-g-5.1-xhigh gpt-5.1 xhigh
基础模型 vibedex-g-5.1-codex gpt-5.1-codex 默认
强度模型 vibedex-g-5.1-codex-xhigh gpt-5.1-codex xhigh
基础模型 vibedex-g-5.2 gpt-5.2 默认
强度模型 vibedex-g-5.2-low gpt-5.2 low
强度模型 vibedex-g-5.2-xhigh gpt-5.2 xhigh
基础模型 vibedex-g-5.2-codex gpt-5.2-codex 默认
强度模型 vibedex-g-5.2-codex-xhigh gpt-5.2-codex xhigh
基础模型 vibedex-g-5.3-codex gpt-5.3-codex 默认
强度模型 vibedex-g-5.3-codex-xhigh gpt-5.3-codex xhigh
基础模型 vibedex-g-5.4 gpt-5.4 默认
强度模型 vibedex-g-5.4-low gpt-5.4 low
强度模型 vibedex-g-5.4-medium gpt-5.4 medium
强度模型 vibedex-g-5.4-high gpt-5.4 high
强度模型 vibedex-g-5.4-xhigh gpt-5.4 xhigh
vibedex-g-5.4 = 基础模型 gpt-5.4(默认强度);vibedex-g-5.4-xhigh = 同一基础模型 + xhigh 强度。

适合不想手动改配置文件的同学,按步骤填入即可。下载 CC Switch →

安装后,在应用顶部 Tab 切换到你的目标配置对象(Claude、Codex、Gemini),然后添加自定义配置。
按下方参数填入并保存。
参数
供应商名称(随意输入) vibedex optional
API Key sk-********(粘贴你的 key) required
API 请求地址 https://vibedex.cn/claude required
API 请求地址
https://vibedex.cn/claude

OpenCode 与 Codex 的配置是两套独立步骤,请按下方内容单独配置。OpenCode 官网 →

安装 OpenCode CLI 并登录。
登录时选择 Other,并设置 vibedex 供应商。
编辑配置文件,替换为你的 API Key 与 baseURL。
Terminal
npm install -g opencode-ai
opencode auth login

配置文件路径

Path
~/.config/opencode/opencode.json

baseURL(OpenAI Compatible)

Base URL
https://vibedex.cn/claude
JSON — opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "vibedex": {
      "npm": "@ai-sdk/openai",
      "name": "vibedex",
      "options": {
        "baseURL": "https://vibedex.cn/claude",
        "apiKey": "替换为你的key"
      },
      "models": {
        "gpt-5.4": {
          "attachment": true,
          "reasoning": true,
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "limit": { "context": 1000000, "output": 128000 },
          "variants": {
            "xhigh": {
              "reasoningEffort": "xhigh",
              "textVerbosity": "low",
              "reasoningSummary": "auto"
            },
            "high": {
              "reasoningEffort": "high",
              "textVerbosity": "low",
              "reasoningSummary": "auto"
            },
            "medium": {
              "reasoningEffort": "medium",
              "textVerbosity": "low",
              "reasoningSummary": "auto"
            },
            "low": {
              "reasoningEffort": "low",
              "textVerbosity": "low",
              "reasoningSummary": "auto"
            }
          }
        }
      }
    }
  }
}

切换思考强度(Ctrl + T)

在 OpenCode 中,使用 Ctrl + T 可以切换模型推理强度,按 low → medium → high → xhigh → low 循环切换。

强度 说明 适用场景
low 思考最浅、速度最快 简单任务和快速迭代
medium 平衡速度与质量 日常编程任务推荐默认
high 更深入分析与规划 复杂逻辑和架构问题
xhigh 思考最深,消耗更高 棘手问题
建议:先用 Tab 切到 Plan 模式梳理需求,再切回 Build 模式写代码。默认先用 medium,卡住时再切到 high / xhigh。

OpenClaw 可通过 OpenAI Responses 兼容方式接入 vibedex。

安装 OpenClaw。
运行初始化命令,模型供应商选择 Skip for now
运行 openclaw dashboard 启动 Web 面板。
在面板 Config 中修改 Raw JSON 配置。
点击 SaveUpdate,回到 chat 即可。
Terminal
npm i -g openclaw
clawdbot onboard
openclaw dashboard
{
  "models": {
    "mode": "merge",
    "providers": {
      "vibedex": {
        "baseUrl": "https://www.vibedex.cn/v1",
        "apiKey": "替换为你的key",
        "api": "openai-responses",
        "models": [{
          "id": "gpt-5.4",
          "name": "vibedex (gpt-5.4)",
          "reasoning": true
        }]
      }
    }
  },
  "agents": {
    "defaults": {
      "thinkingDefault": "high",
      "model": { "primary": "vibedex/gpt-5.4" }
    }
  }
}
{
  "models": {
    "providers": {
      "vibedex-cc": {
        "baseUrl": "https://www.vibedex.cn/v1",
        "apiKey": "你的key",
        "api": "anthropic-messages",
        "models": [{
          "id": "claude-sonnet-4-5-20250929",
          "name": "Claude 4.5 Sonnet"
        }]
      }
    }
  }
}
thinkingDefault 表示默认思考强度。Save → Update 后回到 chat 即可。

这里只提供 Codex(Openai-Response)接入方式。

Codex 接入

参数
供应商类型 Openai-Response required
API 地址 https://vibedex.cn/claude required
API Key 后台创建的 API 密钥(sk- 开头) required
模型 ID(固定) gpt-5 required

地址格式说明

格式 地址 结果
推荐格式(不加结尾 /) https://vibedex.cn/claude 正确
错误格式(单独以 / 结尾) https://vibedex.cn/claude/ 错误
推荐格式让 Cherry Studio 自动拼接 v1;单独的 / 结尾可能导致 v1 被忽略。

按照以下步骤配置即可完成 ChatBox 的 vibedex 接入。

下载 ChatBox 客户端。
打开【设置】-【添加】,名称填写 vibedex(可自定义),API 模式选择 OpenAI Responses API 兼容
API 密钥:粘贴在 https://www.vibedex.cn/login 创建的密钥 key。
API 主机填写:https://vibedex.cn/claude
API 路径不需要填写,留空
开启【改善网络兼容性】选项。
新建模型:模型 ID 填写 gpt-5.4,其余保持默认;也可按需开启视觉、推理、工具使用等选项。
点击保存模型。
点击检查按钮,确认配置成功。

关键参数

参数
API 主机 https://vibedex.cn/claude required
模型 ID gpt-5.4 required

Droid CLI 读取 ~/.factory/config.json,可在其中添加 custom_models 指向本服务端点。

注意:如果你的 ~/.factory/settings.json 中存在旧的 vibedex 配置,请先清除后再按本教程配置并重启 Droid CLI,否则新配置可能不会生效。

配置文件路径

Path
~/.factory/config.json
JSON — config.json
{
  "custom_models": [{
    "model_display_name": "GPT-5.4 [vibedex]",
    "model": "gpt-5.4",
    "base_url": "https://vibedex.cn/claude",
    "api_key": "替换为你的key",
    "provider": "openai",
    "max_tokens": 16384,
    "extra_args": {
      "reasoning": { "effort": "high" }
    }
  }]
}

服务条款

最后更新:2026年4月10日

条款接受

使用我们的服务即表示您同意这些条款。

服务描述

vibedex 提供 API 接口服务,为开发者提供智能代码生成、调试和优化功能的访问能力。

许可和使用权限

  • 仅限个人非商业用途
  • 不可转让的许可
  • 单用户许可 - 每人一个账户
个人许可证。严禁商业使用、再分发或共享。

禁止活动

  • 转售、出租账户或 API 访问权限
  • 分发或共享 API 密钥
  • 逆向工程或提取源代码
  • 使用 API 构建竞争服务

付费条款

按量付费,支持支付宝、微信。退款 1-3 个工作日,按使用量折算,收取 1.5% 手续费。

知识产权

服务所有权归我们所有。您保留对自己代码和内容的所有权。

隐私政策

最后更新:2026年4月10日

数据收集

收集:邮箱、API 调用统计、计费信息、技术日志。
不收集:源代码、项目文件、完整业务上下文。

API 架构

  • 直连 API — 不经过我们的服务器存储。
  • 无数据存储 — 不存储代码、对话或项目文件。
  • 本地处理 — 代码分析在本地进行。

数据安全

  • TLS 端到端加密
  • 安全链路转发
  • 基于权限策略的访问控制

联系我们

如有接入、支付或配置疑问,可通过以下方式联系。