ccs --version
# ccs/7.x.x darwin-arm64 node-v22.x.x

# Opens OAuth for default Claude account
ccs

# Or open the dashboard to configure providers and profiles
ccs config

# Run setup wizard
ccs setup

~/.ccs/
├── config.yaml             # Unified config (schema v12)
├── glm.settings.json       # Z.AI GLM profile template
├── instances/              # Claude account instances
├── cliproxy/               # OAuth provider auth tokens
└── shared/                 # Shared commands/skills/agents

npm update -g @kaitranntt/ccs

# Or force reinstall
ccs update --force

npm uninstall -g @kaitranntt/ccs

# Override Claude CLI location if detection fails
export CCS_CLAUDE_PATH="/custom/path/to/claude"

%USERPROFILE%\.local\bin\claude.exe
%APPDATA%\npm\claude.cmd

$env:CCS_CLAUDE_PATH = "C:\custom\path\to\Claude.exe"

docker run -v ~/.ccs:/root/.ccs -v ~/.claude:/root/.claude \
  node:22 npx @kaitranntt/ccs codex "your task"

# Find npm global bin
npm config get prefix
# e.g. /usr/local

# Add to PATH in ~/.bashrc or ~/.zshrc
export PATH="$(npm config get prefix)/bin:$PATH"

# Fix npm global permissions (recommended)
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

# Then reinstall
npm install -g @kaitranntt/ccs