使用前准备#

准备 Du API 账户、可用额度，以及支持 Responses 和工具调用的模型。令牌分组从你账户实际可选的项目中选择，不需要填写其他站点的分组名称。

步骤 1：安装桌面应用#

1. 打开 OpenAI 官方桌面应用页面，按你的系统下载安装。Windows 商店中的应用请核对发布者为 OpenAI；macOS 按官方页面选择安装包。
2. 首次启动后，按当前版本的界面选择 Codex 工作入口。部分版本的应用名称或入口可能显示为 ChatGPT，以官方下载页面和应用界面为准。
3. 先准备一个要测试的项目文件夹，后面会用它检查配置是否生效。

步骤 2：安装 CC Switch#

从 CC Switch 官方发布页选择你的操作系统对应的安装包。安装后打开 CC Switch，选择 Codex 客户端。

已有供应商配置时先保留它们，接下来为 Du API 新增一个供应商。不同版本的按钮名称可能略有区别。

步骤 3：创建令牌并导入配置#

1. 登录 Du API，进入「API 令牌」，创建一枚供 Codex 使用的令牌。
2. 填写名称，选择有目标模型可用的分组；如开启模型限制，把目标模型加入允许列表。保存令牌。
3. 在该令牌的操作菜单中找到「CC Switch」。弹窗中的应用选择「Codex」，名称填写「Du API」。
4. 主模型选择你已确认可用于 Responses 的模型，点击打开 CC Switch，并按浏览器提示确认打开应用。
5. 在 CC Switch 确认导入，检查地址和模型，然后启用该供应商。

步骤 4：重启应用并验证#

1. 确认 CC Switch 中 Du API 已启用。完全退出桌面应用后重新打开。
2. 按应用当前支持的登录 / 供应商入口完成接入，再添加测试项目文件夹。Du API 的账户密码只用于本站登录。
3. 新建会话，发送下面的问题，并在 Du API 用量日志中核对是否出现对应调用。

请说明这个项目的主要目录和启动方式。先只阅读现有文件，列出你的判断依据。

步骤 5：开始任务与查看修改#

第一次修改可以选择一个小任务，例如修改按钮文案。任务完成后查看变更内容，再在项目中运行对应检查。切换供应商或模型后，新建会话并核对实际使用的模型。

CLI 和桌面入口的配置读取、登录方式与可用能力，需结合安装版本确认。只在终端临时设置的环境变量，通常不会自动传给已经打开的桌面应用。

常见问题#

使用前确认#

需要账户中有可用于 Claude Code 的模型与渠道，并确认 Anthropic Messages、流式和工具调用兼容性。请取得准确模型 ID；普通聊天成功不能单独证明编程客户端的全部能力可用。

步骤 1：安装 Claude Code#

Windows 原生安装按官方说明准备 Git for Windows；macOS / Linux 使用各自终端。下面是官方原生安装命令。安装结束后重新打开终端。

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.sh | bash

claude --version
claude doctor

也可使用 CC Switch 配置#

已安装 CC Switch 时，可从 Du API 令牌操作菜单导入 Claude 配置。选择正确应用和主模型，确认导入后启用供应商，再从新终端运行 claude。

步骤 2：配置 Du API 地址与令牌#

下面的环境变量仅对当前终端及从它启动的程序生效。将 YOUR_API_KEY 替换为Du API令牌，并把模型占位符改成已开通的 Claude 模型。

export ANTHROPIC_BASE_URL="https://duapi.cc"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="YOUR_CLAUDE_MODEL"

$env:ANTHROPIC_BASE_URL = "https://duapi.cc"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "YOUR_CLAUDE_MODEL"

若已有 ANTHROPIC_API_KEY、其他供应商变量或旧网关配置，先检查它们的来源，避免同时发送多套凭证。需要长期保存时，合并到用户级设置文件，不要覆盖已有设置，也不要提交到项目仓库。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://duapi.cc",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL"
  }
}

步骤 3：启动并核对请求#

claude

先发送一句简单问题，再尝试读取一个测试文件。按客户端提示确认凭证和权限，随后在Du API「用量记录」中检查请求模型与消费。更换变量或设置文件后，退出并重新启动客户端。

若出现登录、模型不存在、令牌计数或工具调用错误，保留错误文本和版本号，检查配置来源与渠道兼容性。不要通过修改内部 onboarding 文件绕过客户端流程。

步骤 1：安装与选择客户端#

从官方发布页安装 CC Switch。打开后选择要配置的客户端，例如 Claude Code 或 Codex。先选择客户端，再添加供应商。

方式一：从 Du API 一键导入#

1. 进入 Du API 的「API 令牌」页面，找到要使用的令牌。
2. 在令牌操作菜单选择「CC Switch」。
3. 选择目标应用，名称填写「Du API」，主模型选择账户可用的对应模型。
4. 点击打开 CC Switch，确认导入并启用供应商。
5. 重启目标客户端，发送简短请求，在本站用量日志核对。

方式二：手动添加供应商#

若没有一键导入入口，在 CC Switch 中新增自定义供应商。名称填写 Du API，密钥使用本站令牌，地址和协议按目标客户端分别填写。

启用与排查#

保存不一定等于启用，检查当前供应商是否确实选中。若开启本地代理或接管模式，也要检查代理状态。重启客户端后仍未生效，核对环境变量、项目配置和客户端内的覆盖项。

步骤 1：安装并初始化#

按 OpenClaw 官方安装和初始化教程准备运行环境。首次接入先完成模型对话测试，再逐步启用其他工作流。

步骤 2：获取 API 令牌#

在 Du API 创建一枚独立令牌，并确认目标模型支持 OpenAI 兼容聊天和需要的工具调用。将令牌配置到运行 OpenClaw 的环境中。

export DUAPI_API_KEY="YOUR_API_KEY"

$env:DUAPI_API_KEY = "YOUR_API_KEY"

步骤 3：合并供应商配置#

编辑用户目录下的 .openclaw/openclaw.json，合并下列配置，保留已有设置。将两处 YOUR_CHAT_MODEL 改为同一个实际模型 ID。

{
  "models": {
    "mode": "merge",
    "providers": {
      "duapi": {
        "baseUrl": "https://duapi.cc/v1",
        "apiKey": "${DUAPI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "YOUR_CHAT_MODEL",
            "name": "Du API · YOUR_CHAT_MODEL"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "duapi/YOUR_CHAT_MODEL"
      }
    }
  }
}

本例采用 OpenAI Chat Completions 协议。需要其他协议时，按 OpenClaw 对应供应商说明配置，并确认本站渠道支持。作为后台服务运行时，令牌变量需要在服务环境中设置。

步骤 4：检查配置与请求#

openclaw doctor
openclaw models list

按你的运行方式重载或重启 OpenClaw，再发起一次简单问答，并到 Du API 用量日志核对。需要连续调用工具的工作流，应进一步测试相应模型能力。

可选：连接聊天渠道#

QQ、飞书等消息渠道在 OpenClaw 自身配置，它们的应用凭证和 Du API 模型令牌用途不同。先完成模型接入，再按所用 OpenClaw 版本的渠道教程操作。

1. 安装官方扩展#

在 VS Code 扩展市场搜索 Claude Code，确认发布者为 Anthropic，再安装官方扩展。先阅读 Claude Code 教程，确认所选 Claude 渠道满足客户端协议要求。

2. 配置用户设置#

按 Claude Code 教程把网关地址、令牌和模型合并到用户级 ~/.claude/settings.json。Windows 对应用户目录的 .claude/settings.json。该文件会被 CLI 与扩展共享读取的范围，以官方说明为准。

通过扩展设置配置环境变量时，使用当前版本提供的 Claude Code 环境变量设置入口。终端中临时 export 的变量，只会传给从该终端启动的子进程；已打开的 VS Code 不会自动获得它们。

3. 重启并验证#

1. 重新加载 VS Code 窗口或重启扩展会话。
2. 打开 Claude Code 面板，按扩展提示完成凭证确认。
3. 发送简单问题，再测试读取一个非敏感文件。
4. 在Du API用量记录核对请求；失败时一并提供扩展版本和脱敏后的错误信息。

若扩展版本不支持当前网关的认证方式，可先在 VS Code 集成终端按 Claude Code CLI 教程验证连接，再参考官方扩展文档排查。

步骤 1：进入模型设置#

1. 在 Du API 创建令牌，确认分组和目标模型可用。
2. 打开 Trae 的「设置 → 模型」，点击「添加模型」。
3. 选择「自定义模型」，准备填写 API 格式、地址、模型 ID 和令牌。

步骤 2：配置 OpenAI 兼容模型#

两种地址写法根据开关选择一种。若模型只支持 Responses，不能仅凭修改名称就作为 Chat Completions 模型接入。

Anthropic / Claude 模型配置#

Gemini 等兼容模型#

若 Du API 的对应模型通过 OpenAI 兼容渠道提供，可按上面的 Chat Completions 方式填写，并使用该模型的准确 ID。不要将 Chat Completions 地址直接当作原生 Google 接口。协议支持情况以当前渠道为准。

步骤 3：启用并验证#

1. 保存配置，按界面提示检查连接结果。
2. 在模型列表启用新增模型，再在对话中选中它。
3. 先执行一个简单问答，并到 Du API 用量日志核对。

出现 404 时检查 API 格式、完整 URL 开关和最终路径；鉴权错误检查令牌与权限。客户端版本不同，字段以实际界面为准。

1. 添加模型服务商#

1. 安装并打开 Cherry Studio，进入设置中的模型服务商页面。
2. 添加自定义服务商，名称填写「Du API」，类型选择 OpenAI 兼容类型。
3. API 地址填写 https://duapi.cc/v1；若界面自动补全 /v1，检查最终预览地址只包含一次 /v1。
4. API Key 填写Du API的完整 API 令牌，然后启用该服务商。

https://duapi.cc/v1

2. 添加模型并测试#

先尝试获取模型列表；若当前版本没有获取入口或列表为空，去Du API模型广场复制准确的模型 ID，手动添加模型。展示名称可以自定义，模型 ID 必须保持准确。

1. 选择支持聊天的模型，确认视觉、工具等能力按实际模型设置。
2. 新建会话，选择Du API下的模型，先发送普通文本。
3. 确认对话正常后，再按渠道能力测试图片输入或工具调用。

地址和能力排查#

404 通常需要检查路径是否拼成 /v1/v1/chat/completions，或误填了网页控制台地址。401 检查密钥和空格；模型不存在时检查分组、名称及令牌模型限制。

本教程采用 OpenAI 兼容聊天接入方式。服务商可连接不代表其中所有模型都支持图像生成、联网或工具调用；这些能力需单独确认。

使用前确认#

需要支持 Responses、工具调用和流式事件的模型渠道。模型通过 Chat Completions 返回文字，不足以证明它能用于 Codex。请向运营方确认准确的 Responses 模型 ID，并替换示例中的占位符。

1. 安装 CLI#

先安装 Node.js 的受支持版本并确认 node、npm 可用，再运行官方 npm 安装命令。Windows 的终端或 WSL 选择，以官方当前安装要求为准。

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

2. 设置令牌与供应商#

export DUAPI_API_KEY="YOUR_API_KEY"

$env:DUAPI_API_KEY = "YOUR_API_KEY"

编辑用户配置 ~/.codex/config.toml；Windows 为用户目录下的 .codex/config.toml。保留已有配置，把下面顶层字段放在任何 [表名] 之前，并合并供应商配置。若设置了 CODEX_HOME，以实际目录为准。

model = "YOUR_RESPONSES_MODEL"
model_provider = "duapi"

[model_providers.duapi]
name = "Du API"
base_url = "https://duapi.cc/v1"
env_key = "DUAPI_API_KEY"
wire_api = "responses"

密钥通过环境变量读取，不需要写进 config.toml。若使用 profile 或项目级配置，检查实际选中的供应商与模型是否仍为上述配置。

3. 启动与验证#

codex

先执行简单问答，再在测试目录尝试一次只读文件操作。确认Du API用量记录中有对应请求。出现 404 时检查 /v1 是否重复以及渠道是否开放 Responses；遇到流式或工具事件错误时请运营方验证协议。

1. 准备账户与模型#

打开 Du API 主站注册并登录。邮箱验证、找回密码和其他验证方式，以当前页面提示为准。先到模型广场查看模型与价格，再到钱包确认账户有可用额度。

账户密码用于登录；API 令牌用于程序调用，两者不能互相替代。所有示例中的 YOUR_API_KEY 和 YOUR_*_MODEL 均需替换为你自己的令牌与可用模型 ID。

2. 记住这三个配置#

https://duapi.cc/v1

3. 发送第一条请求#

以下是 macOS / Linux / WSL 的 Bash 示例。先把 YOUR_API_KEY 换成Du API令牌；示例模型 YOUR_CHAT_MODEL 也应与模型广场一致。

export DUAPI_API_KEY="YOUR_API_KEY"

$env:DUAPI_API_KEY = "YOUR_API_KEY"

curl "https://duapi.cc/v1/chat/completions" \
  -H "Authorization: Bearer $DUAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_CHAT_MODEL","messages":[{"role":"user","content":"你好，请用一句话介绍自己。"}]}'

$headers = @{ Authorization = "Bearer $env:DUAPI_API_KEY" }
$body = @{ model = "YOUR_CHAT_MODEL"; messages = @(@{ role = "user"; content = "你好，请用一句话介绍自己。" }) } | ConvertTo-Json -Depth 6
Invoke-RestMethod -Uri "https://duapi.cc/v1/chat/completions" -Method Post -Headers $headers -ContentType "application/json; charset=utf-8" -Body ([System.Text.Encoding]::UTF8.GetBytes($body))

收到 choices 中的回复后，前往「用量记录」核对模型、状态与消费。若失败，保留错误信息和请求时间，按「常见问题」排查。

创建和查看令牌#

1. 打开「API 令牌」，点击「创建令牌」，为应用填写可识别的名称。
2. 选择当前账户已开放的使用分组；只有 default 时，表示管理员尚未向此账户开放其他分组。
3. 按需勾选「限制可调用模型」并选择模型；不勾选时可调用所选分组内全部已开放模型。
4. 创建成功后，在该行点击「查看密钥」，复制完整密钥；以后也可从这里重新查看。
5. 将密钥放在客户端的 API Key 字段或服务器环境变量中。不要把登录密码填在这里。
6. 每个应用单独创建一枚令牌，便于按应用核对用量与撤销权限。

不同协议怎样填地址#

地址可访问不代表所有协议都已开通。模型、渠道、账户分组和令牌权限共同决定能否调用。以模型广场及运营方确认的协议为准。

额度、权限与撤销#

• 令牌额度与账户可用额度都需要满足。具体额度、有效期、分组和模型限制，以令牌页面的配置为准。
• 每个应用单独创建令牌，便于核对用量与单独停用。按需设置有效期和 IP 限制。
• 密钥保存在本地客户端或服务端环境变量中，不要写进公开网页前端、截图、群聊或公开仓库。
• 怀疑泄露时立即停用或删除旧令牌，再创建新令牌并更新应用。反馈问题不需要提供完整密钥或登录密码。

准备环境变量#

以下 Python 和 Node.js 示例使用 OpenAI 兼容 SDK。先在终端设置令牌和地址，再从同一个终端运行程序。模型须来自模型广场，密钥只保留在服务器或本地受信任环境。

export DUAPI_API_KEY="YOUR_API_KEY"
export DUAPI_BASE_URL="https://duapi.cc/v1"

$env:DUAPI_API_KEY = "YOUR_API_KEY"
$env:DUAPI_BASE_URL = "https://duapi.cc/v1"

curl "https://duapi.cc/v1/models" \
  -H "Authorization: Bearer $DUAPI_API_KEY"

Python · 文本对话#

python -m pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DUAPI_API_KEY"],
    base_url=os.environ["DUAPI_BASE_URL"],
    max_retries=0,
    timeout=120.0,
)
result = client.chat.completions.create(
    model="YOUR_CHAT_MODEL",
    messages=[{"role": "user", "content": "用一句话介绍Du API。"}],
)
print(result.choices[0].message.content)

Node.js · 流式对话#

npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.DUAPI_API_KEY,
  baseURL: process.env.DUAPI_BASE_URL,
  maxRetries: 0,
  timeout: 120_000,
});
const stream = await client.chat.completions.create({
  model: "YOUR_CHAT_MODEL",
  messages: [{ role: "user", content: "用一句话介绍Du API。" }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
process.stdout.write("\n");

流式响应使用 SSE；处理程序应逐块读取数据，不能直接对整个响应执行 response.json()。自行部署反向代理时关闭流式路径的响应缓冲，并配置足够的超时。

Responses 协议#

先确认所选渠道支持 Responses，再替换模型占位符。Responses 的请求字段和返回结构与 Chat Completions 不同。

curl "https://duapi.cc/v1/responses" \
  -H "Authorization: Bearer $DUAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_RESPONSES_MODEL","input":"你好，请用一句话回复。"}'

Responses 与 Chat Completions 的请求字段和流式事件不同；请按所选 SDK 与模型协议编写处理逻辑。

超时、重试与请求记录#

示例关闭 SDK 自动重试，便于核对每次提交。网络断开或客户端超时，不一定代表上游没有执行；重试前先查看用量日志，再按业务设置有限重试。

模型价格与额度#

在模型广场查看当前模型与计费说明，登录后结合实际使用分组核对价格。输入、输出、缓存和特殊能力可能采用不同计费规则，最终以页面展示和用量记录为准。

钱包显示的额度单位与实际支付币种需要分别核对。支付金额、兑换比例、手续费及到账额度，以当次订单展示为准。

充值与兑换#

1. 打开钱包，选择当前站点已开放的支付方式或兑换码入口。
2. 确认金额、支付币种与到账额度，再提交订单并完成支付。
3. 支付后返回本站，刷新余额和充值记录，确认原订单状态。
4. 未到账时保留订单号、支付时间与脱敏凭证，通过运营方提供的渠道反馈。

核对用量与异常消费#

通过用量日志按时间、模型和令牌核对调用。可见字段随权限及站点设置变化。遇到疑似异常消费，提供准确时间、模型 ID、令牌名称和请求 ID（如有），由运营方核对。

客户端显示失败、网络中断和上游执行失败并不总是同一情况。消费与账单调整需要结合原请求及实际用量核对。

按错误快速定位#

HTTP 状态只是线索，实际处理应结合响应中的 message、code 和请求 ID。不要仅凭一个状态码判定收费或退款。

配置已填对，为什么仍不能用#

• 检查当前会话实际选择的服务商和模型。
• 检查旧环境变量、配置文件、项目设置和切换工具是否覆盖新配置，修改后重启客户端。
• Chat Completions、Responses 和 Anthropic Messages 的格式不同，需要渠道支持所选协议。
• 模型名称、分组、令牌限制和渠道临时故障都可能影响请求。
• 远程开发、容器和手机里的 localhost 指向该环境自身，请使用本站 HTTPS 域名。
• 收不到验证邮件时，检查邮箱拼写和垃圾邮件；仍收不到，可由运营方核对发信配置和发送记录。

联系支持前准备#

• 出错的准确时间和时区、客户端名称和版本、操作系统。
• 所用模型 ID、协议、API 地址与复现步骤。
• 脱敏后的错误文本、请求 ID 或充值订单号。
• 截图与日志中移除 API Key、Cookie、Authorization、密码和个人信息。

请通过主站公告或运营方提供的渠道反馈。支持人员排查问题不需要你的登录密码或完整 API 密钥。

按场景开始#

客户端配置前检查#

• 先用快速开始的最小请求验证令牌和基础网络。
• 确认目标模型确实支持所需协议。能聊天并不能证明能运行编程 Agent。
• 安装客户端官方版本。不同版本字段可能变化，界面名称以安装版本为准。
• 同一工具尽量保留一个生效配置来源，避免环境变量、配置文件和切换工具互相覆盖。