CLAUDE:

SETTINGS &

CONFIG

21 SRC

KE

21 sources Updated May 3, 2026

Claude: Settings & Config

Claude Code configuration operates at three layers: environment (bypass permissions via --dangerously-skip-permissions, Zed autosave at 500ms, Ghostty + Zed split-screen, game sound hooks for task notifications, plus performance-recovery env flags like CLAUDE_CODE_DISABLE_1M_CONTEXT and CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING for platform-regression days), context architecture (CLAUDE.md under 200 lines with one-liner declarative behaviors, .claude/rules/ with path-scoped YAML, _MANIFEST.md with Tier 1/2/3 priority loading), and skill design (progressive disclosure cutting 89% context bloat, state-machine skills with data dependency optimization, self-improving eval loops). The platform has six distinct extension mechanisms: Plugins (packaged workflows), Skills (on-demand knowledge), MCPs (external tool connections), Commands (prompt shortcuts), Subagents (delegated tasks), and Hooks (pre/post action scripts).

For articulate, opinionated agents the convention is converging on three configuration files: SOUL.md (the constitution — voice/values/operating principles, brutally specific or output reverts to generic ChatGPT), USER.md (a ~4000-word deep model of the user — how their mind works, blind spots, triggers, temperament), and AGENTS.md (operational rules — checks, failure handling, lookup chains, path rules). Splitting who the agent is from who you are from how it operates is what separates feels-alive output from feels-like-software output.

Web fetch uses a subagent architecture that summarizes pages to prevent context overflow but can lose detail. The biggest insight is that system engineering beats prompt engineering — investing ~2 hours in context architecture lets subsequent prompts be 10 words long. An 8-phase bootstrap prompt can build an entire workspace from scratch. Effort levels (low/medium/high) are configurable and sticky; conflicting CLAUDE.md instructions are the most common cause of degraded output at high effort.

Guides

The Claude Code Configuration Playbook: From Permissions to Progressive Disclosure

How to configure Claude Code for maximum autonomy and minimal friction — covering permission bypass, Zed autosave integration, CLAUDE.md architecture under 200 lines, tiered context loading, state-machine skills, and the game-sound notification hooks that turn agent work into ambient awareness.

Building Multi-Agent Orchestration Systems: From Single Agents to Coordinated Teams

A practical guide to designing agent coordination systems — covering orchestrator patterns, sub-agent delegation, cost optimization strategies, MCP tool integration, and the memory/self-improvement loops that make agent teams compound over time.

Building an AI Chief of Staff with Claude Code

A practical architecture for building an AI Chief of Staff using Claude Code — covering overnight inbox triage, morning sweep with parallel subagents, automated meeting prep, weekly accountability, and the human-AI boundary decisions that make it safe to deploy.

Claude & Claude Code for Marketing Agencies: A Detailed Guide

A comprehensive guide covering agency workspace setup, content strategy, competitive intelligence, outbound automation, brand design workflows, and agency-specific Claude Code skills — grounded in 77+ sources.

Claude Code: From New User to Power User

A structured progression covering context architecture, the Research → Plan → Build loop, environment setup, the six extension mechanisms, parallel sessions, and the tools and patterns used by Claude Code power users.

Insights

  • Exact bypass permissions config: "defaultMode": "bypassPermissions" + "skipDangerousModePermissionPrompt": true in ~/.claude/settings.json. Without skipDangerousModePermissionPrompt, Claude asks for confirmation every session. Shift+Tab toggles bypass mode. (from every claude code hack mvanhorn)

  • Stop hook for audio notification: Add "hooks": {"Stop": [{"hooks": [{"type": "command", "command": "afplay /System/Library/Sounds/Blow.aiff"}]}]} to settings.json. Essential when running 4-6 parallel sessions — know which one just finished. (from every claude code hack mvanhorn)

  • Zed autosave at 500ms creates a Google Docs-like collab experience: {"autosave": {"after_delay": {"milliseconds": 500}}} in Zed settings. Claude edits appear in Zed instantly, and your typing is visible to Claude within a second. Ghostty + Zed split-screen. (from every claude code hack mvanhorn)

  • Claude Code desktop app supports direct DOM element selection — click instead of describe; sends tag name, CSS classes, styles, surrounding HTML context, cropped screenshot, and for React apps also source file path, component name, and current props (from claude code dom element selection)

  • Structure .claude with 35 agent markdown files organized into 7 departments — engineering agents (frontend, backend, mobile, AI, devops, prototyper), testing department (tool evaluation, API testing, workflow optimization, performance, test analysis); each agent file has instructions, personality, scope sections (from one person startup claude agents)

  • Keep CLAUDE.md under 200 lines — longer files eat context and instruction adherence drops (from claude folder anatomy)

  • Two .claude directories: project-level (git) and ~/.claude/ (personal); .claude/rules/ with YAML frontmatter paths field scopes rules to directories (from claude folder anatomy)

  • Commands are single markdown files that become slash commands; Skills are subdirectories with SKILL.md; define subagent personas in .claude/agents/ with restricted tools and cheaper model (from claude folder anatomy)

  • settings.json allow/deny lists control tool permissions; CLAUDE.local.md and settings.local.json for personal overrides (auto-gitignored) (from claude folder anatomy)

  • A three-tier _MANIFEST.md in each project folder (Tier 1: source-of-truth docs, Tier 2: domain folders, Tier 3: archive) gives Claude a prioritized loading order — read the most important context first (from claude cowork context architecture checklist)

  • The minimum viable context setup is three markdown files: about-me.md (role + priorities + work samples), brand-voice.md (tone + writing samples + anti-patterns), and working-style.md (guardrails) (from claude cowork context architecture checklist)

  • Global instructions should direct Claude to read the manifest first, load only Tier 1 files, and ask clarifying questions before starting — this prevents context overload (from claude cowork context architecture checklist)

  • Cowork rewards system engineering over prompt engineering — investing ~2 hours in context architecture means subsequent prompts can be as short as 10 words and still produce high-quality output (from claude cowork context architecture checklist)

  • A folder structure with custom skill files per folder acts as Claude's long-term memory, letting it know exactly how each type of content should be written (from claude cowork workspace setup system)

  • An 8-phase bootstrap prompt can systematically build an entire workspace: Plugins → About Me → Brand Voice → Working Preferences → Content Strategy → Team → Projects → Memory System → Skill Files (from claude cowork workspace setup system)

  • The Memory plugin provides a two-tier context system persisting across sessions, and the Productivity plugin adds task tracking and daily updates — together they make sessions feel continuous (from claude cowork workspace setup system)

  • Content drafts that previously required 3 revision rounds land on the first try once Claude has pre-loaded context about identity, voice, projects, and team (from claude cowork workspace setup system)

  • Progressive disclosure in skill files means restructuring a monolithic instruction file into a slim main file (table of contents) plus separate reference files loaded on demand — 89% context reduction with no loss of functionality (from progressive disclosure claude skills)

  • The instruction file for a Claude skill should function like a table of contents: rules and decision logic up front, reference material (examples, templates, edge cases) in separate lazy-loaded files (from progressive disclosure claude skills)

  • Claude Code changed its default effort level from high to medium to balance intelligence with speed; effort is configurable via /model selector (low/medium/high), and the setting is sticky across sessions (from claude code effort levels)

  • Confusing or conflicting instructions in CLAUDE.md files are the most common cause of unexpected Claude Code behavior at high effort, per the Claude Code team (from claude code effort levels)

  • Skills, MCP servers, and hooks serve distinct roles: skills for reusable prompts, MCP for tool integrations, hooks for lifecycle automation (from claude code daily workflow vibePM)

  • Power users build skills as complex state machines — Brad Feld's /start command is 1,400 lines with 15 steps; mapping data dependencies between steps revealed 12-22 seconds of removable overhead (from claude skill state machine optimization)

  • Skills accumulate "defensive machinery" over time — checks added during development that become redundant but remain as performance drag, suggesting periodic dependency audits for complex skills (from claude skill state machine optimization)

  • Treating a skill as a "state machine with data dependencies" — each step as a node with explicit input/output contracts — is an advanced mental model for systematic skill optimization (from claude skill state machine optimization)

  • Claude Code Desktop now supports --dangerously-skip-permissions for fully autonomous operation; the deliberately scary flag name is a UX pattern that makes the footgun obvious (from claude code desktop skip permissions)

  • A one-line CLAUDE.md instruction ("When you complete work, log it to memory/weekly-recaps/current-week.md") turns Claude Code into a persistent work logger, demonstrating declarative agent configuration with two-minute setup (from weekly recap agent memory)

  • Claude hooks with game sounds (Starcraft, Warcraft, Mario) for task completion/permission notifications solve a key autonomous workflow UX problem; 5.2K likes signals strong appetite for playful DX customization (from claude hooks sound alerts)

  • Claude Code has six distinct extension mechanisms: Plugins (packaged workflows), Skills (on-demand knowledge), MCPs (external tool connections), Commands (prompt shortcuts), Subagents (delegated focused tasks), and Hooks (pre/post action scripts) (from claude code extensions crash course)

  • Claude Code's web fetch uses a subagent architecture: a smaller model summarizes full page content to prevent context window overflow, but critical details can be lost; workaround is saving the full page to a temp folder and analyzing in sections (from claude code web fetch summarizes)

  • Hyper-personalization system built entirely with plain text Markdown files (USER.md, MEMORY.md, family/ directory) — no database, no vector store needed (from shpigford hyper personalization ai)

  • "Daily drip" pattern: cron job asks one thoughtful personal question per day, processes answer, files to right place — adds more useful context after 6 weeks than initial onboarding interview (from shpigford hyper personalization ai)

  • AI onboarding interview (10-15 min structured dialogue, not a form) gets ~60% coverage of personal context; remaining depth comes from incremental daily questions (from shpigford hyper personalization ai)

  • Effective AI memory should be curated and distilled (decisions, lessons, opinions), not raw conversation log — AI reads MEMORY.md every session and updates when something worth remembering happens (from shpigford hyper personalization ai)

  • After 6 weeks of accumulated personal knowledge, AI interactions shift from transactional to collaborative — stops asking clarifying questions because answers are in files it read seconds ago (from shpigford hyper personalization ai)

  • Three levels of Cowork instructions for consistent behavior: Level 1 Claude personalization (universal rules across all modes), Level 2 Cowork global instructions (formatting, file naming — applies across all tasks), Level 3 project-specific instructions (isolated per project to prevent contamination between domains) (from twitter link share hooeem)

  • Zapier MCP connects Claude Cowork to 8,000+ applications (HubSpot, Skool, Airtable, etc.) in under 10 minutes — eliminates the "my tool isn't supported" objection; the single most underrated feature in the tool (from twitter link share hooeem)

  • Token management 30-45 minute rule: one focused topic per window, then fresh context; use Sonnet 99% of the time (Einstein rule: don't put Opus on routine tasks); write reusable scripts instead of processing items conversationally — scripts use a fraction of the tokens (from twitter link share hooeem)

  • Scheduled tasks only run if the physical computer is on and Cowork app is open — adjust power settings to keep machine awake; this single detail breaks more scheduled automation than anything else (from twitter link share hooeem)

  • Performance recovery flags when Claude quality drops: set CLAUDE_CODE_DISABLE_1M_CONTEXT=1, CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1, and pin ANTHROPIC_DEFAULT_OPUS_MODEL="claude-4-6-opus"; have the agent save state, /clear, restart — disables features that degrade output during platform regressions (from claude performance optimization flags)

  • The articulate-agent three-file pattern: SOUL.md is a constitution of voice/values (brutal specificity like "brevity is mandatory," "humor is mandatory," "never open with Great question," "swearing is allowed when it lands"); USER.md is a ~4000-word deep model of how you think; AGENTS.md is the operational playbook (message checks, failure handling, lookup chains, brain-first protocols) — splitting personality from operational rules is the new minimum-viable agent config (from three file ai agent configuration)

  • Generic instructions ("be helpful and concise") produce ChatGPT — voice direction must be brutally specific to make output feel alive; the level of opinion in SOUL.md is directly proportional to how much the agent stops sounding like a chatbot (from three file ai agent configuration)

Voices

11 contributors
Aakash Gupta

Aakash Gupta

@aakashgupta

✍️ https://t.co/8fvSCtBv5Q: $72K/m 💼 https://t.co/STzr4nqxnm: $39K/m 🤝 https://t.co/SqC3jTyP03: $37K/m 🎙️ https://t.co/fmB6Zf5UZv: $30K/m

209.5K followers 1 tweet
Cody Schneider

Cody Schneider

@codyschneiderxx

folllow for shiposting about the growth tactics i'm using to grow my startup building @graphed with @maxchehab Get Started Free - https://t.co/stXlkQBlSj

59.9K followers 1 tweet
Ihtesham Ali

Ihtesham Ali

@ihtesham2005

investor, writer, educator, and a dragon ball fan 🐉

16.6K followers 1 tweet
Nick Khami

Nick Khami

@skeptrune

currently doing things at Mintlify, prev. built a search API (trieve acq. YCW24), you should try to fail faster

14.1K followers 1 tweet
hoeem

hoeem

@hooeem

helping you turn screen time into cash flow using modern stacks to create digital leverage.

164.8K followers 1 tweet
James Bedford

James Bedford

@jameesy

engineering @zerion, building https://t.co/3RQYuZAcrt

5.2K followers 1 tweet
Manthan Gupta

Manthan Gupta

@manthanguptaa

ai research engineer • designing agent runtimes, memory & retrieval systems for autonomous agents • dms open

21.9K followers 1 tweet
rahul

rahul

@rahulgs

head of applied ai @ ramp

13.1K followers 1 tweet
rLLM

rLLM

@rllm_project

Enabling AI agents to "learn from experience" @BerkeleySky Try Hive: https://t.co/S9kJjTWgA9

1.0K followers 1 tweet
Shiv

Shiv

@shivsakhuja

Pontificating... / Vibe GTM-ing / Making Claude Code do non-coding things building a team of AI coworkers @ Gooseworks / prev @AthinaAI /@google / @ycombinator

52.2K followers 1 tweet
buun

buun

@spiritbuun

this user is experiencing context rot

1.5K followers 1 tweet