文档与帮助 / 使用文档
控制台 ↗
DUILIU · GET STARTED

输入 Key,就能开始。

选择你的系统,复制一行命令。安装和配置由脚本自动完成,也可以下载脚本后再执行。

一键安装与配置

脚本只需要输入一次你的对六 API Key,输入不会回显。它会自动安装 Node.js LTS 和官方 Codex CLI、检查 Key、选择可用模型并写入配置。完成后输入 duiliu 启动。

Windows 会额外创建桌面与开始菜单快捷方式。下载依赖时请等待完成;全程无需手动填写地址、模型或配置文件。

Fast 模式

在项目目录运行:

以 Fast 启动
duiliu fast

这次启动会开启 Codex 原生 Fast,沿用已配置的模型与 API Key。普通启动使用 duiliu。已进入 Codex 时,也可以使用 /fast 切换。

提速幅度会受模型、上下文和排队情况影响。日志中的“已请求”表示已发送 Fast 参数,“已确认”表示上游明确返回 Fast 档位;当前 Codex 上游可能仍回报默认档位,需结合实际耗时判断,不能单凭该字段断定是否提速。

先准备 API Key

  1. 登录对六;没有账号可先 注册。
  2. 进入 API 密钥 页面,创建并复制个人密钥。
  3. 运行脚本,在出现提示后粘贴 Key 并按回车。

Key 不用写进安装命令,也不要发送给别人。

其他客户端的配置

配置项填写内容
服务商OpenAI / OpenAI Compatible
Base URLhttps://app.duiliu.uk/v1
API Key你在 API 密钥 页面创建的个人 Key
模型从 GET /v1/models 返回列表中复制完整模型 ID。也可以先查阅 模型目录。

API 地址包含 /v1;不要填写控制台、登录页或文档页地址。最终可用模型以你的 Key 的权限为准。

Codex 配置与模型

脚本优先使用 gpt-6-astra;若此 Key 无权使用,会依次选择列表中可用的 gpt-6.1-sol、gpt-6-sol 或 gpt-6-luna。如果都不可用,脚本会停止并提示检查密钥权限。

配置使用 Responses API。安装器只读取模型列表并检查 --version,不会发送聊天或图像生成请求。第一次使用时,Codex 仍可能提示确认项目目录与权限。

自动生成的配置示例
model = "gpt-6-astra"
model_provider = "duiliu"
forced_login_method = "api"
model_reasoning_effort = "high"

[model_providers.duiliu]
name = "Duiliu"
base_url = "https://app.duiliu.uk/v1"
env_key = "DUILIU_API_KEY"
wire_api = "responses"
supports_websockets = false

脚本会把你的 Key 交给 DUILIU_API_KEY,配置文件本身不包含密钥。日常使用 duiliu 启动。

如何验证

安装成功时会显示 Codex 版本、所选模型和启动方式。你还可以运行下面的命令检查客户端是否能启动。

检查已安装的 CLI
duiliu --version

然后进入你的项目目录,运行 duiliu 开始使用。模型是否能完成任务,需要实际发起请求后确认。

密钥权限与额度

同一个模型可能只对部分密钥分组开放。以当前密钥查询 /v1/models 的结果为准,余额和使用情况请到控制台查看。

一键安装不会创建新密钥,不会充值或更改你的账户额度。

配置保存与更新

脚本把对六配置保存在独立的 ~/.codex-duiliu 目录,启动命令只在自己的进程里使用它。之前的 Codex 配置和登录文件继续保留。

重复执行时会备份已有的对六配置到该目录的 backups 子目录。Windows 的 Key 使用当前用户的 DPAPI 加密保存;macOS / Linux 的 Key 文件仅当前用户可读写。

连接与超时排查

如果连接 app.duiliu.uk 时卡在 TLS 握手、HTTP 请求还未发出,可以临时使用以下 IPv4 HTTPS 备用接口。沿用本站 API Key、模型和推理设置。

备用 Base URL
https://app.duiliu.uk/v1

该地址使用受信任的 HTTPS 证书,客户端应保持正常证书校验。填写完整的 /v1 地址。

已有 Codex 安装:临时切换

在项目目录执行下面的命令,仅本次启动使用备用接口。无需重新安装,也无需再次输入 Key。

临时使用备用接口
duiliu -c model_providers.duiliu.base_url=https://app.duiliu.uk/v1

客户端:分别设置连接和生成超时

连接失败不必一直等待生成超时。下面的 Python SDK 示例把连接阶段限制为 8 秒,响应读取等待保持 120 秒。如果你原来的生成等待时间更长,请沿用原值。

Python SDK 超时配置
import httpx
from openai import OpenAI

client = OpenAI(
    base_url="https://app.duiliu.uk/v1",
    api_key="YOUR_API_KEY",
    timeout=httpx.Timeout(
        connect=8.0, read=120.0, write=30.0, pool=10.0
    ),
)

无需降低模型、推理强度或输出上限。此处的读取超时用于等待网络数据,不是给整个生成过程设置 120 秒总时长。

流式输出开始后,不要自动重发整次请求;应等待协议的完成事件,例如 Responses API 的 response.completed。正文最后一段到达,并不代表完整响应已经结束。

常见问题

现象处理方式
401 / Key 验证失败确认输入的是本站个人 API Key,复制时不要包含空格。重新执行安装命令可更换 Key。
没有可用模型 / 403检查密钥分组与模型限制;模型目录列出的模型未必全部对当前 Key 开放。
下载失败检查终端能否访问本站、nodejs.org 与 registry.npmjs.org,然后重新执行。公司网络可能需要已有代理。
找不到 duiliu关闭并重新打开终端。Windows 也可双击桌面的 Duiliu Codex 快捷方式。
404 / 地址不存在普通客户端的 Base URL 应为 https://app.duiliu.uk/v1;文档入口为 /docs。
429 / 超额或限流查看账户余额、密钥限额和服务状态,稍后再试。重新安装不会重置额度。
Codex 模型不识别重新运行安装脚本升级官方 CLI;不要复制旧模型元数据来冒充新模型。

更新于 2026-10-23 · 配置参考 OpenAI 官方文档