Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cccfg-0.1.0.tar.gz (27.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cccfg-0.1.0-py3-none-any.whl (26.1 kB view details)

Uploaded Python 3

File details

Details for the file cccfg-0.1.0.tar.gz.

File metadata

  • Download URL: cccfg-0.1.0.tar.gz
  • Upload date:
  • Size: 27.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.2

File hashes

Hashes for cccfg-0.1.0.tar.gz
Algorithm Hash digest
SHA256 4cd279f8e1b558e822c99c452e54272bcabacda5a92785ce30b2fd494cfd0280
MD5 f8804033c34d87400309043872707a38
BLAKE2b-256 ce0d600891a016fbad6d6f01953fb92df19e7af7e67ab25a7ce56554605f4fed

See more details on using hashes here.

File details

Details for the file cccfg-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: cccfg-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 26.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.2

File hashes

Hashes for cccfg-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e05d86ec7a6c1d8b81cde176dbd5b46c29713eb814a4c98703e232ff5373473e
MD5 0d678a8ebd32a921006992608cc51bdd
BLAKE2b-256 7efe35d09122ac51a17e05661d15d6d2b1f385f8e5c5910e40748cef85b354c6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page