준비
강의 전 현재 폴더, 계정, 설치 상태를 확인합니다.
Phase 66-6
코워크에서 클로드 코드로 — 같은 목표를 안전한 작업 파일로 넘기기
AI업무학교 샌드박스 실습 결과를 task-brief.md로 정리한 뒤, Claude Code에서 계획을 먼저 확인하고 별도 연습 폴더에 작은 로컬 분류·보고 도구를 만드는 실전 동반 강의입니다.
Execution Kit
실습 중 막히지 않기 위한 진행표
실행
코워크는 지식업무 정리, Claude Code는 파일·코드 실행으로 역할을 나눕니다.
검증
명령 결과, 파일 변화, 브라우저 화면 중 하나로 성공 여부를 확인합니다.
기록
잘 된 명령과 막힌 지점을 다음 실습을 위한 로그로 남깁니다.
막혔을 때 Claude Code에 붙여넣을 양식
나는 코딩 경험이 많지 않은 실무자입니다. "코워크에서 클로드 코드로 — 같은 목표를 안전한 작업 파일로 넘기기" 강의를 따라 하고 있습니다.
현재 상태:
- 사용하는 컴퓨터:
- 방금 실행한 명령:
- 화면에 나온 결과 또는 오류:
- 내가 만들고 싶은 업무 결과물:
요청:
1. 지금 상황을 초보자 기준으로 진단해줘.
2. 다음에 실행할 명령을 한 줄씩 제시해줘.
3. 각 명령이 무엇을 하는지 쉬운 말로 설명해줘.
4. 성공 여부를 확인할 체크 포인트를 정리해줘.
5. 실패하면 다시 붙여넣을 오류 보고 양식을 만들어줘.역할 구분 — 코워크는 정리, Claude Code는 실행
AI업무학교의 코워크 실습은 지식업무를 정리하는 데 강합니다. 목표, 자료, 판단 기준, 금지사항을 말과 문서로 정리하고, 어떤 산출물이 필요한지 합의하는 단계입니다.
Claude Code는 그다음에 씁니다. 로컬 폴더 안에서 파일을 만들고, 명령을 실행하고, 테스트를 돌리고, 변경 내용을 검토하는 실행 담당입니다.
따라서 안전한 연결 방식은 "같은 목표를 바로 실행시키기"가 아니라 "같은 목표를 작업 파일로 넘기기"입니다. 코워크에서 나온 샌드박스 실습 결과를 task-brief.md로 정리하고, Claude Code에는 그 파일만 기준으로 작은 로컬 작업을 맡깁니다.
이 구분을 지키면 AI가 말로 정리한 아이디어가 곧바로 운영 파일, 고객 자료, 외부 서비스로 번지지 않습니다. 코워크는 판단 정리, Claude Code는 제한된 폴더 안 실행입니다.
TIP: 코워크 결과를 그대로 붙여 넣어 실행시키기보다, 작업 목적·입력자료·금지사항·완료조건을 task-brief.md로 한 번 고정한 뒤 넘기세요.
실습 준비 — 샌드박스 결과를 task-brief.md로 고정하기
이번 실습은 AI업무학교 선행 강의에서 만든 샌드박스 결과를 Claude Code로 넘기는 과정입니다. 먼저 별도 연습 폴더를 만들고, 그 안에 task-brief.md를 작성합니다.
task-brief.md에는 다섯 가지가 들어가야 합니다.
1. 목표: 무엇을 만들 것인가
2. 입력자료: 어떤 샘플 텍스트를 사용할 것인가
3. 산출물: 어떤 파일이 생겨야 하는가
4. 금지사항: 외부 배포·삭제·권한 확대 금지
5. 완료조건: 어떤 테스트와 변경 검토를 통과해야 하는가
핵심은 "작업 범위를 파일로 좁히는 것"입니다. Claude Code에게 사무실 전체 폴더를 열어 주지 않고, 연습 폴더 안의 샘플 파일만 다루게 합니다.
# 별도 연습 폴더 만들기
mkdir -p ~/claude-code-practice/ai-school-handoff
cd ~/claude-code-practice/ai-school-handoff
# 코워크 결과를 작업 브리프로 정리
cat > task-brief.md << 'EOF'
# task-brief
## 목표
AI업무학교 샌드박스 실습 결과를 바탕으로, 상담 메모 샘플을 유형별로 분류하고 간단한 보고서 파일을 만드는 로컬 도구를 만든다.
## 입력자료
- sample-notes.txt
- 실제 개인정보, 고객사명, 사건번호는 넣지 않는다.
## 산출물
- classify-notes.js
- report.md
- README.md
## 금지사항
- 외부 배포 금지
- 파일 삭제 금지
- 홈 폴더나 실제 사건 폴더 접근 금지
- API 키, OAuth, MCP 연결, 권한 확대 금지
## 완료조건
- node classify-notes.js 실행 시 report.md가 생성된다.
- 변경 파일을 검토해 의도하지 않은 파일 수정이 없다.
- 되돌리기 방법이 README.md에 적혀 있다.
EOF계획 먼저 보기 — 바로 만들지 않게 멈춤선 세우기
Claude Code에 넘길 때는 먼저 계획만 요청합니다. 파일을 만들기 전에 어떤 파일을 만들지, 어떤 명령을 실행할지, 어디서 멈출지 확인합니다.
계획 요청은 실행 요청보다 안전합니다. AI가 작업 범위를 오해했거나 실제 사건 폴더를 건드리려 한다면, 이 단계에서 바로 잡을 수 있습니다.
좋은 계획에는 다음이 보여야 합니다.
- 현재 폴더 확인
- task-brief.md 읽기
- 샘플 입력 파일 생성
- 작은 로컬 스크립트 작성
- 실행 테스트
- 변경 검토
- 되돌리기 원칙 기록
계획에 외부 배포, 파일 삭제, 권한 확대, 실제 고객자료 접근이 들어가면 중단하고 수정합니다.
# Claude Code에서 먼저 던질 프롬프트
task-brief.md를 읽고 작업 계획만 제시해 주세요.
아직 파일을 만들거나 명령을 실행하지 마세요.
계획에는 다음을 포함해 주세요.
1. 만들 파일
2. 실행할 명령
3. 테스트 방법
4. 변경 검토 방법
5. 하지 않을 작업
외부 배포, 파일 삭제, 권한 확대, 실제 사건자료 접근은 하지 않는 전제로 계획해 주세요.TIP: 공식 CLI 문서의 `claude` 대화형 실행, `claude -p` 단발 질의, 파이프 입력 방식은 모두 유용하지만, 처음 실습에서는 대화형 세션에서 계획을 먼저 확인하는 흐름이 가장 안전합니다.
실습 실행 — 작은 로컬 분류·보고 도구 만들기
계획을 확인한 뒤에는 별도 연습 폴더 안에서만 작은 도구를 만듭니다. 도구의 목적은 거창한 자동화가 아니라 "작업 파일로 넘기면 Claude Code가 제한된 범위에서 파일을 만들고 검증한다"는 감각을 익히는 것입니다.
실습 도구는 sample-notes.txt의 상담 메모를 읽고, 임금·해고·산재·기타로 간단히 분류한 뒤 report.md를 생성합니다. 실제 법률 판단이 아니라 샘플 분류 연습입니다.
Claude Code에게 요청할 때는 산출물과 멈춤선을 같이 적습니다. 실행은 로컬 Node.js만 사용하고, 패키지 설치도 하지 않습니다.
# Claude Code 실행 프롬프트
task-brief.md의 범위 안에서만 작업해 주세요.
작업:
1. sample-notes.txt에 비식별 샘플 상담 메모 6개를 작성
2. classify-notes.js를 작성
3. node classify-notes.js 실행 시 report.md 생성
4. README.md에 실행 방법, 완료 조건, 되돌리기 원칙 작성
제약:
- 현재 폴더 밖 파일을 읽거나 쓰지 마세요.
- 외부 배포, 파일 삭제, 패키지 설치, API 호출, MCP/OAuth 연결은 하지 마세요.
- 실제 개인정보와 고객사 정보는 만들지 마세요.
- 먼저 변경 파일 목록을 설명하고, 실행 후 테스트 결과를 보고해 주세요.테스트와 변경 검토 — 실행 로그로 확인하기
Claude Code의 장점은 "그럴듯한 답변"이 아니라 실행 로그와 변경 파일이 남는다는 점입니다. 실습이 끝나면 반드시 테스트와 변경 검토를 합니다.
확인할 것은 세 가지입니다.
1. 실행 테스트: node classify-notes.js가 오류 없이 끝났는가
2. 산출물 확인: report.md가 생겼고 내용이 샘플 기준으로 맞는가
3. 변경 검토: 의도한 파일만 만들어졌는가
변경 검토에서 예상 밖 파일이 보이면 멈춥니다. 이유를 확인하기 전까지 다음 작업으로 넘어가지 않습니다.
# 테스트
node classify-notes.js
# 산출물 확인
cat report.md
# 변경 파일 확인
ls -la
git diff --no-index /dev/null report.md || true
# Git 저장소 안에서 실습했다면
git status --short
git diffTIP: Git 저장소 안에서 실습할 때는 `git status --short`와 `git diff`를 습관처럼 확인하세요. 커밋·푸시는 사람 승인 전에는 하지 않습니다.
완료 조건과 되돌리기 원칙
이번 실습은 파일이 만들어졌다는 사실만으로 완료되지 않습니다. 완료 조건을 통과해야 끝입니다.
완료 조건:
- task-brief.md의 목표와 실제 산출물이 일치한다.
- report.md가 로컬 명령으로 재생성된다.
- README.md에 실행 방법과 되돌리기 원칙이 있다.
- 변경 검토 결과 의도한 파일만 수정되었다.
- 외부 배포, 삭제, 권한 확대, 실제 데이터 접근이 없었다.
되돌리기 원칙:
- 연습 폴더 밖은 건드리지 않는다.
- Git 저장소라면 커밋 전에는 git diff로 변경을 확인한다.
- 되돌릴 때도 무작정 삭제하지 말고, 어떤 파일을 왜 제거하는지 먼저 목록화한다.
- 실제 사건자료나 운영 계정에 닿은 작업은 즉시 중단하고 사람에게 보고한다.
사람 승인이 필요한 작업:
- 외부 배포
- 파일 삭제
- 권한 확대
- OAuth·MCP·API 키 연결
- 고객자료 사용
- 커밋·푸시
- 의뢰인 또는 외부기관 발송
연결 자료
이 강의는 AI업무학교의 샌드박스 실습을 Claude Code의 안전한 로컬 실행으로 넘기는 동반 강의입니다. 선행 강의와 공식 문서를 함께 보면서 진행하세요.
- AI업무학교 선행 강의: https://ai-school.silronomu.com/lessons/6-19
- 유튜브 강의: https://youtu.be/DZ_B3VizOnc
- Claude Code 공식 CLI 문서: https://code.claude.com/docs/en/cli-usage
공식 CLI 문서 기준으로 Claude Code는 대화형 실행, 프롬프트 단발 실행, 파이프 입력, 최근 대화 이어가기 같은 명령 흐름을 제공합니다. 이번 실습에서는 대화형 실행에서 계획을 먼저 보고, 제한된 연습 폴더 안에서만 파일 생성과 테스트를 진행합니다.
핵심 정리
- ✓코워크는 지식업무 정리, Claude Code는 파일·코드 실행으로 역할을 나눕니다.
- ✓AI업무학교 샌드박스 실습 결과는 task-brief.md로 정리한 뒤 Claude Code에 넘깁니다.
- ✓Claude Code에는 먼저 계획만 요청하고, 별도 연습 폴더에서 작은 로컬 분류·보고 도구를 만듭니다.
- ✓완료 조건은 실행 테스트, report.md 산출물 확인, 변경 검토, README.md의 되돌리기 원칙 기록입니다.
- ✓외부 배포, 파일 삭제, 권한 확대, OAuth·MCP·API 키 연결, 커밋·푸시는 사람 승인 전에는 하지 않습니다.