Claude Code Context Management Guide

Reference location: .claude/references/CONTEXT_MANAGEMENT.md

A guide for maximizing context window efficiency.

Core Principles#

"Context window is precious - turn off what you don't use"

• Configuration is architecture, not fine-tuning
• Only enable what's needed
• Disable unnecessary MCP/Plugins

2. MCP Server Management#

Reason: 200k context shrinks to ~70k with 80 tools enabled

3. Currently Active MCP (5)#

{
  "enabledMcpjsonServers": [
    "figma",
    "flutter-inspector",
    "flutter-inspector-console",
    "coui-flutter",
    "zenhub"
  ]
}

Leveraging Parallel Workflows#

/fork - Task Branching#

Handle multiple tasks simultaneously:

• Main: Flutter UI development
• Fork 1: Serverpod API development
• Fork 2: Writing tests

git worktree - Independent Development#

git worktree add ../feature-auth feature-auth
# Claude runs independently in each worktree

tmux - Long-running Tasks#

tmux new -s dev          # Create session
# Claude runs melos build here
tmux attach -t dev       # Check logs later

Subagent Optimization#

Scope Limiting Principle#

• Fewer tools = more accuracy
• Specify only needed tools
• Apply single responsibility principle

Agent Structure Example#

---
name: bloc
tools: Read, Edit, Write, Glob, Grep  # 필요한 것만!
model: inherit
skills: flutter-patterns, swr-pattern
---

Using Hooks (Automation)#

Recommended Hooks for Dart Development#

{
  "PostToolUse": [
    {
      "matcher": "Edit && .dart",
      "hooks": ["dart format", "dart analyze"]
    }
  ],
  "Stop": [
    {
      "matcher": "*",
      "hooks": ["check modified files for print statements"]
    }
  ]
}

Useful Commands#

Keyboard Shortcuts#

Optimization Checklist#

• Keep active MCP to 5-6 or fewer
• Disable unnecessary agents
• Use tmux for long-running tasks
• Use /fork or worktree for parallel tasks
• Run /compact periodically

Related Documents#

• settings.local.json - MCP activation settings
• CLAUDE.md - Complete project guide