Configuration
CCS uses a simple JSON configuration system. The installer auto-creates config and profile templates during installation.Configuration Files
- macOS / Linux
- Windows
Configuration Format
Basic Setup
Advanced Setup (Multiple Profiles)
Profile Configuration
GLM Profile Example
Location:~/.ccs/glm.settings.json
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.json3
Execute
Executes
claude --settings <file> [remaining-args]Environment Variables
CCS_CONFIG
Override default config location:NO_COLOR
Disable colored terminal output:- CI/CD pipelines
- Log files
- Terminals without color support
- Accessibility preferences
CCS_CLAUDE_PATH
Override Claude CLI location (for non-standard installations):Dashboard Configuration
For visual configuration, use the dashboard:
- Managing profiles
- Setting API keys
- Configuring OAuth providers
- Viewing analytics
