Claude Code를 쓸 때 IDE 대신 터미널 하나로 충분한 이유 — TreeRU 실사용 워크플로우

저는 매일 Claude Code로 개발합니다. 이 블로그도, 서버 관리도, 사이드 프로젝트도 전부 터미널에서 합니다. IDE를 안 쓰는 건 아닙니다. 다만 Claude Code를 쓸 때는 터미널 환경이 더 자연스럽습니다.AI가 코드를 읽고 수정하는 데 IDE 화면이 필요한 건 아니니까요. 대신 파일 구조 확인, 스크린샷 전달, 사용량 체크처럼 반복적인 작업이 불편했습니다. 그래서 직접 만든 도구가 TreeRU입니다. 이 글에서는 제가 실제로 매일 쓰는 워크플로우를 처음부터 끝까지 공유합니다.

왜 이 글을 쓰게 되었나

Claude Code를 처음 쓴 날부터 느낀 점이 있습니다. AI가 코드를 잘 짜주는 건 좋은데, 주변 환경이 안 따라갑니다.

IDE(Cursor 같은)를 쓰면 일부 해결됩니다. 하지만 IDE는 무겁습니다. 프로젝트를 전환할 때마다 창을 닫고 열어야 하고, 원격 서버 작업은 또 다른 설정이 필요합니다. 저는 가볍게, 빠르게, 터미널 안에서 전부 해결하고 싶었습니다. 그래서 TreeRU를 만들었고, Claude Code와 함께 쓰는 지금의 워크플로우가 완성되었습니다.

기본 세팅 — 5분이면 끝납니다

필요한 건 세 가지뿐입니다.

git clone https://github.com/treeru/treeru.git
cd treeru && npm install
node index.js

화면 분할로 시작하기

Windows Terminal에서 Ctrl+Shift+D를 누르면 화면이 반으로 나뉩니다. 왼쪽에서 Claude Code를 실행하고, 오른쪽에서 treeru를 실행합니다. 이게 기본 구조입니다.

┌─────────────────────────┬────────────────────────────────┐
│                         │ > ..         │ > components    │
│  Claude Code            │ > src        │   index.js      │
│                         │ > public     │   package.json  │
│  "이 파일 수정해줘"     │ > lib        │   README.md     │
│  "에러 화면 봐줘"       │   .env       │   tsconfig.json │
│  "테스트 돌려줘"        ├──────────────┤                 │
│                         │              │                 │
│                         │  TreeRU      │                 │
└─────────────────────────┴──────────────┴─────────────────┘

왼쪽에서 AI가 코드를 짜고, 오른쪽에서 파일 구조를 실시간으로 확인합니다. TreeRU는 파일 변경을 자동 감지하기 때문에, Claude Code가 파일을 만들거나 수정하면 오른쪽에 바로 반영됩니다.ls나 tree를 반복해서 칠 필요가 없습니다.

F9/F12 — 프로젝트 등록과 실행

제가 가장 자주 쓰는 기능입니다. 프로젝트 폴더를 한 번 등록해두면, 어디서든 두 번의 키 입력으로 해당 프로젝트에서 Claude Code가 실행됩니다.

최초 등록 (한 번만)

매일 쓰는 실행 (F12)

탐색기 열고, 폴더 찾고, 경로 복사하고, 터미널 열고, cd 하고, claude 치는 과정이 F12 → Enter로 줄어듭니다. 프로젝트가 여러 개일 때 특히 편합니다. 저는 블로그, TreeRU, 서버 관리용 등 5~6개를 등록해두고 수시로 전환합니다. 더 이상 쓰지 않는 워크스페이스는 F12 메뉴에서 Del키로 바로 삭제할 수 있습니다.

스크린샷 워크플로우 — 이게 핵심입니다

Claude Code를 쓰면서 가장 답답한 순간이 언제인지 아시나요? 브라우저에 에러가 떠서 AI에게 보여주고 싶을 때입니다.

IDE를 쓴다면 이미지를 드래그하면 되겠지만, 터미널에서는 파일 경로를 텍스트로 전달해야 합니다. 저도 처음에는 이 과정이 번거로웠습니다. 캡처하고, 파일 탐색기 열고, 이미지 저장하고, 경로 복사하고… TreeRU를 만든 후로는 이렇게 합니다.

전체 과정이 5초 이내에 끝납니다. 브라우저를 열 필요도, 파일 탐색기를 열 필요도, 경로를 타이핑할 필요도 없습니다. 캡처 → 경로 복사 → 붙여넣기. 이 세 단계가 전부입니다. 이 기능 하나 때문에 TreeRU를 만들었다고 해도 과언이 아닙니다.

F8 — 사용량 모니터링

Claude Code를 쓰다 보면 한 가지 신경 쓰이는 게 있습니다. “사용량이 얼마나 남았지?”Pro나 Max 플랜을 쓰고 있다면, 세션별·주간별 사용 한도가 있기 때문에 남은 양을 수시로 확인하고 싶어집니다.

원래는 브라우저에서 claude.ai → 설정 → 사용량 페이지를 열어야 합니다. 작업 흐름이 끊깁니다. 그래서 TreeRU에 F8 기능을 넣었습니다.

  TreeRU v1073                          Session 12% 2:53 | Weekly 5%  3 SSH hosts
┌──────────────────────────────────────────────────────────────────────────────┐

F8을 누르면 상단 헤더에 두 가지 정보가 나타납니다:

• Session 12% 2:53 — 현재 세션 사용량 12%, 리셋까지 2시간 53분 남음
• Weekly 5% — 주간 전체 모델 사용량 5%

색상으로도 상태를 바로 알 수 있습니다. 50% 미만은 파란색, 50~80%는 노란색, 80% 이상은 빨간색입니다. 빨간색이 보이면 “좀 아껴 써야겠다”는 신호입니다.

최초 설정 (한 번만)

처음 F8을 누르면 Chrome(또는 Edge) 창이 하나 열립니다. claude.ai에 로그인합니다. 브라우저를 닫습니다. 다시 F8을 누릅니다. 끝입니다.

로그인 세션이 로컬에 저장되기 때문에, 이후로는 F8만 누르면 됩니다. 처음 한 번은 약 3초 걸리지만, 그 뒤로는 0.4초면 새로고침됩니다. 헤드리스 브라우저가 백그라운드에서 유지되기 때문입니다. 컴퓨터를 재시작해도 로그인은 유지되고, 첫 F8만 살짝 느린 뒤 계속 빠릅니다.

SSH 원격 개발

서버에서 직접 Claude Code를 실행해야 할 때가 있습니다. 배포 스크립트를 수정하거나, 서버 설정을 변경하거나, 원격 환경에서만 재현되는 버그를 잡을 때입니다.

TreeRU에서 이 과정이 매우 간단해집니다.

ssh user@server 치고, cd /path/to/project 하고, claude 치는 3단계가 F12 → Enter 한 번으로 끝납니다. 서버가 여러 대라면 각각 등록해두면 됩니다. F12 목록에 로컬 프로젝트와 원격 프로젝트가 함께 나타나기 때문에, 전환도 빠릅니다.

SSH 접속 상태에서 스크린샷을 찍으면 원격 서버에 자동 업로드됩니다. 로컬에서 파일을 Ctrl+C로 복사한 뒤 F5를 누르면 SFTP로 원격 폴더에 전송됩니다. 별도의 FTP 클라이언트가 필요 없습니다.

실제 하루 워크플로우

제 실제 루틴을 그대로 공유합니다.

IDE와 비교하면

솔직하게 말하면, IDE가 더 좋은 상황은 분명히 있습니다.코드 자동완성, 디버거 연동, Git GUI 등은 IDE의 강점입니다. 하지만 Claude Code를 쓸 때는 이야기가 다릅니다.

요점은 이렇습니다. Claude Code가 코드를 작성하는 역할을 대신하기 때문에, IDE의 자동완성이나 인텔리센스 기능은 상대적으로 덜 중요해집니다. 대신 파일 탐색, 스크린샷 전달, 프로젝트 전환처럼 AI 옆에서 보조하는 작업이 더 중요해지는데, 이 부분에서 터미널 + TreeRU 조합이 효율적입니다. 무엇보다 가볍습니다. 배경에서 무겁게 돌아가는 프로세스가 없습니다.

매일 쓰면서 알게 된 팁

마무리

IDE가 나쁘다는 얘기가 아닙니다. 다만 Claude Code를 메인 도구로 쓰고 있다면,터미널 환경이 생각보다 충분하다는 걸 말씀드리고 싶었습니다.

TreeRU는 거창한 도구가 아닙니다. 파일 탐색, 스크린샷 자동 저장, 사용량 확인, SSH 원격 접속. 하나하나는 작은 기능이지만, Claude Code와 조합하면 IDE 없이도 불편하지 않은 환경이 만들어집니다.

직접 만들어서 매일 쓰고 있고, 실제로 이 블로그도 이 워크플로우로 작성되었습니다. 오픈소스이고 무료이니, 가벼운 마음으로 한번 써보시길 바랍니다.