터미널 밖으로

Part I — Containers

컨테이너 안의 Claude

Tip 21 — Containers for Long-Running Risky Tasks

위험하거나 오래 걸리는 작업은 컨테이너 안에서 실행하라

시스템에 영향을 줄 수 있는 작업을 컨테이너에서 격리하라. 실패해도 호스트에 흔적이 남지 않는다.

Claude Code는 터미널에서 명령어를 실행할 수 있다. 이것은 강력하지만, 동시에 위험하다. 잘못된 rm -rf, 의존성 충돌, 포트 충돌이 호스트 시스템을 망가뜨릴 수 있다. 컨테이너는 이 위험을 제거한다.

격리된 실험

새 프레임워크 테스트, 의존성 업그레이드, 마이그레이션 시도를 컨테이너에서 하면 실패해도 "docker rm"으로 끝난다.

재현 가능한 환경

Dockerfile로 정의된 환경에서 작업하면 "내 컴퓨터에서는 되는데"가 사라진다. CI/CD 환경과 동일한 조건으로 테스트.

워커 Claude

컨테이너 안에서 Claude Code 인스턴스를 띄우면 완전히 독립된 워커가 된다. 메인 작업과 별개로 장시간 돌아가는 작업을 위임.

컨테이너에서 Claude Code 실행 # 격리된 환경에서 실험 $ docker run -it --rm \ -v $(pwd):/workspace \ -w /workspace \ node:20 \ bash # 컨테이너 안에서 Claude Code 설치 & 실행 container$ npm install -g @anthropic-ai/claude-code container$ claude # 위험한 마이그레이션도 안전하게 > "의존성을 전부 최신 버전으로 올리고 빌드가 되는지 확인해줘"

Part II — Research Agent

리서치 에이전트

Tip 27 — Claude Code as a Research Tool

코딩 전에 조사부터. Claude는 훌륭한 리서치 도구다

기술 문서 분석, 라이브러리 비교, 아키텍처 조사 — 코드를 쓰기 전에 정보를 수집하고 종합하는 데 Claude Code를 활용하라.

대부분의 개발자가 Claude Code를 "코드 생성기"로만 쓴다. 하지만 실전에서 코딩에 쓰는 시간은 전체 개발 시간의 일부다. 어떤 라이브러리를 쓸지, 어떤 아키텍처를 선택할지, 기존 코드가 어떻게 동작하는지 조사하는 시간이 더 많다.

코드베이스 파악

"이 프로젝트의 아키텍처를 분석해줘. 주요 모듈 간 의존성, 데이터 흐름, 진입점을 정리해." — 새 프로젝트에 투입될 때.

라이브러리 비교

"Prisma와 Drizzle을 비교해줘. 성능, 타입 안전성, 마이그레이션 도구, 커뮤니티 규모 기준으로." — 기술 선택 전.

버그 원인 분석

"이 에러 로그를 분석해줘. 가능한 원인을 우선순위대로 나열하고, 각각의 확인 방법을 알려줘." — 디버깅 시작 전.

기술 문서 정리

"이 API 문서를 읽고, 우리 프로젝트에서 사용할 엔드포인트와 인증 방법을 정리해줘." — 외부 API 통합 전.

리서치 결과를 파일로 저장하면 다음 대화에서 참조할 수 있다. "analysis.md를 읽고 그 결론에 따라 구현해줘"라고 하면 리서치와 구현이 자연스럽게 연결된다.

Part III — DevOps Engineer

DevOps 엔지니어

Tip 29 — Claude Code as a DevOps Engineer

인프라 작업에도 소프트웨어 개발과 동일한 원칙을 적용하라

Dockerfile 작성, CI/CD 파이프라인, Nginx 설정, 모니터링 — 소프트웨어 개발과 동일한 Claude Code 워크플로우로 처리 가능하다.

DevOps 작업 예시 # Docker 멀티스테이지 빌드 최적화 "이 Dockerfile을 멀티스테이지 빌드로 최적화해줘. 최종 이미지 크기를 100MB 이하로 줄여." # GitHub Actions CI/CD "이 프로젝트에 GitHub Actions 워크플로우를 만들어줘. PR 시: lint + test main push 시: 빌드 + Docker push + 배포" # Nginx 리버스 프록시 "api.example.com은 포트 3000, app.example.com은 포트 8080으로 라우팅하는 Nginx 설정을 만들어줘. SSL 포함."

DevOps 작업은 "한 번 설정하면 끝"인 경우가 많다. 하지만 그 "한 번"이 복잡하고 에러가 나기 쉽다. Claude Code는 설정 파일의 문법 에러를 줄이고, 베스트 프랙티스를 자동으로 적용한다. 특히 Docker, Nginx, GitHub Actions 같은 선언적 설정 파일은 Claude의 강점이 가장 잘 드러나는 영역이다.

Part IV — Background Agents

백그라운드에서 돌려라

Tip 36 + 14 — Background Tasks & Terminal Tabs

서브에이전트를 백그라운드로 실행하고, 터미널 탭으로 멀티태스킹하라

오래 걸리는 작업을 백그라운드에 맡기고, 메인 대화에서 다른 작업을 계속한다. 터미널 탭으로 독립적인 Claude 세션을 여러 개 운영한다.

Claude Code의 서브에이전트(Task tool)는 독립적인 작업을 별도 프로세스로 실행할 수 있다. 메인 대화를 블로킹하지 않고 병렬로 작업이 가능하다.

Tab 1

메인 기능 개발

결제 모듈 구현 중. 테스트 작성과 구현을 반복하는 자율 모드.

Tab 2

버그 수정

운영 서버에서 발견된 인증 버그. 별도 브랜치(worktree)에서 수정 중.

Tab 3

리서치

다음 스프린트에 도입할 캐시 전략을 조사 중. 분석 결과를 cache-strategy.md에 작성.

핵심 규칙이 있다. 각 탭의 작업은 서로 독립적이어야 한다. 같은 파일을 두 탭에서 동시에 수정하면 충돌이 발생한다. Git worktree(3편)와 조합하면 각 탭이 다른 브랜치에서 작업하므로 이 문제를 깔끔하게 해결할 수 있다.

Part V — Simplify

복잡함을 줄여라

Tip 40 — Simplify Overcomplicated Code

AI가 만든 코드가 불필요하게 복잡하다면, AI에게 단순화를 요청하라

Claude(또는 다른 AI)가 생성한 코드가 과도하게 추상화되거나 복잡하다면, "더 단순하게 만들어줘"라고 요청하라.

AI 코딩 도구의 역설이 있다. Claude는 코드를 빠르게 만들지만, 때로는 불필요하게 복잡한 코드를 만든다. 3개의 파일로 충분한 것을 10개의 파일로 나누거나, 단순한 if-else로 될 것을 팩토리 패턴으로 감싸거나.

단순화 요청 패턴 # 코드 복잡도 진단 "이 모듈의 복잡도를 분석해줘. 불필요한 추상화, 과도한 파일 분리, 사용되지 않는 인터페이스를 찾아줘." # 직접적인 단순화 요청 "이 코드를 더 단순하게 리팩토링해줘. 파일 수를 줄이고, 불필요한 추상화를 제거해. 같은 기능을 유지하면서 읽기 쉽게 만들어줘." # 테스트와 함께 "리팩토링 후 기존 테스트가 모두 통과하는지 확인해줘."

"읽기 쉬운 코드가 유지보수 가능한 코드다." Claude에게 코드를 만들게 한 뒤, 한 걸음 물러서서 "이게 정말 필요한 복잡도인가?"를 질문하는 습관이 중요하다. 코드 생성의 속도만큼 코드 단순화의 판단력도 필요하다.

Claude Code는 코딩 도구가 아니라
개발자의 모든 업무를 위한 유니버설 인터페이스다.

Tip 31 — The Universal Interface

터미널은 제한이 아니라
가능성이다

마지막 편 "나만의 도구를 만든다"에서는 Claude Code의 궁극적 가치를 이야기한다. 개인화된 워크플로우, 메타 자동화, 그리고 도구의 도구.