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.2.0.tar.gz (28.4 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.2.0-py3-none-any.whl (27.3 kB view details)

Uploaded Python 3

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

Hashes for cccfg-0.2.0.tar.gz
Algorithm Hash digest
SHA256 26d857c778cf76e83481c3413d65b9b66fae20f162c2b5c23f4ed8954cd5881f
MD5 091966da619932744fde196c75552ee8
BLAKE2b-256 7658e816ee316627e8124cd9f9b706e1e8b1c8760979bdb79edc3d87f2f17ee3

See more details on using hashes here.

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

Hashes for cccfg-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f773d5e0d673bcf382df72dfd177be41e134abc1e6c614a990d2d7581f869acc
MD5 96da0510982a77f3d4e50befa65b8620
BLAKE2b-256 0c8b952158f972046d01c4ad155186bae133f320d76e41b97aa0c4510b6ed09e

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