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

What's in it

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.