一键接入
用 npx 一键把已安装的 Codex 或 Claude Code 接入顶级AI。
先装客户端，再运行接入命令
dingjiai 是网关配置器，不是客户端安装器。它只配置本机已经安装好的 Codex 或 Claude Code，不会安装 Node.js、Codex、Claude Code，也不会请求管理员权限。
推荐命令
本机已经安装 Node.js 18 或更高版本后，打开终端运行：
npx -y dingjiai按提示输入顶级AI用户 API Key。也可以把 key 直接传进去：
npx -y dingjiai -k sk-你的用户APIKey共享机器上优先使用交互输入；-k 可能进入 shell history，并会作为本机子进程参数短暂可见。
只配置某一个工具：
npx -y dingjiai -k sk-你的用户APIKey --only codex
npx -y dingjiai -k sk-你的用户APIKey --only claude先预览、不写入任何配置：
npx -y dingjiai -k sk-你的用户APIKey --only claude,codex --dry-run它解决什么
Codex 和 Claude Code 的本地配置位置、协议入口和模型字段不一样。手动接入时，用户容易把 Base URL、API Key、模型名或协议路径填错。
dingjiai 做的事情很窄：
检测本机已安装的 Codex / Claude Code
-> 读取一次顶级AI用户 API Key
-> 请求顶级AI模型列表，确认 key 和可用模型
-> 按内置优先级选择默认模型
-> 调用 zcf 写入对应客户端配置默认不传 --only 时，它只配置检测到已经安装的客户端。传 --only claude,codex 时，会按你指定的客户端处理；如果正式写入时某个客户端没安装，该客户端会失败并提示。
会写入什么
当前 dingjiai 通过固定版本的 zcf@3.6.8 写入配置。它传给 zcf 的目标是：
| 客户端 | Base URL | 可能修改的本地配置 |
|---|---|---|
| Claude Code | https://dingjiai.com/anthropic | ~/.claude/settings.json |
| Codex | https://dingjiai.com/v1 | ~/.codex/config.toml、~/.codex/auth.json |
写入内容主要包括：
- 顶级AI用户 API Key。
- 顶级AI Base URL。
- 默认模型。
- Claude Code 的
primary、haiku、sonnet、opus模型槽位。
dingjiai 会要求 zcf 跳过 MCP、workflows、output styles 和状态栏工具配置。但 zcf 是外部工具，实际写入行为以 zcf 当前版本为准；如果你非常在意已有本地配置，先跑 --dry-run 看计划，再决定是否继续。
它不会做什么
- 不安装 Codex 或 Claude Code。
- 不安装 Node.js、Git、Python 等系统依赖。
- 不修改系统级环境变量。
- 不申请管理员权限。
- 不删除你的客户端配置。
- 不把完整 API Key 打印到摘要里。
注意：API Key 会作为本机 zcf 子进程参数传入，并写入对应客户端配置文件；这是客户端后续调用顶级AI所必需的。
模型怎么选
正式写入且没有传 --skip-verify 时，命令会先请求模型列表：
GET https://dingjiai.com/v1/models
Authorization: Bearer sk-你的用户APIKey
GET https://dingjiai.com/anthropic/v1/models
x-api-key: sk-你的用户APIKey
anthropic-version: 2023-06-01然后只从返回的可用模型里选择默认模型。当前内置优先级由 npm 包里的 model-priority.json 决定；如果优先级里的模型不可用，就使用接口返回的第一个可用模型。
你也可以手动指定模型：
npx -y dingjiai -k sk-你的用户APIKey --codex-model gpt-5.5
npx -y dingjiai -k sk-你的用户APIKey --claude-model claude-sonnet-4-6这里的模型名是顶级AI模型名示例，以控制台和模型列表返回为准。手动指定的模型必须在对应模型列表里可用，否则命令会拒绝写入。
写入前确认
在普通交互式终端里，命令会先显示配置预览，再询问是否写入：
确认写入以上配置？ (y/N)输入 y 才会调用 zcf 写配置。--dry-run 只打印预览命令，不请求模型列表，也不写文件。
以下安全行为需新版 CLI
非 TTY 默认拒写、key 输入不回显是较新 dingjiai 版本才有的行为。运行 npx -y dingjiai --version 确认版本；较旧版本在无 TTY 时仍可能直接写入配置、且交互输入 key 时会明文回显。共享机器/CI 上如不确定版本，先跑 --dry-run 预览、并避免用 -k 传 key。
非交互环境（管道、CI、无 TTY）里不会有确认提示，此时命令默认拒绝写入并退出，除非显式传入 --yes 明确同意；这样脚本化调用不会在无人确认的情况下改动本地配置。
交互式输入 API Key 时不回显字符（不打印到终端、不进入 shell history）。共享机器上仍应优先交互输入，避免用 -k 传 key（它会作为子进程参数短暂可见）。
常见排查
- 提示未检测到客户端：先安装 Codex 或 Claude Code，再重新运行。
- 提示 API Key 验证失败：检查是否复制了顶级AI用户 API Key，不要填写上游 provider key。
- 提示没有可用模型：登录控制台确认账号可用模型、余额和权限。
- 配置后工具仍走旧地址：重启 Codex 或 Claude Code，让工具重新读取配置。
- 想看底层 zcf 输出：加
--verbose。
npx -y dingjiai -k sk-你的用户APIKey --verbose本文按当前已发布的 dingjiai npm 包行为说明。实际支持参数可随时运行：
npx -y dingjiai --help最后更新于