一键接入
用 dingjiai CLI 配置已安装的 Codex 或 Claude Code。
这是配置器，不是安装器
dingjiai 只配置本机已经安装的 Codex 或 Claude Code，不安装 Node.js、客户端或系统依赖。固定组合 dingjiai@1.0.10 + zcf@3.6.8 需要 Node.js 20 或更高版本。
开始使用
npx -y dingjiai@1.0.10按提示输入顶级AI用户 API Key。交互输入只避免 Key 出现在顶层 shell history；dingjiai@1.0.10 仍会把 Key 作为参数传给 zcf@3.6.8 子进程，因此运行期间会短暂出现在该子进程的 argv / 本机进程检查中。共享机器上不要把命令输出或进程列表暴露给其他用户。
只配置一个客户端：
npx -y dingjiai@1.0.10 --only codex
npx -y dingjiai@1.0.10 --only claude先看计划、不请求模型列表也不写配置：
npx -y dingjiai@1.0.10 --only claude,codex --dry-run它会做什么
正式执行时，CLI 会检测已安装客户端，在线检查用户 Key 和模型列表，选择默认模型，再调用固定版本的外部 npm 配置器 zcf@3.6.8。版本组合是 dingjiai@1.0.10 + zcf@3.6.8；命令预览和本页说明都不能替代执行前检查发布包。
| 客户端 | 主要写入、合并与备份范围 |
|---|---|
| Codex | 写入或合并 ~/.codex/config.toml 和明文 ~/.codex/auth.json；ZCF 完整初始化还可能备份并改写 ~/.codex/AGENTS.md、写入 ~/.codex/prompts/、合并 MCP 配置，并更新 ~/.ufomiao/zcf/config.toml。检测到已安装 Codex 有新版时，ZCF 可能自动更新。 |
| Claude Code | 先把现有 ~/.claude/ 备份到其 backup/，再合并 ~/.claude/settings.json，写入模型与 API 环境变量，并可能写入 ~/.claude/CLAUDE.md、~/.claude/config.json、~/.claude.json 和 ~/.ufomiao/zcf/config.toml。直接 api_key 路径会设置完成 onboarding 和 primaryApiKey；它不会保证同步修改 customApiKeyResponses。检测到已安装 Claude Code 有新版时，ZCF 也可能自动更新。 |
本组合以 skip-prompt 调用 ZCF，并显式要求跳过 Claude Code 的 MCP、workflow、output style 和状态栏选项，但 Codex 的完整初始化仍可能产生上表中的 AGENTS、prompts 和 MCP 副作用；两种客户端都可能被自动更新。它不修改系统级环境变量，并会在自身输出中脱敏 Key；这不等于 Key 从未进入子进程参数。更新全局安装时需要对应目录的写权限，部分 Linux 环境可能调用 sudo 或要求提权。正式写入前应阅读终端预览，并先自行备份现有用户配置。
模型与验证
dingjiai@1.0.10 的 Claude 在线检查读取 Anthropic 模型列表；Codex 在线检查读取 /v1/models，该列表只代表 OpenAI Chat Completions API，不能证明模型已经发布到 Responses 调用入口。因此 Codex 的自动选择或在线校验通过后，仍需在控制台确认同一 public model id 已在 OpenAI Responses 调用入口下启用；手工指定模型也遵循这一限制。
--skip-verify 会跳过在线 Key 与模型验证，仅适合你明确知道离线写入后果的场景；普通接入不要使用。
本机密钥文件
- Codex Key 以明文 JSON 写入
~/.codex/auth.json。 - Claude Code Key 写入
~/.claude/settings.json的环境配置。 - 这些文件应仅允许当前本机用户读取；不要放入同步盘、配置备份、仓库或问题截图。备份前先确认备份系统会加密并限制访问。
排查
- 未检测到客户端：先安装并至少启动一次对应客户端。
- Key 验证失败：确认使用的是顶级AI用户 API Key，不是上游 provider Key。
- 没有可选模型商品：检查账号余额和模型权限；Codex 还要单独确认所选模型商品已在 Responses 调用入口发布。
- 配置后仍走旧地址：完全退出并重启客户端。
已发布版本和完整参数以 npm 与命令帮助为准：
npx -y dingjiai@1.0.10 --version
npx -y dingjiai@1.0.10 --help最后更新于