One-Click Setup
Use the dingjiai CLI to configure an installed Codex or Claude Code client.
This is a configurator, not an installer
dingjiai configures Codex or Claude Code that is already installed on the machine. It does not install Node.js, a client, or system dependencies. The pinned dingjiai@1.0.10 + zcf@3.6.8 combination requires Node.js 20 or later.
Get started
npx -y dingjiai@1.0.10Enter your DINGJIAI user API Key when prompted. Interactive input only keeps the key out of the top-level shell history. dingjiai@1.0.10 still passes it as an argument to the zcf@3.6.8 child process, so it is briefly visible in that process's argv and to local process inspection. Do not expose command output or process listings to other users on a shared machine.
Configure one client only:
npx -y dingjiai@1.0.10 --only codex
npx -y dingjiai@1.0.10 --only claudePreview the plan without requesting model lists or writing configuration:
npx -y dingjiai@1.0.10 --only claude,codex --dry-runWhat it does
On a real run, the CLI detects installed clients, checks the user key and model lists online, chooses a default model, and invokes the pinned external npm configurator zcf@3.6.8. The exact published combination is dingjiai@1.0.10 + zcf@3.6.8; neither the preview nor this page replaces inspecting the packages before execution.
| Client | Main write, merge, and backup scope |
|---|---|
| Codex | Writes or merges ~/.codex/config.toml and plaintext ~/.codex/auth.json. ZCF's full initialization may also back up and replace ~/.codex/AGENTS.md, write ~/.codex/prompts/, merge MCP configuration, and update ~/.ufomiao/zcf/config.toml. If it detects a newer release of the installed Codex client, ZCF may update it automatically. |
| Claude Code | Backs up the existing ~/.claude/ tree under its backup/ directory, then merges ~/.claude/settings.json, writes API and model environment values, and may write ~/.claude/CLAUDE.md, ~/.claude/config.json, ~/.claude.json, and ~/.ufomiao/zcf/config.toml. The direct api_key path marks onboarding complete and sets primaryApiKey; it does not guarantee a change to customApiKeyResponses. If it detects a newer release of the installed Claude Code client, ZCF may update it automatically as well. |
This package combination invokes ZCF in skip-prompt mode and explicitly asks it to skip Claude Code MCP, workflow, output-style, and status-line options, but Codex still enters full initialization and can produce the AGENTS, prompts, and MCP effects listed above; either client may be updated automatically. It does not change system-wide environment variables and redacts the key in its own output; that does not mean the key never enters child-process arguments. Updating a global installation requires write access to its directory, and on some Linux systems the update path may invoke sudo or request elevated privileges. Review the terminal preview and make your own backup before writing.
Models and verification
In dingjiai@1.0.10, the Claude check reads the Anthropic model list. The Codex check reads /v1/models, which represents OpenAI Chat Completions and does not prove that a model is published for the Responses API entry. After Codex auto-selection or successful online verification, confirm in the console that the same public model id is enabled for OpenAI Responses. Manually selected models have the same limitation.
--skip-verify skips online key and model verification. Use it only when you understand the consequences of an offline write; normal setup should keep verification enabled.
Local key files
- The Codex key is stored as plaintext JSON in
~/.codex/auth.json. - The Claude Code key is written to the environment section of
~/.claude/settings.json. - Restrict these files to the current local user. Do not put them in synced folders, configuration backups, repositories, or issue screenshots. Before backing them up, verify that the backup is encrypted and access-controlled.
Troubleshooting
- Client not detected: install and start that client at least once.
- Key verification failed: use a DINGJIAI user API Key, not an upstream provider key.
- No selectable model products: check balance and model permissions. For Codex, separately confirm that the selected model product is published for the Responses API entry.
- The old endpoint is still used: fully quit and restart the client.
The npm package and command help are authoritative for the published version and full flag set:
npx -y dingjiai@1.0.10 --version
npx -y dingjiai@1.0.10 --helpLast updated on