How I set up Claude Code in iTerm2 to launch all my AI coding projects in one click

2 days ago 18

Claude Code successful iTerm2 connected my laptop

Follow ZDNET: Add america arsenic a preferred source on Google.

ZDNET's cardinal takeaways

One-click iTerm2 setup launches Claude projects, creating a coding hub.
Profiles auto-load discourse and representation files connected startup.
Color-coded tabs destruct task disorder instantly.

Sure, vibe coding is simply a almighty tool that tin prevention clip compared to hand-cutting codification enactment by line. But anyone who has built thing with vibe coding tin archer you this: there's still a batch of enactment involved.

For the past fewer months, I've been using Claude Code to physique 2 apps that volition yet beryllium delivered for Mac, iPhone, iPad, and Apple Watch. One has reached the investigating stage, portion different is inactive precise overmuch successful early-stage development.

At first, I did what everyone does erstwhile they start utilizing Claude Code. I utilized a terminal window. But my Claude Code enactment really involves moving successful 3 contexts, 1 for each of the 2 apps I'm gathering and 1 that's 1 level up and tin look astatine some apps.

Also: I built 2 apps with conscionable my dependable and a rodent - are IDEs already obsolete?

Whatever directory you're successful erstwhile you motorboat Claude Code becomes the project's location directory. It's the directory Claude looks successful for the CLAUDE.MD file, which tells the AI astir your project. Claude treats this existent moving directory arsenic the basal directory for your project.

In my case, /Users/david/Documents/Development/xcode holds some task directories, MyFilamentStash and MySewingPatternStash.

For months, my process was to unfastened Terminal, alteration directory (using the cd command) to 1 of the 3 directories, motorboat Claude, and supply a acceptable of startup commands to assistance the league get up to velocity with erstwhile work.

Then, if I wanted to power to a antithetic context, I discontinue Claude, issued a cd to different task directory, and did the same. I know. It's cumbersome. I besides cognize I could person had aggregate terminal windows unfastened astatine once, but I recovered myself getting confused astir which task was progressive astatine immoderate fixed time.

Also: Google's Gemma 4 exemplary goes afloat open-source

Even though I was vibe coding and the AI was penning the existent code, it was inactive clip to optimize my enactment environment.

iTerm2 vs. Mac Terminal

The Mac's autochthonal Terminal application has travel a agelong mode since the aboriginal days of the Mac. The app supports tabs, profiles, and galore configuration options. But iTerm2, a free, GPL-licensed, open-source terminal program, is adjacent much configurable. Plus, iTerm2 has vertical panes successful summation to tabs, which tin travel successful useful from clip to time.

Over the years, I've mostly utilized Mac Terminal for system-level tweaks to my Mac and iTerm2 erstwhile utilizing the bid enactment for coding work. That's not a indispensable distinction, but it's what my signifier has been.

Also: I built an iOS app successful conscionable 2 days with conscionable my voice

I'll beryllium discussing however to acceptable up iTerm2 for an optimal vibe-coding startup, but Mac Terminal's illustration features enactment a akin acceptable of capabilities. You tin get to those capabilities from the Settings menu.

Windows Terminal besides supports this benignant of illustration customization. You tin negociate these settings by clicking the dropdown arrow adjacent to the tabs and selecting Settings successful Windows Terminal.

Color coding the tabs

For my improvement process, I acceptable up 4 profiles successful iTerm2. You get to profiles by selecting the Settings paper and past tapping the profiles icon. As mentioned above, I person 1 illustration for each project, 1 for the genitor of some projects, and 1 that works successful my Mac location directory successful lawsuit I request to bash thing there.

For clarity, I person color-coded each profile. That attack makes it instantly wide what task I'm moving connected erstwhile successful that tab. The 2 projects person chiseled colour identities. The filament task is bluish and golden with jewel tones. The sewing patterns task is successful pinks and purples.

I applied those colour identities to the terminal profiles. You tin spot the colour quality below. This process is however I acceptable up the illustration for my filament app project. Note the bluish and golden hues taken from the app idiosyncratic interface. You tin spot that adjacent the tab itself matches the colour theme:

By contrast, enactment the purple and pinkish taken from the sewing signifier app. You tin spot the tab is besides purple for this project:

This benignant of colour differentiation makes it ace casual to archer which task I'm moving connected astatine immoderate time. Setting up is easy. Open Settings successful iTerm2, click Profiles, and past the Colors tab. Go down the leafage and take the colors you privation for your profile:

To acceptable the tab color, scroll each the mode down and take a customized tab color:

I chose a greenish inheritance with yellowish substance erstwhile moving successful the genitor directory of the 2 projects. And I gave the /Users/David illustration a achromatic inheritance with agleam greenish text.

Tweaking substance size

You tin besides customize the font and size for each profile. I person a ample screen, truthful I wanted my substance reasonably large. I picked the font and size I liked and duplicated it for each profile. You specify substance size by choosing Profiles→Text and past going down to the Font selector:

Setting each profile's starting directory

As I mentioned earlier, Claude treats the existent moving directory erstwhile it launches arsenic the basal of the existent project. To automatically prime the close directory astatine startup, I acceptable my directory prime successful each profile.

This task is besides done successful Settings→Profiles. This time, enactment successful the Profiles→General tab. Make definite Profile Type is acceptable to Terminal (at 1), and past spell down to Initial Directory→Advanced Configuration (at 2) and deed Edit:

Next, for the existent task whose illustration you're in, paste the afloat way to that task into each 3 Working Directory fields. All 3 Working Directory fields volition get the aforesaid path. That way, you'll ever beryllium moving successful the task folder for your existent project:

Auto-configuring Claude sessions

For optimal productivity, I wanted Claude afloat acceptable up arsenic soon arsenic I tapped the iTerm2 icon successful my Mac's dock. To instrumentality this approach, I acceptable up each illustration to tally a bid enactment arsenic soon arsenic iTerm2 launched.

Also: How to instal and configure Claude Code, measurement by step

This task is done by mounting Command to Login Shell connected the General tab of the profile, past pasting a "Send substance astatine start" enactment that's a bid enactment to beryllium executed astatine illustration launch:

The bid enactment consists of 3 parts: choosing the task directory, clearing the screen, and launching Claude with a starting prompt.

Let's instrumentality a look astatine that archetypal command:

cd /Users/david/Documents/Development/xcode/MySewingPatternStash && wide && claude "New league starting. Read each representation record successful the representation directory 1 by 1 utilizing the Read tool, not conscionable the MEMORY.md index. Check git presumption for immoderate uncommitted work. Then springiness maine a little presumption report: wherever we near off, what's pending, and whether determination are uncommitted changes."

You mightiness person noticed that the bid begins with different cd. That happens due to the fact that I recovered that the alteration directory bid didn't consistently tally earlier iTerm2 invoked Claude unless I utilized a belt-and-suspenders attack to choosing the starting directory. So, I acceptable cd arsenic an option, arsenic described successful the erstwhile section, and besides enactment it present successful the bid enactment itself.

Next, I execute a clear. This measurement cleans up the terminal surface of immoderate of the startup cruft I don't privation to see. After that, I motorboat Claude and springiness it a reasonably extended prompt.

Also: 10 things I privation I knew earlier trusting Claude Code to physique my iPhone app

The punctual tells Claude to work each my startup notes (called representation files successful the representation directory). This is portion of my maneuver utilizing Claude. I person the AI grounds a batch of notes. This process some gives maine a presumption study and helps Claude get up to velocity connected what happens next.

One past instrumentality is the usage of the && operator. In bash and different shells, the semicolon separates commands successful a sequence. But the gotcha is that adjacent if an earlier bid fails, the aboriginal commands volition run. By contrast, the && relation lone runs consequent commands if earlier commands instrumentality an exit presumption that indicates success.

So now, erstwhile each illustration is instantiated, the bid that launches Claude successful the due directory runs, and Claude does a heavy dive, bringing itself up to velocity connected the project's status.

Here's an illustration of the startup presumption for the sewing signifier project:

Bringing it each unneurotic

By this point, we person each project's UI color-coded to the app that's being worked on, and Claude is launching with a applicable punctual erstwhile the illustration is initialized. All that's near to bash is person each 4 profiles motorboat automatically erstwhile iTerm2 is clicked successful the dock.

Also: I utilized Claude Code to vibe codification an Apple Watch app successful conscionable 12 hours

To bash this step, archetypal acceptable up iTerm2 truthful it's the mode you privation it erstwhile launched. In my case, that's with each 4 profiles opened. I privation the Home illustration tab connected the left, the genitor illustration tab connected the right, and the 2 apps themselves successful the mediate tabs. I besides moved the model to wherever I'd similar it to beryllium connected the surface erstwhile it launches.

This measurement is configured successful the Settings→Arrangements tab of iTerm2. Once your model is placed wherever you privation it, with each the tabs unfastened and arranged arsenic you wish, spell to Arrangements and Set Default. This determination volition fastener successful the existent statement and unfastened everything this mode whenever you motorboat iTerm2.

1-click to power them each

That's it. All it takes present is 1 click connected my dock icon, and iTerm2 goes to town. It sets up each my tabs, sets each 1 to the due task directory, and launches 3 instances of Claude.

Then, each Claude lawsuit digs into its ain project, brings itself afloat backmost up to velocity connected what it needs to cognize for the existent enactment session, and presents a task presumption summary.

Also: I utilized Gmail's AI instrumentality to bash hours of enactment for maine successful 10 minutes - with 3 prompts

It takes a fewer minutes for this full process to run, but it saves maine a ton of clicks. While the assorted Claudes are coming up to velocity and briefing maine connected the status, I tin person a mates of sips of java to get acceptable for a caller improvement session.

Now, you can, too.

How overmuch clip bash you deliberation a one-click, multi-session Claude setup would prevention successful your regular coding workflow? Let america cognize successful the comments below.

You tin travel my day-to-day task updates connected societal media. Be definite to subscribe to my play update newsletter, and travel maine connected Twitter/X astatine @DavidGewirtz, connected Facebook astatine Facebook.com/DavidGewirtz, connected Instagram astatine Instagram.com/DavidGewirtz, connected Bluesky astatine @DavidGewirtz.com, and connected YouTube astatine YouTube.com/DavidGewirtzTV.

Read Entire Article