The complete Claude Code config explorer: TUI plus reference of every env var, settings.json key, CLI flag, slash command, and hook event
Project description
cccfg
The complete Claude Code config explorer. A keyboard-driven TUI plus CLI reference for every config surface in Claude Code 2.1.x.
Most Claude Code users know the dozen settings exposed in /config. Under the hood there are 434 environment variables compiled into the binary, 30+ settings.json keys, 14 CLI flags, slash commands, and hook events. cccfg puts all of them in one keyboard-navigable place, with descriptions, use cases, examples, current-value lookup, and a cookbook of the patterns worth memorising.
Install
pip install cccfg
Run
cccfg # launch the TUI
cccfg --list # full catalog grouped by category
cccfg --search hooks # search across all entries
cccfg --category Models # filter by category
cccfg --kind settings # only settings.json keys
cccfg --json | jq # pipe-friendly JSON
cccfg --cookbook # print the cookbook
TUI keys
| Key | Action |
|---|---|
j / k |
navigate entries down / up |
/ |
focus search |
c |
focus category list |
Enter or m |
open the manual page for this entry |
? |
open the cookbook |
Esc |
close modal / back to entry list |
q |
quit |
What's in it
| Surface | Entries |
|---|---|
Environment variables (CLAUDE_CODE_*, CLAUDE_*, ANTHROPIC_*, DISABLE_*, BASH_*, MCP_*) |
434 |
settings.json keys (documented + discovered) |
30 |
| CLI flags (the high-leverage ones) | 14 |
| Slash commands | 11 |
| Hook events | 10 |
| Total | 499 |
Organised across 23 categories: Auth & API, Models, Thinking & Effort, Permissions & Sandbox, Hooks, Hook Events, Skills & Plugins, MCP, Background Agents, Cache & Compaction, Bash Tool, UI & TUI, Telemetry & Privacy, Updates & Install, Cloud Providers, Debug & Logging, Experimental & Beta, Network & Proxy, Compliance & Enterprise, Disable Flags, Limits & Timeouts, CLI Flags, Slash Commands.
How the catalog was built
The environment variable list was extracted from the Claude Code binary directly (Mach-O native arm64) via strings, then filtered to canonical name patterns. The settings.json keys, CLI flags, slash commands and hook events come from the binary plus Anthropic's published docs plus Marco Kotrotsos's deployment notes from running Claude Code in client engagements through 2025-2026.
The high-leverage entries have hand-written descriptions, use cases, examples, and defaults. The remaining auto-discovered entries get a category and a short name-derived summary, with the "Discovered" tag so you know it isn't officially documented.
Manual page per entry
Press Enter on any entry in the TUI. A full-screen manual page opens with:
- Type and category
- Summary, description, use case
- Example value
- Documented default
- Current value on this machine (live lookup from env vars or
~/.claude/settings.json) - Exact shell or settings.json snippet to set it
Press Esc to return to the entry list.
Cookbook
Open with ? in the TUI or cccfg --cookbook on the command line. Recipes include:
- Lock down a team's install (managed settings)
- Use a secret vault for the API key
- Maximum privacy mode (no telemetry, no surveys, no growthbook)
- CI-clean run with no harness baggage (
--bare) - Bigger Bash output and longer timeouts
- Pin model versions for reproducibility
- Register a custom internal model in the picker
- Debug a hook
- Disable auto-compaction (manage manually with
/compact) - Force Claude not to read the keychain (sandbox / VM)
Related
This tool ships as a companion to "Claude Code, Definitive Guide for 2026: From Starter to 10x Pro". The book teaches the patterns; cccfg lets you find the exact config knob when you need it.
License
MIT.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cccfg-0.2.0.tar.gz.
File metadata
- Download URL: cccfg-0.2.0.tar.gz
- Upload date:
- Size: 28.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
26d857c778cf76e83481c3413d65b9b66fae20f162c2b5c23f4ed8954cd5881f
|
|
| MD5 |
091966da619932744fde196c75552ee8
|
|
| BLAKE2b-256 |
7658e816ee316627e8124cd9f9b706e1e8b1c8760979bdb79edc3d87f2f17ee3
|
File details
Details for the file cccfg-0.2.0-py3-none-any.whl.
File metadata
- Download URL: cccfg-0.2.0-py3-none-any.whl
- Upload date:
- Size: 27.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f773d5e0d673bcf382df72dfd177be41e134abc1e6c614a990d2d7581f869acc
|
|
| MD5 |
96da0510982a77f3d4e50befa65b8620
|
|
| BLAKE2b-256 |
0c8b952158f972046d01c4ad155186bae133f320d76e41b97aa0c4510b6ed09e
|