Skip to content

Automatic CLI setup

Install the published CloudService CLI globally for a reusable cloudservice command. All client guides use this direct command, so repeated npx runs are unnecessary.

Global install

bash
npm install -g cloudservice@latest
cloudservice

Future commands such as cloudservice doctor, cloudservice models, and cloudservice update are then available directly. See Updating the CLI for moving an existing install to the latest published version, and Removing configuration for undoing what the installer wrote.

Optional one-time run

bash
npx cloudservice@latest

Both forms run the same installer. There is no init subcommand.

What the installer does

  1. Prompts for a CloudService API key, or reads CLOUDSERVICE_API_KEY in non-interactive environments.
  2. Validates the key and its OpenAI-compatible, Claude-compatible, or combined provider scope.
  3. Reads the authenticated model catalog and shows only compatible client targets.
  4. Backs up existing client files and merges only CloudService-owned settings.
  5. Offers doctor and client-specific verification after setup.

Manual setup

You do not need the CLI for a direct configuration. Use the manual client guides, including the explicitly separate no-npx guides for Claude Code and Codex.

Keep the key private

The CLI masks stored keys in its output. Do not paste a real key into a command you will share, a repository, a screenshot, or a support transcript.