출처
- source_url: https://code.claude.com/docs/ko/common-workflows
- author: Anthropic
- published: (미상, Claude Code 공식 문서)
- raw: raw source:
web-2026-06-29-claude-code-common-workflows
요약
이 문서는 Claude Code 공식 문서 중 “일반적인 워크플로우(Common Workflows)” 페이지로, 일상 개발에서 반복되는 작업을 위한 짧은 프롬프트 레시피를 모아 놓았다. 프롬프트 레시피 섹션은 낯선 코드베이스 이해, 관련 코드 찾기, 버그 수정, 리팩토링, 테스트 작성, PR 생성, 문서화, 이미지 분석 등 여덟 가지 작업 유형을 다룬다. 새 코드베이스를 파악할 때는 광범위한 질문으로 시작해 특정 영역으로 좁혀가고 프로젝트별 용어집을 요청하는 방식을, 버그 수정에는 재현 명령과 스택 추적, 간헐적/일관적 여부를 알려주는 방식을 권장한다. 리팩토링은 최신 접근 방식의 이점을 설명하게 하고 작고 테스트 가능한 증분으로 진행하며, 테스트는 Claude가 기존 테스트 파일의 스타일·프레임워크·어설션 패턴을 검토해 일치시키고 놓친 엣지 케이스를 식별하도록 요청할 수 있다.
특히 눈에 띄는 항목은 “노트 및 비코드 폴더에서 작업하기”로, Claude Code가 모든 디렉토리에서 작동하며 노트 저장소나 마크다운 파일 컬렉션 안에서 실행해도 코드처럼 콘텐츠를 검색·편집·재구성할 수 있고, .claude/와 CLAUDE.md가 다른 도구의 구성 디렉토리와 충돌 없이 공존하며 각 도구 호출마다 파일을 새로 읽으므로 외부 애플리케이션이 만든 편집 내용도 즉시 반영된다고 설명한다. 이미지 작업에서는 스크린샷·다이어그램·목업 분석이 가능하고 [Image #1]을 Cmd/Ctrl+Click으로 기본 뷰어에서 열 수 있다. 파일 참조는 @로 빠르게 포함시킬 수 있으며, 파일 경로 참조 시 해당 디렉토리와 상위 디렉토리의 CLAUDE.md가 자동으로 추가되고 디렉토리 참조는 내용이 아닌 파일 목록만 표시한다.
일정에 따라 Claude를 자동 실행하는 옵션은 실행 위치에 따라 네 가지로 나뉜다. Anthropic 관리 인프라에서 컴퓨터가 꺼져 있어도 실행되는 Routines, 로컬 파일·커밋되지 않은 변경사항에 접근해야 하는 데스크톱 예약 작업, 열린 PR이나 cron 일정과 연결되는 GitHub Actions, 현재 CLI 세션 동안만 동작하는 /loop가 있다. 예약된 작업 프롬프트는 성공 기준과 결과 처리 방식을 명시적으로 서술해야 한다는 점도 강조한다. Claude는 자신의 문서에 기본 접근 권한을 갖고 있어 “Claude Code로 PR을 만들 수 있는가” 같은 자기 기능 질문에도 최신 문서 기반으로 답할 수 있다.
이전 대화 재개는 claude --continue(현재 디렉토리 최근 세션)와 claude --resume(목록 선택)으로, 병렬 세션은 claude --worktree <이름>으로 각 worktree를 별도 브랜치 체크아웃으로 격리해 실행한다. 편집 전 검토가 필요하면 claude --permission-mode plan(또는 세션 중 Shift+Tab)으로 계획 모드에 진입해 승인 전까지 파일을 편집하지 않게 할 수 있다. 큰 코드베이스 탐색 시 컨텍스트가 파일 읽기로 채워지는 것을 막기 위해 “subagent를 이용해 ~를 조사해줘”처럼 subagent에게 연구를 위임하면 subagent가 자체 컨텍스트 윈도우에서 파일을 읽고 요약만 보고한다. 마지막으로 CI·사전 커밋 훅·배치 처리를 위해 git log --oneline -20 | claude -p "summarize these recent commits"처럼 stdin/stdout을 통해 비대화형으로 파이프할 수 있다.
관련 위키
원문 보존 위치
원문 전체는 raw source: web-2026-06-29-claude-code-common-workflows에 source_url과 함께 저장되어 있다.