cc claudecc

Documentation

From install to daily use in 5 minutes

Installation

Grab the claudecc installer for your platform from the download page. Windows: download and run the .exe directly. macOS: drag the .dmg into Applications. Linux: make the AppImage executable and run it.

After claudecc is installed, you can install Claude Code CLI in one click. Open the "Install Claude Code" view inside claudecc — it auto-detects your system environment (Node.js, npm, brew, etc.) and downloads the latest Claude Code.

First run

On startup, claudecc automatically:

  • Detects whether Claude Code is installed; prompts to install if missing
  • Scans ~/.claude/settings.json for existing third-party configs (detected by ANTHROPIC_BASE_URL) and auto-imports them
  • Applies the currently active config as the global configuration

Imported configs can be used directly, or edited to update their name, token, or other fields.

Add a model config

Click the "+" button in the top-right and fill in the form:

  • Name: identifier in the list (e.g. minimax, kimi, glm)
  • Model: API model ID (e.g. kimi-k2-0711-preview)
  • Base URL: must be an Anthropic-protocol-compatible endpoint
  • Auth Token: API key from your provider

Saved configs are stored in ~/.claudecc/profiles.json and stay local-only.

Apply a config

In the config detail view, click "Apply" to write the three keys into the settings.json for the chosen scope:

  • user → ~/.claude/settings.json (global)
  • project → <project>/.claude/settings.json (shared)
  • local → <project>/.claude/settings.local.json (this machine only)

Safe write policy: only ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, and ANTHROPIC_MODEL in the env block are updated. All other fields are preserved.

Project management

Switch to the "Projects" tab and click "+" to add a project path. claudecc reads that project's settings.json and identifies the currently active model config.

In the project view you can:

  • See current config details (token masked by default)
  • Switch to another model config in one click
  • Clear the third-party config from settings.json (revert to default Claude Code)
  • Remove the project from claudecc (does not touch settings.json)

Data storage

All claudecc data stays on your machine — nothing is sent to any server:

  • profiles.json: ~/.claudecc/profiles.json (all model configs)
  • Update check: silently pulls update.json on startup (no device info collected)