아이텀2, 클로드 코드 상태를 한눈에

맥(macOS)용 인기 터미널 앱 아이텀2(iTerm2)가 클로드 코드(Claude Code) 연동 기능을 공식 제공하기 시작했다. 여러 개의 클로드 세션을 동시에 띄워도 각 세션이 일하는 중인지, 사용자 승인을 기다리는지, 끝났는지를 사이드 패널에서 바로 확인할 수 있다. 대화·변경사항 비교·코드 리뷰 화면을 한 번에 묶어 주는 작업공간 기능도 함께 들어왔다.

무슨 일인가

설치는 메뉴에서 시작한다. iTerm2 메뉴의 'Install Claude Code Integration'을 누르면 무엇이 바뀌는지 먼저 요약해 보여주고 단계별로 안내한다. 필수 단계는 파이썬 API 활성화 하나이고 나머지는 선택이다. 설치 과정은 ~/.claude/settings.json에 상태 보고용 훅(hook)을 추가하고, 오른쪽 툴벨트에 세션 상태 도구를 켜고, 클로드 코드 전용 워크그룹을 등록하는 순서로 진행된다. 바꾼 내용은 제거 메뉴 하나로 전부 원상복구된다는 점도 명시했다.

핵심 짚어보기

가장 실용적인 기능은 세션 상태 표시다. 각 세션 옆에 색깔 점과 함께 세 가지 상태가 붙는다. 프롬프트나 도구를 실행 중이면 '작업 중', 권한 승인처럼 사용자 입력이 필요하면 '대기', 답을 마치고 다음 지시를 기다리면 '유휴'다. 주의가 필요한 세션이 위로 정렬되고, 클릭하면 해당 세션으로 곧장 이동한다. 최근 버전의 클로드 코드와 함께 쓰면 백그라운드 에이전트나 작업이 남아 있는 동안에는 '작업 중'이 유지돼, 서브에이전트 사이의 짧은 공백에 '끝났다'고 착각하는 일이 줄어든다.

워크그룹은 하나의 클로드 세션을 중심으로 관련 화면을 묶는다. 메인 대화(Chat), 작업 트리 변경분을 나란히 보여주는 비교 화면(Diff), 리뷰 전용 세션(Code Review)을 도구막대 클릭 한 번으로 오갈 수 있다. 프로필에 트리거를 달아 두면 claude 실행과 함께 자동으로 워크그룹에 들어가고, 메인 세션이 끝나면 빠져나온다.

1인기업 실전 적용 포인트

• 병렬 세션 운영자라면 바로 켜자: 콘텐츠 초안·코드 수정·데이터 정리를 세션 3~4개로 나눠 돌린다면, 승인 대기로 멈춘 세션을 뒤늦게 발견해 생기는 공회전을 줄일 수 있다.
• Diff 화면을 검수 루틴으로 고정하자: AI가 고친 파일을 커밋 전에 비교 화면에서 한 번 훑는 습관만 들여도 엉뚱한 파일 수정 사고를 대부분 잡는다.
• 기존 훅과 충돌을 확인하자: 이미 settings.json에 알림·로그 훅을 쓰고 있다면 설치 전에 파일을 백업하고, 설치 후 기존 훅이 그대로 동작하는지 점검하는 편이 안전하다.
• 윈도·리눅스 사용자는 개념만 가져가자: 아이텀2는 맥 전용이다. 대신 클로드 코드 훅으로 상태 변화 때 알림을 보내는 간단한 스크립트를 만들면 비슷한 효과를 낼 수 있다.

전망

터미널이 AI 코딩 도구를 '관제'하는 방향으로 진화하고 있다. 사람이 에이전트 여러 개를 동시에 지휘하는 방식이 일상이 되면서, 무엇이 멈춰 있고 무엇을 검토해야 하는지 보여주는 화면이 생산성을 가르는 요소가 됐다. 다른 터미널·편집기도 비슷한 연동을 내놓을 가능성이 크다. 다만 훅이 설정 파일을 직접 수정하는 구조인 만큼, 여러 도구의 연동을 겹쳐 쓸 때 관리 부담이 커질 수 있다는 점은 염두에 둬야 한다.

출처: iTerm2 공식 문서 (https://iterm2.com/claude-code-integration.html)