Skip to main content

CLI Commands

Complete reference for all CCS commands and options.

Basic Usage

ccs [profile] [args...]
  • profile - Optional profile name (default: “default”)
  • args - Passed directly to Claude CLI

Profile Commands

Switch Profiles

ccs           # Use default Claude
ccs glm       # Use GLM profile
ccs work      # Use work account
ccs gemini    # Use Gemini via OAuth

With Arguments

ccs glm --verbose
ccs /plan "add feature"
ccs glm /code "implement feature"

Account Management

Create Account Profile

ccs auth create <name>
Creates a new account profile and opens OAuth login.

List Profiles

ccs auth list
Shows all configured profiles with their status.

Set Default

ccs auth default <name>
Sets the default profile for ccs without arguments.

Remove Profile

ccs auth remove <name> --force
Removes profile and deletes instance directory.

Utility Commands

Version

ccs --version
Shows CCS version and installation details:
CCS (Claude Code Switch) v5.0.0

Installation:
  Location: /home/user/.local/bin/ccs
  Config: ~/.ccs/config.json

Documentation: https://docs.ccs.kaitran.ca

Help

ccs --help
Shows comprehensive usage documentation.

Update

ccs update              # Standard update
ccs update --force      # Force reinstall
ccs update --beta       # Install beta channel
ccs update --force --beta  # Force beta install

Configuration Dashboard

ccs config
Opens visual configuration dashboard.

Health Check

ccs doctor
Checks configuration and provider status.

Sync Shared Data

ccs sync
Syncs commands/skills/agents across profiles.

OAuth Provider Commands

Authentication

ccs gemini --auth       # Auth only, no session
ccs codex --auth
ccs agy --auth

Logout

ccs gemini --logout     # Clear cached tokens
ccs codex --logout
ccs agy --logout

Headless Mode

ccs gemini --headless   # No browser, get URL

Environment Variables

VariableDescription
CCS_CONFIGOverride config file path
CCS_CLAUDE_PATHOverride Claude CLI location
NO_COLORDisable colored output
CCS_DEBUG_LOGEnable debug logging

Exit Codes

CodeMeaning
0Success
1Error (config, profile, or execution)