推荐:一键安装
打开终端,执行下面的命令。脚本会提示输入一次 API Key,输入不会回显。
curl -fsSL https://app.duiliu.uk/install.sh | bash
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 模式
在项目目录运行:
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。
bash -c "$(curl -fsSL https://app.duiliu.uk/install-claude-anyrouter.sh)"
完成后使用 claudea 启动。配置位于 ~/.claude-anyrouter/settings.json,可在其中修改模型。具体模型权限由 AnyRouter 决定。
常见问题
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 可以直接使用这个完整路径。