cccfg
A complete, keyboard-driven explorer for every config surface in Claude Code 2.1.x. Every environment variable, every settings.json key, every CLI flag, every slash command, every hook event, in one place.
Download A4 handout (PDF)
cccfg.py (TUI source)
catalog.py (data)
How to install
Two files, no install step. Just save them somewhere on your PATH:
curl -O https://claude-code-book-site-production.up.railway.app/tool/cccfg.py
curl -O https://claude-code-book-site-production.up.railway.app/tool/catalog.py
mkdir -p data
curl -o data/all-env-vars.txt https://claude-code-book-site-production.up.railway.app/tool/data/all-env-vars.txt
pip install textual rich
chmod +x cccfg.py
How to use
Launch the TUI:
./cccfg.py
Or use the headless CLI modes:
./cccfg.py --list # full catalog grouped by category
./cccfg.py --search hooks # search across all entries
./cccfg.py --category Models # filter by category
./cccfg.py --kind settings # only settings.json keys
./cccfg.py --json | jq # pipe-friendly JSON
./cccfg.py --cookbook # print the cookbook
TUI keys
| j / k | navigate entries down / up |
| / or s | focus search |
| c | focus category list |
| Enter | show entry detail (right pane) |
| Escape | back to entries list |
| ? | open cookbook screen |
| q | quit |
What's in it
Categories you can browse:
- Auth & API 34 entries — API keys, OAuth, apiKeyHelper, custom endpoints
- Models 22 entries — Opus/Sonnet/Haiku selection, custom model registration
- Thinking & Effort 7 entries — extended thinking, effort levels, adaptive thinking
- Permissions & Sandbox 15 entries — allow/deny rules, bubblewrap, managed settings
- Hooks 5 entries — definitions, paths, disable flags
- Hook Events 10 entries — PreToolUse, PostToolUse, SessionStart, Stop, etc.
- Skills & Plugins 20 entries — listing budgets, marketplace controls
- MCP 23 entries — server configs, timeouts, output caps
- Background Agents 32 entries — backend, isolation, daemons, bridges
- Cache & Compaction 13 entries — auto-compact thresholds, prompt caching per model
- Bash Tool 8 entries — timeouts, output caps, sandbox indicators
- UI & TUI 14 entries — accessibility, mouse, alt screen, repaints
- Telemetry & Privacy 14 entries — telemetry, error reporting, growthbook, datadog
- Updates & Install 10 entries — autoupdater, channels, package manager
- Cloud Providers 21 entries — AWS Bedrock, GCP Vertex, Azure Foundry
- Debug & Logging 9 entries — debug levels, diagnostics files, traces
- Experimental & Beta 6 entries — agent teams, advisor tool, away summary
Why it exists
Claude Code's built-in /config shows a small subset of the most common settings. There are 434+ environment variables compiled into the binary that affect behaviour, plus 30+ settings.json keys, plus CLI flags, plus slash commands, plus hook events. Most of them are not documented anywhere visible. cccfg is a complete reference plus a fast browser plus a cookbook of the patterns that earn their keep.
Companion to the book
This tool ships with "Claude Code, Definitive Guide for 2026: From Starter to 10x Pro". The book teaches the patterns; cccfg lets you find the exact config knob you need when you need it.