Skip to main content

Configuration

CCS uses a simple JSON configuration system. The installer auto-creates config and profile templates during installation.

Configuration Files

~/.ccs/config.json

Configuration Format

Basic Setup

{
  "profiles": {
    "glm": "~/.ccs/glm.settings.json",
    "default": "~/.claude/settings.json"
  }
}

Advanced Setup (Multiple Profiles)

{
  "profiles": {
    "glm": "~/.ccs/glm.settings.json",
    "haiku": "~/.ccs/haiku.settings.json",
    "kimi": "~/.ccs/kimi.settings.json",
    "default": "~/.claude/settings.json"
  }
}

Profile Configuration

GLM Profile Example

Location: ~/.ccs/glm.settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your_glm_api_key",
    "ANTHROPIC_MODEL": "glm-4.6"
  }
}

Claude (Default) Profile

  • Uses ~/.claude/settings.json (your existing Claude CLI config)
  • CCS never modifies this file (non-invasive approach)

How Configuration Works

1

Read Profile

CCS reads profile name from command line (defaults to “default”)
2

Lookup Settings

Looks up settings file path in ~/.ccs/config.json
3

Execute

Executes claude --settings <file> [remaining-args]
No magic. No file modification. Pure delegation.

Environment Variables

CCS_CONFIG

Override default config location:
export CCS_CONFIG=~/my-custom-config.json
ccs glm

NO_COLOR

Disable colored terminal output:
export NO_COLOR=1
ccs glm
Use Cases:
  • CI/CD pipelines
  • Log files
  • Terminals without color support
  • Accessibility preferences

CCS_CLAUDE_PATH

Override Claude CLI location (for non-standard installations):
export CCS_CLAUDE_PATH="/path/to/claude"
ccs glm

Dashboard Configuration

For visual configuration, use the dashboard:
ccs config
API Profiles Configuration
The dashboard provides a GUI for:
  • Managing profiles
  • Setting API keys
  • Configuring OAuth providers
  • Viewing analytics