文档与帮助 / macOS / Linux 与 CLI
控制台 ↗
DUILIU · GET STARTED

一行命令,配好终端。

适用于 macOS 与常见 Linux 的 x64 / ARM64 系统。准备个人 API Key,其他配置由安装脚本完成。

推荐:一键安装

打开终端,执行下面的命令。脚本会提示输入一次 API Key,输入不会回显。

macOS / Linux 一键配置
curl -fsSL https://app.duiliu.uk/install.sh | bash
脚本只需要输入一次你的对六 API Key,输入不会回显。它会自动安装 Node.js LTS 和官方 Codex CLI、检查 Key、选择可用模型并写入配置。完成后输入 duiliu 启动。

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

下载后执行

也可以先保存脚本,再执行。下面的命令会下载到当前文件夹。

下载 install-codex.sh ↓
下载并运行
curl -fL https://app.duiliu.uk/install-codex.sh -o install-codex.sh
bash install-codex.sh

安装后怎么用

重新打开终端,输入 duiliu。在安装时的终端中,可以直接使用完整路径:

立即启动
~/.local/bin/duiliu

运行 duiliu --version 可检查安装结果。使用项目文件时,先 cd 进入项目目录。

Fast 模式

在项目目录运行:

以 Fast 启动
duiliu fast

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

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

配置和模型

脚本自动安装用户目录中的 Node.js LTS 和官方 Codex CLI,并为 Bash / Zsh 添加启动命令的路径。系统需已有 bash、curl、tar 和 SHA-256 校验工具。

  • 运行环境与 CLI:~/.local/share/duiliu。
  • 独立配置:~/.codex-duiliu/config.toml。
  • Key 文件:~/.codex-duiliu/api-key,权限为 600。

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

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

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

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

自动生成的配置示例
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

重新运行一键命令,再输入 Key。已有对六配置会先备份;脚本不会覆盖原来的 ~/.codex/config.toml。

需要切换模型时,编辑 ~/.codex-duiliu/config.toml 的 model 字段,也可以用 duiliu --model 模型ID 临时指定。

已有的 Claude Code / AnyRouter 配置

已有的 macOS / Linux AnyRouter 安装脚本仍可使用。它需要输入 AnyRouter 的 API Key,请使用该服务签发的 Key。

Claude Code / AnyRouter
bash -c "$(curl -fsSL https://app.duiliu.uk/install-claude-anyrouter.sh)"

完成后使用 claudea 启动。配置位于 ~/.claude-anyrouter/settings.json,可在其中修改模型。具体模型权限由 AnyRouter 决定。

常见问题

遇到连接或 TLS 握手超时,可查看 备用 HTTPS 接口与连接超时设置。已有 duiliu 命令可临时切换,无需重新安装或输入 Key。
现象处理方式
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;不要复制旧模型元数据来冒充新模型。

如果当前终端找不到 duiliu,先用 ~/.local/bin/duiliu 启动。Fish 等其他 Shell 可以直接使用这个完整路径。

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