DX API 接入文档
帮助中心五分钟接入

五分钟接入

第一次接也没关系。先拿到自己的密钥，再在左侧选你要用的软件，跟着点按钮、填几个框就行。Codex 和 Claude Code 会用到配套管理工具；Cherry Studio、WorkBuddy 直接在软件里填，不用额外装管理器。

软件装好后，接入大约 5 分钟第一次下载安装可能会久一点
先说清楚：图片帮你找位置，填写时看本页的表格

图片来自软件作者或官方文档，里面可能是别家的示例，不要照抄图里的地址和密钥。我们还没有用本站付费令牌把四款软件完整测一遍。你在软件里收到回复，再在 DX API 看到对应的成功记录，才算确认连上了。

先拿到自己的 API Key

API Key 就是下面说的“令牌”或“密钥”。它让软件使用你的 DX API 额度，不是网页登录密码。不要发给别人，也不要填在这张教程页里。

  1. 登录 DX API，打开 API 密钥。有些版本叫“令牌管理”。
  2. 点“添加令牌”。名称写成自己认得的名字，比如 Codex-个人；每款软件单独建一枚，之后查用量比较方便。
  3. 选一个能用目标模型的“分组”。这个选项决定你能用哪些模型。拿不准时，先看 模型广场；仍不确定就问客服，告诉他你要用的软件和模型，不要发密钥。
  4. 第一次先设一个自己能接受的小额上限。若打开了“模型限制”，要把准备使用的完整模型名称加进去。
  5. 点“保存”，复制生成的完整令牌。先留在自己的电脑上，等会儿粘贴到软件的“API Key”框。
  • 账户余额和这枚令牌的额度都要够用。创建令牌不会自动充值。
  • 问客服时可以说：“我要用 Codex，请帮我确认支持 Responses 的分组”；Claude Code 则确认支持 Messages。Cherry Studio、WorkBuddy 先确认支持 Chat Completions 的文字模型。
  • 密钥要完整复制，前后别多出空格或换行。不要贴进聊天、截图、GitHub 或项目文件。
这一步看哪里 · P1

先找“添加令牌”，再看窗口里的名称、分组、额度和保存按钮。保存后，列表里应该出现你刚起的名字。本步骤暂时没有本站实图。需要发截图问客服时，只拍名称、分组和状态，把整段密钥、账号和余额遮住。

Claude Code / Cherry New API 填这个地址
https://api.dxlingxiapi.top
Codex 的 Base URL
https://api.dxlingxiapi.top/v1

“模型 ID”就是模型的完整名称，要原样填写，不能只写 GPT 或 Claude。上面是本站 2026-10-05 公开列表中的示例，不保证每个分组都能用。你可以改成自己分组可用的名称，下面表格会跟着改；这里不需要填密钥。

选你要用的软件，别把所有工具都装一遍

你要用什么接入组合跟哪条教程
终端里的 CodexCodex CLI + CC Switch + DX API 令牌Codex 路线 A
Codex 官方桌面端官方 Codex 桌面应用 + Codex++ + DX API 令牌Codex 路线 B
终端里的 Claude CodeClaude Code + CC Switch + DX API 令牌Claude Code 教程
Cherry StudioCherry Studio + DX API 令牌Cherry Studio 教程
WorkBuddyWorkBuddy + DX API 令牌WorkBuddy 教程

供应商可以理解成“这次用谁提供的模型”，下面我们填 DX API。CC Switch 负责帮你保存和切换这些信息，Codex / Claude Code 才是实际干活的软件。Codex++ 则帮你管理和启动官方桌面应用，是第三方工具。同一个 Codex 只选一套管理方式，别同时用两个管理器切来切去。

在国内使用，先分清两件事

填中转站地址，是让模型请求走 DX API；它不是网络代理。CC Switch、Codex++ 都不会自动解决 GitHub 下载或官方安装服务打不开的问题。下载卡住时先处理下载连接，别反复改密钥，也别把 DX API 地址填进“网络代理”。软件的系统、地区和使用要求仍以各家官方说明为准。

用 CC Switch？先下载安装，再打开它

名字是 CC Switch，不是“CC Swich”。打开 作者官网，或者 作者的 v3.20.4 下载页。GitHub 下载页往下滚到 Assets，这里是安装包列表，不用下载 Source code。

  • Windows：普通 x64 电脑选 CC-Switch-v3.20.4-Windows.msi，ARM 电脑选带 arm64的包。不知道自己是哪种，就在“设置 → 系统 → 关于”看“系统类型”。下载后打开“文件资源管理器 → 下载”，双击安装包，按向导安装，再从开始菜单打开 CC Switch。
  • Mac：选 CC-Switch-v3.20.4-macOS.dmg，这一个包可用于 Intel 和 Apple 芯片。打开 Finder → 下载，双击 DMG，把 CC Switch 拖到 Applications（应用程序），再从“应用程序”打开它。CC Switch 要求 macOS 12 或以上；你要用的 Codex / Claude Code 还有各自的系统要求。
  • Linux：按下载页说明选适合自己系统和 CPU 的包。这里装在你平时工作的电脑上，不用装到宝塔服务器。

第一次打开，点左上角齿轮 → 关于。这里能看见已安装的工具及版本。没装 Codex 或 Claude Code 时，点它对应的安装，等进度结束，再点“刷新”。显示版本号后，才继续下面的接入步骤。

如果安装 Codex 或 Claude Code 时提示缺少 Node.js，打开 Node.js 官方下载页，按自己的系统选受支持的 LTS 安装包，双击按向导完成。关闭再打开 CC Switch，然后重试。显示“已安装·无法运行”时，先处理这条提示，不要往下填密钥。

Mac 还是 Monterey 12？下载 Node.js 前多看一眼

先点苹果菜单 → 关于本机，看系统版本。Node.js 24 的官方 Mac 安装包要求 macOS 13.5 或以上，Monterey 12 不要直接下载它。到上面的下载页，把版本选成22 分支，系统选 macOS，再下载 .pkg 安装包。22 分支在本页更新时仍处于 LTS，官方包最低要求是 macOS 11。

Node.js 能安装，不代表 Codex 本体所有功能都受支持。还要看 Codex 官方系统要求和 CC Switch 的运行检测；无法运行时先停下来，不用旧版软件硬试。系统兼容依据见 Node.js 官方说明和 22 分支系统要求。

CC Switch 主界面参考：1设置齿轮，2 Claude页，3 Codex页，4添加供应商。1234
作者参考图，版本不同，按钮位置可能稍有变化。只看入口，别抄图里的供应商和余额。
1设置齿轮2Claude Code3Codex4添加供应商
对照图找入口 · S1 / S2

先找图中①齿轮，进去后点“关于”看版本；回到主界面，再用②或③选择软件。要反馈安装问题，可以分别拍下载包文件名和“关于”里的检测结果，个人用户名遮住就好。

以前用过其他服务商？先留一份备份

点齿轮 → 高级 → 数据管理 →“导出 SQL 备份”，把文件保存在自己的电脑上。列表里原来的 default或官方卡片先别删，之后可以切回去。

如果以前自己改过配置，再复制一份原文件：Codex 的 config.toml和已有的 auth.json，Claude 的 settings.json。Windows 在文件资源管理器地址栏输入 %USERPROFILE%，找 .codex或 .claude文件夹；Mac 在 Finder 点“前往 → 前往文件夹”，输入 ~/.codex或 ~/.claude。没有的文件不用创建，复制即可，不需要编辑。

备份里可能有密钥和登录信息，只留在自己的电脑上，不发客服、不上传仓库。想保留原有 Codex 官方登录时，也先查看“设置 → 通用 → Codex 应用增强 → 非接管切换时保留官方登录”。

不知道“终端”在哪打开？看这里

Windows：点开始菜单，搜索 PowerShell，打开 Windows PowerShell 或终端里的 PowerShell 页。Mac：打开“应用程序 → 实用工具 → 终端”，也可以用 Spotlight 搜索“终端”。命令只粘贴到这个窗口，再按回车；不要粘贴进浏览器地址栏。

先在桌面建一个空文件夹，比如 DX-测试。Windows 打开它，在文件资源管理器的地址栏输入 powershell并回车；Mac 可右键点这个文件夹，选“服务 → 新建位于文件夹位置的终端窗口”。这样软件从测试文件夹启动，不会一上来就接触你的正式项目。

已经在用 WSL？要让管理器写到同一个地方

没用过 WSL 的新手可以跳过。Windows 和 WSL 是两套不同的目录：你在哪套终端运行 Codex / Claude Code，就要配置那一套。

若软件在 WSL 中运行，点 CC Switch 齿轮 → 高级 → 配置文件目录，改成对应路径，比如 \\wsl.localhost\Ubuntu\home\你的用户名\.codex或 \\wsl.localhost\Ubuntu\home\你的用户名\.claude。Ubuntu 和用户名换成你自己的，保存后重启 CC Switch，再从同一个 WSL 打开软件。如果以前自定义过 CODEX_HOME，也要指向同一目录。

Codex 接入 DX API

先选终端版或桌面版

在终端里用 Codex，就跟路线 A；想用官方桌面界面，就跟路线 B。选一条做就够了。开始前，确认你拿到的是能用目标 GPT 模型、支持 Responses 的 DX API 令牌。

路线 A：Codex CLI + CC Switch

CLI 就是终端版。CC Switch 帮你填接入信息，之后还是在终端里打开 Codex。

  1. 先在 CC Switch 里确认 Codex 装好了

    还没装 CC Switch，就先看上面的 下载安装步骤。打开后点齿轮 → 关于，找到 Codex。没有安装就点它旁边的“安装”，等结束，再点“刷新”。看到 Codex 的版本号，这一步就可以继续。

    若提示缺少 Node.js，先按上面的说明装好 Node.js LTS，再重开 CC Switch。安装失败先记下错误，别把 DX API 密钥填进安装窗口。想用官方方式安装，也可以看 Codex 官方安装说明。

    这一步看哪里 · CS1

    “关于”页里要看的是 Codex 那一行，不是 CC Switch 自己的版本。需要反馈时，拍这一行的版本号或错误提示，个人路径遮住。

  2. 回到主界面，点 Codex，再点加号

    1. 在顶部选 Codex，不是 Claude。
    2. 点右上角 +，打开添加供应商窗口。
    3. 在“应用专属供应商”里选自定义配置。
    4. 按下表填写。官网链接如果要填，可以填本站网址；真正发请求用的是“请求地址”这一栏。
    表单字段填写 / 选择
    供应商名称DX API · Codex
    API Key粘贴你刚创建的 Codex 专用令牌，不是网页登录密码
    请求地址 / Base URLhttps://api.dxlingxiapi.top/v1
    默认模型，换成自己令牌能用的完整名称
    高级选项 → 上游格式Responses（原生）
    完整 URL / 本地路由保持关闭，这次不用打开

    地址复制到 /v1就停，别再加 /responses。不要选 OpenAI 官方或 ChatGPT 登录；你这次用的是 DX API 密钥。如果旧版本只给你一个大配置编辑框，先升级到本页对应版本，不用自己写代码。

    这一步看哪里 · CS2

    主界面先看参考图的③ Codex、④加号。进入窗口后，依次找“自定义配置”、API Key、请求地址、默认模型和“高级选项”。窗口太长就往下滚。拍图求助时，密钥整段遮住，上下两张都保留窗口标题。

  3. 加一个模型，保存后再点“启用”

    1. 展开高级选项 → 模型映射，点“添加模型”。
    2. “菜单显示名”填 DX API GPT，这是你在菜单里看到的名字。
    3. “实际请求模型”填 ，要和上一步的默认模型完全一样。
    4. 其他看不懂的选项先保持原样。上下文窗口、思考等级不确定时留空或默认，不用勾 1M 等选项。
    5. 点添加。回到列表，找到 DX API · Codex，再点它的启用。

    看到“当前启用”再往下走。只添加卡片，还没有切换。管理器会帮你保存配置，不需要打开配置文件，也不要覆盖原来的登录文件。

    这一步看哪里 · CS3 / CS4

    填模型时对照“默认模型”和“实际请求模型”，两处名称要一样。返回列表后，看 DX API 卡片上有没有“当前启用”。反馈时拍这两处即可，别拍含密钥的配置文件。

  4. 重新打开 Codex，发一句话试试

    1. 原来已经开着 Codex 的，先完成或保存手头任务，再退出。不能只切卡片，让旧窗口一直开着。
    2. 在前面准备的空测试文件夹里打开一个新终端。输入 codex --sandbox read-only，按回车。这次只做只读测试。
    3. 打开后输入 /status，看当前供应商和模型是不是刚设置的 DX API 和目标模型。
    4. 发送：“只回复 DX API 接入成功，不读写文件，不执行命令。”
    5. 收到回复后，打开 DX API 的 使用日志，找同一时间、令牌名称和模型的成功记录。
    这一步看哪里 · CS5

    先看 /status 里的供应商和模型，再看新消息的回复，最后对照本站日志。要反馈时可以分三张拍，遮住目录、账号、IP 和密钥。只是管理器检测变绿，还不能当作 Codex 已经能回复。

    做到这里：Codex 有正常回复，DX API 也有对应的成功记录，这次文字连接才算确认。

路线 B：Codex 官方桌面端 + Codex++

这里用的是 BigPizzaV3 作者的 Codex++，按 v1.5.0界面来讲。它不是官方桌面应用，要把官方本体和 Codex++ 都装好。下面选“纯 API”，模型费用用 DX API 的额度。

  1. 先装官方本体，再装 Codex++

    打开 OpenAI 官方桌面下载说明，选适合自己系统的包，按安装向导完成，确认应用能打开。官方文档现在叫 ChatGPT desktop app，其中有 Codex 工作入口；要用 Codex++ 作者说明支持的版本。

    然后打开 Codex++ v1.5.0 下载页，往下找到 Assets，按电脑选择：

    • Windows x64：CodexPlusPlus-1.5.0-windows-x64-setup.exe。在“下载”文件夹里双击，按向导安装。其他 Windows 架构先看作者是否提供支持，不硬装 x64 包。
    • Intel Mac：CodexPlusPlus-1.5.0-macos-x64.dmg。
    • Apple 芯片 Mac：CodexPlusPlus-1.5.0-macos-arm64.dmg。不确定时，点屏幕左上角苹果菜单 → 关于本机，看写的是 Intel，还是 Apple M 系列芯片。

    Windows 安装后，从桌面或开始菜单先打开 Codex++ 管理工具，先别点 Codex++。Mac 双击 DMG，把 Codex++和 Codex++ 管理工具拖进“应用程序”，也是先开管理工具：这里填地址和密钥；填完后才从 Codex++ 入口启动。

    进入管理工具的安装维护，看它是否找到官方应用。没找到就点 选择应用目录 / 选择 Codex.exe，选你刚安装的官方应用；选好会自动保存，确认出现“应用路径已保存”，再看“保存的应用路径”是否正确。有 Intel 的 Codex++ 安装包，不等于官方本体支持 Intel 或 Monterey。官方应用不支持你的电脑时，走上面的终端路线 A。系统拦截安装时先核对来源，不要全局关闭安全检查。

    这一步看哪里 · CP1 / CP2

    下载前看文件名中的 x64 / arm64；装好后看“安装维护”里的官方应用路径和检测结果。需要反馈时拍这两处，个人用户名遮住。

  2. 打开切换开关，添加一个供应商

    在管理工具里选 Codex → 供应商配置。以前用过 Codex 的，先按上面的备份说明留一份原配置。然后打开启用供应商配置切换，点添加供应商。这次只加一个 DX API，不点“添加聚合供应商”。

    Codex++ 供应商页：1供应商配置，2启用切换，3添加供应商，4重启入口。1234
    作者参考图。只看入口；图里的“官方登录”卡片不是我们要选的“纯 API”。
    1供应商配置2启用切换3添加普通供应商4重启 Codex++

  3. 照着填地址、密钥和模型

    找到这个框这样填
    名称DX API · 桌面
    接入模式纯 API，不选“官方登录”或“混入 API Key”
    配置模型，用自己令牌能用的完整名称
    Base URLhttps://api.dxlingxiapi.top/v1
    Key粘贴自己的 DX API 令牌，保持遮挡
    上游协议Responses API
    Codex 会话身份Custom（默认），先保持原样
    1. 在模型列表点“添加模型”，名称也填 。也可以点“从上游获取”，再选同一个模型。
    2. 点更多选项，找到测试模型，仍填 。这样测试时不会用错模型。
    3. 检查“配置模型”“模型列表”“测试模型”，三处是同一个完整名称。其他选项先不动，也不要给名称加 [1M] 等后缀。
    这一步看哪里 · CP3 / CP4

    看“纯 API”、带 /v1 的地址、Responses API，再核对三处模型名称。表单过长就分上下两张拍，保留窗口标题，Key 整段遮住；不用打开配置文件拍图。

  4. 先点“保存供应商”，再点“使用”

    点右上角保存供应商。回到列表，找到 DX API · 桌面，点卡片上的使用；也可以重新进入卡片详情，点设为当前。看到使用中，再继续。

    如果点不了，先看“启用供应商配置切换”总开关有没有开。这里只保存不够，还得选成当前供应商。之后别再用 CC Switch 切同一个 Codex，避免互相改回去。

    这一步看哪里 · CP5

    回到列表，看总开关是开的，DX API 卡片显示“使用中”。需要反馈时拍这一页即可，密钥不要显示出来。

  5. 测试一次，再从 Codex++ 打开桌面应用

    1. 卡片旁边找试管图标，鼠标放上去会提示“发送 hi 测试”。点一次，等结果出来。成功再继续；失败就先停，检查地址、密钥和测试模型，记下错误提示。它会真的发请求，可能消耗少量 DX API 额度，别连续点。
    2. 保存手头任务，退出原来开着的官方桌面应用。
    3. 在管理工具里点启动 Codex++ / 重启 Codex++，或打开安装后的 Codex++入口。这次别点原来的官方快捷方式。
    4. 新建会话，选刚加入的模型。发送：“只回复 DX API 接入成功，不读取或修改文件。”
    5. 到 DX API 使用日志核对这次对话的时间、令牌和模型。
    这一步看哪里 · CP6 / CP7

    先看管理器测试结果，再看桌面会话里选中的模型和回复。两步要分别检查：试管测试成功，不代表桌面会话也成功。需要反馈时，把错误提示或回复和对应日志分开拍，遮住个人信息。

    做到这里：从 Codex++ 打开的桌面应用能回复，本站也有对应成功记录，才算桌面文字连接确认了。读写文件等能力还需要另外测试。
想切回原来的服务商，怎么操作？

CC Switch：回到 Codex 页，找到原来的 default / 官方卡片，点“启用”，退出并重新打开 Codex，再看 /status。

Codex++：先保存任务，在供应商列表对原卡片点“使用”，或进详情点“设为当前”，然后重启。选回“官方登录”后，用的是官方账号，不再走 DX API。

管理器出问题时先停止切换，按本机备份只恢复这次改过的文件；不确定就先求助。不要删除整个 .codex 文件夹或历史会话。

最后看这四项，别只看“保存成功”

照着检查，确认一项勾一项。这里只是给自己做备忘，不会替你调用模型。

本站记录看哪里 · P2

登录 DX API，打开 使用日志，找到刚才测试的时间。看令牌名称、模型和状态。要发截图时只保留这几项，账号、余额、IP、请求内容和密钥遮住。本页暂时没有本站成功调用实图，不拿其他软件的图代替。

报错了？先停一下，按提示找原因

一次只改一项，改完再试。要问客服，发软件版本、错误提示、模型名称和出错时间就够了，别发密钥。

401：密钥没通过，或提示 Invalid token / Unauthorized

回 DX API 的“API 密钥”页，确认令牌没停用、没到期。重新复制完整令牌，粘贴回软件的 API Key 框，前后别带空格，再保存并启用。

Claude Code 再看一次“认证字段”是不是选对了；不确定自己渠道用哪一种，就问客服。不要把密钥发过去，也不要打印出来截图。

403：没权限，或提示模型不可用

到令牌设置里看分组、模型限制、额度和有效期。模型广场能看到，不代表你的令牌一定能用。把令牌名称和目标模型告诉客服即可；不用为了试错反复充值。

404：地址不对，或跳到了登录页

回到对应教程，把地址重新复制一遍：Codex 带 /v1；Claude Code 和 Cherry New API 到 .top就停；WorkBuddy 用整条 /v1/chat/completions地址。

不要复制浏览器里的控制台地址或宝塔地址，也别让 /v1或 /chat/completions重复两次。

400：提到 tools、thinking、responses 或 messages

先把额外的图片、思考和工具选项恢复默认，核对你是否按对应软件选了上游格式。还报错就把软件版本、模型、分组和错误提示交给支持排查。不要把 Codex 随便改成 Chat Completions，或把 Claude Code 的模型换成 GPT 来碰运气。

429、503，或者一直超时

先停掉连续重试，看看本站日志和公告。可能是次数限制、容量不足或连接问题，单靠这条提示还不能确定原因。稍后再试一次，仍不行就联系支持。别开多个窗口一直重试，也别为了排错不停充值。

CC Switch 添加了，软件却还在用旧服务商

回到列表，先看 DX API 卡片是不是当前启用。只有“添加”不够，还得点“启用”。保存任务后，退出并重新打开 Codex / Claude Code。

仍没切换，再看有没有另一套 Codex++ 在改同一个 Codex，或软件其实在 WSL 里运行。CC Switch 出现黄色“环境变量冲突”提示时，先查看提示，不要点全选删除；详情可能有密钥，整页别发给客服。以前改过目录或启动设置的，先请支持一起核对，不用一键清空配置。

Codex++ 没有增强入口，或测试成功但桌面不能回复
  1. 到“安装维护”看官方应用是否被正确找到。
  2. 到“供应商配置”看总开关有没有开，DX API 是否显示“使用中”。
  3. 看配置模型、模型列表、测试模型是不是同一个名称。
  4. 保存任务后重启，这次从 Codex++入口打开，不是原官方快捷方式。

官方应用刚升级过，就再看作者是否已经适配。不要为了恢复菜单删历史会话或重置全部登录。

“本地路由”打开了，就能解决国内网络问题吗？

不能。它主要处理本机转发和接口格式，不是境外网络代理。本页用的接入方式先保持它关闭。GitHub、官方安装服务或外部工具打不开，要单独排查这些连接，不能把 DX API 地址当成网络代理服务器。

聊天能回复，但 WorkBuddy 或编程工具做不了任务

先确认目标模型和本站渠道确实支持工具调用。文字回复只说明聊天请求通了，还没证明文件、浏览器或表格工具能运行。用空测试文件夹做一次只读小任务，失败时拍实际错误交给支持，不要直接拿正式项目试。

下载和参考资料

页面与 2026-10-06 核对的资料一致，按 CC Switch v3.20.4、Codex++ v1.5.0 界面说明。版本不同，按钮位置可能变，以作者说明为准。

这七张图来自软件作者或官方文档，编号只用来帮你找按钮，不是本站成功调用截图。本站令牌创建页和成功日志实图还没补上，四款软件也尚未用本站付费令牌完整测完。收到普通文字回复，不代表图片、长任务和所有工具能力都已可用。