How I set up Claude Code in iTerm2 to launch all my AI coding projects in one click
Senior editor's workflow eliminates terminal chaos with auto-loading context files and distinct color profiles for each project.
ZDNET Senior Contributing Editor David Gewirtz has developed an optimized iTerm2 terminal configuration specifically for managing multiple Claude Code AI-assisted programming projects. The setup addresses the common workflow friction of manually navigating directories and launching separate Claude sessions for different applications. Gewirtz's system creates a centralized coding hub where developers can instantly access any project with a single click, dramatically reducing the time spent on administrative terminal tasks.
The configuration leverages iTerm2's profile system to create four distinct workspaces: two for individual app projects (MyFilamentStash and MySewingPatternStash), one for a parent directory overseeing both projects, and one for general Mac home directory tasks. Each profile automatically changes to the correct project directory on launch and loads the appropriate CLAUDE.MD file, which contains essential project context and memory for the AI assistant. This eliminates the need for manual cd commands and startup parameter entry.
A key innovation is the implementation of color-coded tabs with distinct visual identities for each project. The filament app project uses blue and gold jewel tones, while the sewing patterns project employs pinks and purples. This visual differentiation provides immediate project recognition, preventing confusion when switching between development contexts. While demonstrated with iTerm2, similar configurations are possible with Mac Terminal and Windows Terminal, making this workflow optimization accessible across platforms.
- Creates four iTerm2 profiles that auto-load project directories and CLAUDE.MD context files on launch
- Implements color-coded tabs with distinct color schemes (blue/gold vs pink/purple) for instant project identification
- Eliminates manual directory navigation and startup command entry when switching between Claude Code projects
Why It Matters
Reduces administrative overhead in AI-assisted development, letting programmers focus on creative coding rather than terminal management.