Claude Code의 워크플로우 문서는 메뉴판과 같습니다

진정한 1인 창업자가 주문하는 방식은 다음과 같습니다.

$ git worktree list
~/app          a1b2c3d  [main]
~/app-review   e4f5g6h  [review-branch]
...

세 개의 체크아웃(Checkout). 하나의 머신. 각각은 서로를 건드릴 수 없는 자신만의 Claude Code 세션을 실행합니다.

이것이 저의 평범한 업무 일과입니다.

저는 1인 기업을 운영합니다. 콘텐츠와 코드가 같은 책상에서, 같은 시간에 이루어집니다. Anthropic의 공통 워크플로우 (common workflows) 페이지에는 일상적인 업무를 위한 약 12가지 정도의 레시피가 나열되어 있으며, 문서 자체는 강력합니다. 하지만 그 문서들이 말해주지 않는 것은, 어떤 레시피가 실제 업무 현장에서 살아남는지, 그리고 어떤 것들이 이론에만 머무는지에 대한 사실입니다.

Claude Code를 제 운영의 전부로 사용해 본 결과, 다섯 가지 워크플로우가 핵심적인 역할을 수행합니다. 솔직한 비중은 다음과 같습니다.

https://code.claude.com/docs/en/common-workflows

1. Worktree가 나의 작업 방식을 바꾸어 놓았다

Worktree가 해결하는 문제는 충돌 (collision)입니다.

Claude에게 버그 수정을 요청합니다. Claude가 수정하는 동안, 당신은 새로운 기능을 계속 빌드하고 싶을 것입니다. 동일한 저장소(Repo)에서 두 개의 편집 스트림이 발생하면, 당신의 작업 트리 (working tree)는 누구도 승리할 수 없는 싸움터가 됩니다.

Git worktree는 동일한 저장소를 별도의 브랜치에 두 번째로 체크아웃하는 것입니다. Claude는 그 안에서 실행되며 다른 창을 절대 볼 수 없습니다.

claude --worktree feature-auth

이번 주의 실제 시나리오입니다. 당신이 읽고 있는 이 포스트는 하나의 worktree에서 초안이 작성되는 동안, 별도의 Claude 세션은 다른 worktree에서 열려 있는 풀 리퀘스트 (Pull Request)를 검토했습니다. 어느 쪽도 서로의 파일에 손을 대지 않았습니다. 검토가 끝났을 때 저는 머지 (merge)를 하고 초안으로 돌아왔으며, 작업 흐름을 전혀 놓치지 않았습니다.

만약 문서에서 단 하나의 워크플로우만 가져간다면, 바로 이것을 가져가십시오. 설정 비용은 거의 제로에 가까우며, 병렬 에이전트 (parallel agents)들이 서로의 영역을 침범하는 것을 막아줍니다.

2. Subagent는 당신이 더 이상 살 수 없는 유일한 자원을 보호한다

모델의 작업 메모리 (working memory)가 바로 당신의 예산입니다.

Claude가 질문에 답하기 위해 읽는 모든 파일은 예산을 소모합니다. 대규모 저장소에서 "우리 인증 리프레시 (auth refresh)가 어떻게 작동하나요?"라고 물으면, Claude는 답변을 위해 수많은 파일을 읽습니다. 그러면 그 파일들은 세션이 끝날 때까지 컨텍스트 창에 머물며, 당신이 실제로 신경 써야 할 작업들을 밀어내게 됩니다.

그 작업을 서브에이전트 (subagent)에게 위임하세요.

use a subagent to investigate how our auth system handles token refresh

서브에이전트는 자신만의 창에서 내용을 읽고 요약하여 보고합니다. 당신의 메인 세션은 깔끔하게 유지됩니다.

저는 코드를 작성하기 전 조사할 때마다 이 기능을 의존합니다. 정찰병이 나가서 자료를 읽고, 조사 결과를 가지고 돌아오면, 저의 작업 세션은 가공되지 않은 소스 코드로 가득 차지 않습니다. 세션이 얼마나 날카로운 상태를 유지하느냐가 핵심이며, 서브에이전트는 그 상태를 유지해 주는 도구입니다.

3. 플랜 모드 (Plan mode)는 프로덕션 전의 안전벨트입니다

저는 실제 사용자가 연결된 라이브 앱을 운영하고 있습니다.

저는 Claude가 아무런 확인 없이 앱을 수정하도록 내버려 두지 않습니다.

플랜 모드는 Claude가 디스크에 접근하기 전에 먼저 읽고 제안하도록 만듭니다. 제가 승인하기 전까지는 아무것도 변경되지 않습니다.

claude --permission-mode plan

세션 중간에 Shift+Tab을 눌러 모드를 전환할 수 있습니다. 저는 프로덕션에 가까운 작업이라면 무엇이든 이 모드를 기본값으로 취급합니다. 먼저 읽고, 계획하고, 승인한 다음, 수정하십시오. 이 몇 초간의 검토 덕분에 원치 않는 변경 사항으로 인해 곤혹을 치르는 일을 이미 여러 번 면할 수 있었습니다.

4. 재개 (Resume) 및 PR 연결은 재설명 비용을 없애줍니다

실제 업무는 한 번의 앉은 자리에서 끝나지 않습니다.

다시 업무에 복귀할 때 가장 비용이 많이 드는 부분은 자신이 무엇을 하고 있었는지 다시 설명하는 것입니다. Claude Code는 모든 대화를 로컬에 저장하므로 그럴 필요가 없습니다.

claude --continue

이 명령은 현재 디렉토리에서 가장 최근의 세션을 불러옵니다. 제가 gh pr create로 풀 리퀘스트 (pull request)를 생성하면 세션이 그에 연결되며, claude --from-pr <number>를 사용하면 며칠 후에도 정확히 그 세션으로 바로 돌아갈 수 있습니다. 일주일 내내 편집해야 하는 지식 저장소(knowledge vault)의 경우, 이것은 업무의 연속성을 유지하느냐 아니면 매일 아침 아무것도 모르는 상태에서 새로 시작하느냐의 차이를 만듭니다.

5. 헤드리스 (Headless)의 함정은 제가 사람들에게 경고하는 부분입니다

문서에는 Claude를 CI나 배치 작업 (batch jobs)을 위한 스크립트에 파이프 (pipe)로 연결할 수 있다고 나와 있습니다.

git log --oneline | claude -p "summarize these recent commits"

이것은 실제 기능이며 매우 유용합니다. 하지만 문서가 말해주지 못하는 부분이 여기 있습니다.

2026년 6월 15일, Anthropic은 Agent SDK 과금 체계를 구독 서비스와 분리했습니다. 이제 헤드리스 (Headless) claude -p 실행은 Pro 또는 Max 계정의 구독료가 아닌 SDK 과금 기준으로 청구됩니다. 몇 달 전에 설정해두고 잊어버린 야간 크론 (nightly cron) 작업이 당신의 청구서 형태를 조용히 바꿀 수 있습니다.

저의 대응책은 반사적으로 헤드리스 (headless) 방식을 찾는 것을 멈추는 것이었습니다. 반복적인 작업의 경우, 일반 쉘 (shell) 작업에서 데이터를 미리 준비한 뒤, 서브에이전트 (subagents)를 사용하는 대화형 세션 (interactive session) 내에서 이를 소비하도록 합니다. 이렇게 하면 구독 범위 내에 머무를 수 있습니다. 결과는 동일하면서 비용은 예측 가능해집니다.

Claude를 자동화한다면, 작업을 스케줄링하기 전에 해당 작업이 과금 경계선의 어느 쪽에 속하는지 반드시 확인하십시오.

조용히 복리로 쌓이는 하나의 습관

Claude가 파일을 찾을 때까지 기다리는 대신, @를 사용하여 파일이나 디렉토리를 세션으로 직접 가져오십시오.

@src/utils/auth.js 파일의 로직을 설명해줘

그리고 텍스트가 적절한 도구가 아닐 때는 스크린샷을 붙여넣으십시오. 이미지를 창으로 드래그하거나 ctrl+v로 붙여넣으면 Claude가 이를 읽습니다. 제가 가장 빠르게 작성하는 버그 리포트는 에러 스크린샷과 "이게 왜 발생하는 건가요"라는 한 줄의 문장입니다. 사진 한 장에는 제가 다섯 문장으로 설명해야 했을 세부 사항들이 담겨 있습니다.

솔직한 점수판

워크플로우 (Workflow)	가치를 인정받는 순간
워크트리 (Worktrees)	한 번에 두 개 이상의 작업 스트림을 실행하는 순간
...

문서의 전반부에 있는 프롬프트 레시피 (prompt recipes)들은 한 번쯤 읽어볼 가치가 있습니다. 좋은 습관이며 빠르게 습득할 수 있습니다.

위의 다섯 가지는 다릅니다. 그것들은 단일 요청을 어떻게 표현하느냐가 아니라, 하루에 처리할 수 있는 작업량을 변화시킵니다.

하나가 더 추가될 예정입니다. Anthropic은 2026년 5월 28일 리서치 프리뷰 (research preview)를 통해 동적 워크플로우 (dynamic workflows)를 출시했습니다. 여기서는 스크립트가 서브에이전트 (subagents)를 조율하며, 최종 답변만이 대화에 도달합니다. 이것은 여기서 언급된 모든 것보다 한 단계 높은 단계이며, 프리뷰 기간이 끝나면 별도의 글로 다룰 가치가 있습니다.

당신의 설정 중, 신규 사용자라면 건너뛰겠지만 당신에게는 확실한 가치를 주는 워크플로우는 무엇인가요? 저는 문서에 없는 바로 그 방법을 알고 싶습니다.