--- title: "#클로드코드웹: 리포 PR 중심 워크플로우 - 비틀어보기" url: "https://notes.junghanacs.com/notes/20251111T155842" author: "Junghan Kim" date: "2025-11-11T22:43:00+09:00" lastmod: "2025-11-11T22:43:00+09:00" tags: ["claude","workflow","anthropic","ecosystem","github","request"] description: "Claude Code Web을 PR 중심 비동기 협업 워크플로우로 재해석하는 노트이다." --- > [!abstract] 이 노트에 대하여 > > 웹에서는 직접 파일을 고치지 못한다는 제약을 브랜치와 PR 중심 비동기 협업 방식으로 비틀어 읽는다. CLI와 웹의 차이를 생산성 워크플로우로 재정의하는 노트다. ## Claude Code Web PR 워크플로우 ### 🎯 핵심 통찰 > "리포 중심 환경에서 PR로 비틀어보기가 아닐까?" **제약을 워크플로우로 전환하기**: - ❌ "웹에서는 파일을 직접 수정 못 함" (제약) - ✅ "웹은 PR 중심 비동기 협업 환경" (워크플로우) --- ### 📊 Claude Code: Web vs CLI | 측면 | CLI | Web | |-------------|-----------------|----------------| | **실행 환경** | 로컬 터미널 | 클라우드 샌드박스 | | **토큰 한도** | 제한적 (사용량 초과 문제) | 더 자유로움 | | **작업 방식** | 동기식, 순차적 | 비동기식, 병렬 | | **파일 수정** | 직접 수정 (로컬) | PR 생성 (원격) | | **세션 복원** | `--teleport` 가능 | 새 대화 | | **Git 워크플로우** | 즉시 커밋/푸시 | 브랜치 + PR | | **적합한 작업** | 빠른 반복, 실시간 수정 | 잘 정의된 태스크, 문서화 | --- ### 🚀 Claude Code Web 철학 (Anthropic) #### 핵심 원칙 ##### **Delegation over Execution** - "assign multiple coding tasks to Claude" - 개발자 = 감독자, Claude = 실행자 ##### **Parallel over Sequential** - 여러 저장소, 여러 작업 동시 진행 - 순차적 병목 제거 ##### **Human-in-the-loop Oversight** - "actively steer Claude to adjust course" - Fire-and-forget 아님, 실시간 조정 가능 ##### **Automated Integration** - 자동 브랜치 생성 - 자동 PR 생성 (변경사항 요약 포함) - 테스트 결과 첨부 ##### **Security by Isolation** - 격리된 샌드박스 환경 - 보안 Git 프록시 (인증된 저장소만) - 네트워크/파일시스템 제한 --- ### 🔄 PR 중심 워크플로우 설계 #### 기본 패턴 ```text 사용자 요청 ↓ Claude Web 분석 및 계획 ↓ 작업 실행 (샌드박스) ↓ 브랜치 생성: claude/task-{session-id} ↓ 변경사항 커밋 ↓ PR 생성 (자동) ├── 변경사항 요약 ├── 테스트 결과 ├── 리뷰 제안 └── 체크리스트 ↓ 사용자 리뷰 → 머지 or 추가 수정 요청 ``` #### PR 구조 (Anthropic 권장) ```markdown ## Summary - 3-5 bullet points of what changed ## Changes Made - Specific files and modifications - Architecture decisions ## Testing - [x] Unit tests passed - [x] Integration tests - [ ] Manual verification needed ## Review Notes - Areas needing special attention - Trade-offs made - Future improvements ## Context - Related issues/PRs - Background information ``` --- ### 💡 실전 사용 사례 #### Use Case 1: 문서 작성/수정 **시나리오**: Anthropic 지원 문서 작성 **CLI 방식**: ```sh # 직접 파일 수정 claude "SUBMISSION-FIELDS.md 수정해줘" # 즉시 커밋 git add . && git commit - m "Update submission fields" ``` **Web 방식**: ```text 1. "SUBMISSION-FIELDS.md에서 Why Anthropic 섹션 개선해줘" 2. Claude가 분석 → 개선안 제시 3. 승인하면 브랜치 생성: claude/improve-why-anthropic-{id} 4. PR 생성: - Title: "Improve Why Anthropic section with authenticity" - Summary: 변경 이유, 주요 수정 내용 - Diff 포함 5. 리뷰 후 머지 ``` **장점**: - ✅ 변경사항 명확히 문서화 - ✅ 리뷰 프로세스 자연스러움 - ✅ 히스토리 깔끔하게 유지 #### Use Case 2: 멀티 태스크 병렬 실행 **시나리오**: 여러 문서 동시 작업 **Web 방식**: ```text Session 1: "PHILOSOPHY.md 톤 조정" → PR #1: claude/adjust-philosophy-tone-{id} Session 2: "PORTFOLIO.md 기술 스택 업데이트" → PR #2: claude/update-tech-stack-{id} Session 3: "README.md 구조 개선" → PR #3: claude/improve-readme-structure-{id} 모두 병렬로 실행 → 개별 PR → 순차적 머지 ``` **CLI로는 불가능한 패턴**: - 동시에 여러 세션 불가능 - 순차적으로만 작업 가능 #### Use Case 3: 메모리 시스템 연동 **시나리오**: `~/claude-memory` 문서 정리 **워크플로우**: ```text 1. Web에서 분석 요청: "memory/projects/ 아래 완료된 프로젝트 찾아서 archives/로 이동하는 스크립트 작성해줘" 2. Claude가 작업: - 스크립트 작성 - 테스트 실행 - 결과 문서화 3. PR 생성: - 스크립트 파일 - 이동 대상 목록 - 실행 가이드 4. 리뷰 후 로컬에서 실행: git checkout claude/archive-completed-projects-{id} bash scripts/archive-projects.sh # 확인 후 머지 ``` --- ### 🎯 힣's 컨텍스트: 웹 활용 전략 #### 현재 상황 **환경**: - 로컬: Ubuntu ThinkPad + NixOS 서버 - Claude Code CLI: 토큰 한도 제약 - Claude Web: 자유로운 토큰 사용 **프로젝트**: - Anthropic Korea 지원 문서 작성 - `~/claude-memory` 메모리 시스템 관리 - 8-config 생태계 유지보수 #### 웹 환경 최적 활용법 ##### 1. 문서 중심 작업 → Web ```text ✅ Anthropic 지원 문서 작성/개선 ✅ README, PHILOSOPHY 같은 장문 문서 ✅ 여러 문서 동시 작업 ✅ 구조 재설계 ``` **이유**: - 토큰 많이 사용하는 작업 - PR로 변경사항 명확히 리뷰 가능 - 병렬 작업으로 효율 극대화 ##### 2. 코드 수정 → CLI (로컬) ```text ✅ 빠른 버그 수정 ✅ 설정 파일 조정 ✅ 테스트 실행 및 디버깅 ``` **이유**: - 즉각적인 피드백 필요 - 반복적 수정 - 로컬 환경 의존성 ##### 3. 메모리 정리 → Web ```text ✅ 완료 프로젝트 아카이브 ✅ 중복 문서 통합 ✅ 태그 표준화 ✅ 구조 재정비 ``` **이유**: - 큰 그림 파악 필요 - 한 번에 많은 파일 분석 - 변경사항 체계적 리뷰 --- ### 🛠️ 실전 팁 #### Web 세션 최적화 1. **명확한 태스크 정의** ```text ❌ "문서 좀 개선해줘" ✅ "SUBMISSION-FIELDS.md의 Why Anthropic 섹션에서 '대장장이' 메타포의 과장된 톤을 줄이고, 진정성을 강조하도록 290 words 내로 재작성해줘" ``` 2. **PR 제목 가이드 제공** ```text "작업 완료 후 PR 제목은: 'docs: Improve Why Anthropic section with authentic tone' 형식으로 해줘" ``` 3. **테스트 기준 명시** ```text "변경 후 다음 확인: ​ - Word count 280-300 범위 ​ - '4년' 표현 유지하되 과장 제거 ​ - 대장장이 메타포 간결하게" ``` #### PR 머지 전략 **옵션 1: 즉시 머지** (권장: 문서 작업) ```sh gh pr checkout 123 # 리뷰 후 gh pr merge 123 - -squash ``` **옵션 2: 로컬 수정 후 머지** ```sh gh pr checkout 123 # 추가 수정 git add . && git commit - -amend git push - -force-with-lease gh pr merge 123 ``` **옵션 3: 새 세션으로 추가 작업** ```text Web에서: "PR #123 기반으로 추가 개선: - 톤 더 부드럽게 - 예시 하나 추가" → 새 PR 생성 (체인) ``` #### 메모리 시스템 연동 **Web → Memory 패턴**: 1. **분석 및 제안** ```text "memory/projects/ 아래 __active 태그 문서 30개 분석해서 완료된 것 같은 프로젝트 리스트 만들어줘" ``` 2. **실행 스크립트 생성** ```text "위 리스트 기반으로 archives/로 이동하고 __done 태그 추가하는 스크립트 작성" ``` 3. **PR 리뷰** - 이동 대상 확인 - 스크립트 안전성 검토 - **로컬 실행** ```sh git checkout claude/archive-projects-{id} bash scripts/archive-completed-projects.sh ​- -dry-run # 확인 후 실행 bash scripts/archive-completed-projects.sh git commit ​- -amend gh pr merge ``` --- ### 🔮 미래 확장 #### Phase 1: 기본 PR 워크플로우 (현재) - ✅ Web에서 작업 요청 - ✅ PR 생성 - ✅ 로컬에서 머지 #### Phase 2: 자동화 강화 - [ ] PR 템플릿 표준화 - [ ] 리뷰 체크리스트 자동 생성 - [ ] CI/CD 통합 (Denote 검증 등) #### Phase 3: Agent Orchestration - [ ] Web Agent가 Memory Agent와 협업 - [ ] 복잡한 멀티 스텝 작업 자동화 - [ ] 사용자는 최종 승인만 --- ### 📚 참고 자료 **Anthropic 공식**: - [Claude Code on the Web](https://www.claude.com/blog/claude-code-on-the-web) - [Claude Code Documentation](https://code.claude.com/docs) **핵심 개념**: - Delegation over Execution - Human-in-the-loop Oversight - Parallel Task Management - Automated PR Creation **관련 문서**: - `CLAUDE.md` - Agent 지침서 - `PACKAGE-MANAGEMENT.md` - NixOS 환경 제약 - `memory/resources/workflows/` - 기존 워크플로우들 --- ### ✅ 액션 아이템 #### 즉시 실행 가능 ##### **Anthropic 지원 문서 개선** - Web에서 각 문서 개선 요청 - 개별 PR로 리뷰 - 순차적 머지 ##### **Memory 정리 프로젝트** - Web에서 분석 및 스크립트 작성 - PR 리뷰 - 로컬 실행 ##### **이 문서 자체를 테스트** - 현재 작업이 첫 테스트! - PR 생성하여 리뷰 - 워크플로우 개선점 기록 #### 다음 단계 - [ ] PR 템플릿 작성 - [ ] 체크리스트 표준화 - [ ] 성공/실패 사례 수집 - [ ] 워크플로우 지속 개선 --- **Version**: 1.0 **Author**: 힣 (with Claude Web) **Updated**: 2025-11-11T15:58 **Status**: Living Document --- **메타**: 이 문서는 Claude Code Web에서 PR 워크플로우로 작성된 첫 문서입니다.