01실습업무실전 투입만든 스킬을 실제 업무 자료로 한 번 돌리고, 통과한 지점과 손댄 지점을 workflow.md에 기록할 수 있습니다내용 열기내용 접기
실제 업무 자료로 실행한 결과를 확인하고 통과·수정 내용을 기록합니다.
자료 한 건을 골라 스킬을 한 번 실행합니다
여러 건을 한꺼번에 돌리면 어디서 어긋났는지 찾기 어려우므로 처음에는 한 건만 봅니다.
출력을 workflow.md에 적어 둔 출력 기준과 대조합니다
기준과 맞는 부분이 통과한 지점이고, 사람이 다시 손댄 부분이 아직 못 맡기는 지점입니다.
두 가지를 나눠 적어 두면 다음에 무엇을 고칠지가 남습니다.
첫 실행은 발송·공개 단계에 바로 걸지 않습니다. 출력만 만들고 사람이 확인한 뒤 내보냅니다
붙여넣기 예제: 순서의 각 단계 아래. 위에서부터 하나씩 실행합니다
실제 업무 자료 한 건을 고릅니다.
스킬을 그 자료로 한 번 실행합니다.
[스킬 이름]을 이 자료로 한 번 실행해 줘. 결과를 내보내지 말고 출력만 만들어 줘.
확인스킬이 실행되고, 출력만 만들어집니다.
나온 출력을 workflow.md의 출력 기준과 대조합니다.
방금 만든 출력을 workflow.md의 출력 기준과 대조해서 두 가지로 나눠 정리해 줘.
- 기준과 맞은 지점
- 내가 다시 손대야 하는 지점
확인출력이 기준과 맞은 지점과 손대야 하는 지점, 두 가지로 나뉘어 정리됩니다.
사람이 손댄 지점을 적습니다.
다음에 고칠 것 하나를 정해 workflow.md에 남깁니다.
지금까지 나온 손댄 지점 중에서 다음에 고칠 것 하나를 골라서, 이유와 함께 workflow.md에 추가해 줘.
확인다음에 고칠 것 하나가 이유와 함께 workflow.md에 추가됩니다.
연습
같은 스킬을 다음 주 자료로 한 번 더 돌려 보고, 손대는 지점이 줄었는지 확인해 보세요.
실제 자료로 한 번 돌린 결과가 있고, workflow.md에 통과한 지점과 손댄 지점이 나뉘어 적혀 있으면 통과입니다.
알아두면 좋습니다
첫 실행을 발송, 결제, 공개처럼 되돌리기 어려운 단계에 바로 걸지 말고, 출력만 만들어 두고 사람이 확인한 뒤 내보냅니다. 실습에 회사 자료를 쓸 때는 사내 기밀 문서 원문과 고객·직원 개인정보를 넣지 않고, 업무 빈도나 자료의 종류처럼 일반화한 정보로 바꿔 씁니다. 결과가 기대와 다르다고 스킬을 통째로 다시 쓰지 않습니다. 손댄 지점 하나를 고치고 다시 돌리는 편이 무엇이 효과가 있었는지 알기 쉽습니다.
03실습Deploy배포했다는 말과 화면이 살아 있는 것배포 뒤에 파일 수와 실제 화면을 직접 확인해서, 조용히 빠진 파일을 잡아낼 수 있습니다내용 열기내용 접기
배포 성공 표시가 나와도 화면이 죽어 있을 수 있습니다
예: 저장소에 없는 파일이 조용히 빠지는 경우
왜 대조가 통과하는데 화면이 깨지납니다
흔한 방식: 배포 전후 파일을 하나씩 맞춰 보기
이 방식은 양쪽에 다 있는 파일만 봅니다. 한쪽에서 통째로 사라진 파일은 비교 대상에 없어 전부 일치로 나옵니다
실제 사례: 배포한 사이트의 이미지 파일 2,768개가 빠졌는데, 남은 파일끼리의 대조는 전부 일치였습니다
화면을 열고 나서야 리포트 이미지가 전부 깨진 걸 알았습니다
원인: 그 폴더의 .gitignore에 이미지 폴더가 적혀 있어, 저장소에서 새로 내려받은 복사본에 그 파일이 없었습니다
대책: 개수를 세는 확인. 직전 배포보다 파일이 수백 개 줄었으면 그 자리에서 멈춥니다
반대 방향도 있습니다
자산이 다 있는 폴더에서 배포해도 코드가 옛날 것일 수 있습니다
실제 사례: 같은 사이트가 며칠 전 상태로 되돌아갔습니다. 배포에 쓴 폴더가 최신보다 365커밋 뒤에 있었습니다
배포할 폴더가 동시에 만족할 두 조건
코드가 최신인가
저장소에 없는 자산이 갖춰져 있는가
한 폴더가 둘 다 못 채우면, 최신 코드를 받아 빠진 자산을 복사해 넣은 다음 거기서 배포합니다
마지막은 눈으로
마지막: 주소를 열어 이미지가 뜨는지, 링크가 열리는지 직접 봅니다
직전 배포와 비교하는 검사만 믿으면, 한 번 잘못 나간 상태가 다음 기준이 돼 계속 통과합니다
배포하기 전에 배포할 폴더의 `.gitignore`를 엽니다. 여기 적힌 파일은 저장소에 없어서, 깨끗한 복사본에서 배포하면 따라오지 않습니다.
배포에 쓰는 폴더가 최신인지 확인합니다. 자산이 다 있어도 코드가 며칠 전 것이면 옛 화면이 나갑니다.
배포 뒤에 올라간 파일 개수를 직전 배포와 비교합니다. 수백 개가 줄었으면 멈추고 원인을 찾습니다.
마지막에 실제 주소를 브라우저로 열어, 이미지가 뜨는지, 링크가 열리는지 눈으로 봅니다.
연습
최근에 배포한 사이트가 있으면 주소를 직접 열어 이미지가 전부 뜨는지 보세요. 목록에서 하나를 골라 클릭까지 해 보면 더 정확합니다.
배포가 성공했다는 표시만 보고 끝냈는지, 주소를 열어 봤는지 답할 수 있으면 통과입니다.
알아두면 좋습니다
배포 전후 파일을 하나씩 대조해도 없어진 파일은 안 잡힙니다. 비교 대상이 남아 있는 파일뿐이기 때문입니다. 개수를 세야 잡힙니다. 직전 배포와 비교하는 검사도 한 번 잘못 나가면 그 잘못된 상태가 다음 비교의 기준이 됩니다. 그래서 화면을 직접 여는 확인이 마지막에 필요합니다.
CLAUDE.md는 참고할 규칙을 전달하고, Hook은 조건을 검사할 시점과 실패했을 때의 동작을 정합니다
대표적인 시점:
PreToolUse — 도구 실행 전
PostToolUse — 도구 실행 후
SessionStart — 세션 시작 시
저장 자체를 막아야 하면 PreToolUse를 사용합니다
PostToolUse는 파일이 바뀐 뒤에 실행되므로 이미 끝난 수정을 되돌리지 못하고 검사 결과만 알려 줍니다
등록 위치: .claude/settings.json. 등록하면 그 시점마다 확인 요청 없이 명령이 실행됩니다
등록 목록 보기: /hooks 명령(읽기 전용 브라우징)
수정: 설정 파일을 직접 고치거나 Claude에게 요청
개발 직군 밖에서도 씁니다:
문서를 작성하는 직군이라면 파일을 저장할 때마다 포맷·오탈자 검사 스크립트가 자동 실행되게 걸어 둘 수 있습니다.
기획서를 다루는 직군이라면 필수 항목이 빠졌는지 확인하는 검사를 같은 방식으로 걸 수 있습니다.
Hook은 확인 절차 자동화에 쓰고, 실행 여부의 최종 판단은 사람에게 남깁니다
commit 직후 배포까지 이어지는 Hook을 걸면 검수를 통과하지 못한 변경도 그대로 나갈 수 있습니다
등록만 확인해서는 실제로 막는지 알 수 없으므로 조건을 어긴 입력과 정상 입력을 하나씩 실행합니다
명령형·HTTP형 Hook이 제한 시간을 넘기면 기본 흐름이 계속될 수 있으므로 통과로 기록하지 않습니다
실습: 순서 아래 실행 요청을 붙여넣어 금칙어가 든 파일은 저장 전에 막히고 정상 파일은 저장되는지 확인합니다
자동화할 검사를 하나 고릅니다 — 포맷터·문서 검사처럼 되돌리기 쉬운 것부터 시작합니다.
.claude/settings.json에 Hook을 등록합니다.
실행 시점(이벤트)을 지정합니다 — 도구 실행 전(PreToolUse), 도구 실행 후(PostToolUse), 세션 시작 시(SessionStart) 등입니다.
일부러 조건을 어긴 파일과 정상 파일을 각각 저장해, 차단과 통과가 모두 동작하는지 확인합니다.
/hooks 명령으로 등록된 Hook 목록을 확인합니다 — 읽기 전용 브라우징이며, 수정은 설정 파일에서 합니다.
연습
hook을 건 뒤 파일을 실제로 하나 고쳐, 검사가 자동으로 실행되는지 확인해 보세요.
조건을 어긴 입력은 실제로 막히고 정상 입력은 통과하면 됩니다. 제한 시간 초과나 Hook 오류로 검사가 끝나지 않은 경우는 통과로 세지 않습니다.
알아두면 좋습니다
Hook 스크립트에 실행 권한이 없거나 명령 경로가 틀리면 검사 자체가 실패합니다. PostToolUse는 이미 끝난 파일 수정을 되돌릴 수 없으며, 명령형·HTTP형 Hook이 제한 시간을 넘기면 기본 흐름이 계속될 수 있습니다. 실패 입력과 정상 입력을 각각 실행하고, 삭제·배포·결제·메시지 발송은 초보자 Hook에 넣지 않습니다.
“알아서 해줘”처럼 기준 없이 통째로 넘기면 실행 담당이 임의로 채운 부분이 재작업으로 돌아옵니다
위임 문장에 원하는 형식·범위·완료 조건을 넣습니다
지금 하는 작업을 판단(설계·검수)과 실행(반복·생성)으로 나눕니다.
지금 내가 하려는 작업을 판단(설계·리뷰)과 실행(반복·보일러플레이트) 두 갈래로 나눠서 표로 보여줘. 판단 쪽은 내가 직접 하고, 실행 쪽은 네가 서브에이전트나 가벼운 모델로 처리할 수 있는지도 같이 짚어 줘.
---
작업: 랜딩페이지 카피 초안을 5개 버전으로 뽑고, 그중 톤이 가장 잘 맞는 걸 골라야 함
확인판단/실행 두 갈래로 나뉜 표가 나오고, 초안 5개 버전을 뽑는 실행 부분은 서브에이전트나 가벼운 모델에, 톤을 고르는 판단은 직접 하도록 짚어집니다.
실행 몫을 맡길 서브에이전트를 정하고, 정의 파일의 model 필드를 sonnet·opus·haiku 중 필요한 것으로 지정합니다.
방금 나눈 실행 몫을 맡을 서브에이전트를 하나 만들어 줘. 정의 파일의 model 필드는 이 작업 난이도에 맞게 sonnet·opus·haiku 중에서 골라 지정해 줘.
확인서브에이전트 정의 파일이 만들어지고, model 필드에 작업 난이도에 맞는 모델이 지정됩니다.
위임 문장에 원하는 형식과 완료 조건을 명시해 요청합니다.
실행 담당이 낸 결과를 판단 담당이 검수합니다.
방금 서브에이전트가 낸 결과를 검수해 줘. 처음에 정한 형식과 완료 조건에 맞는지 확인해 줘.
확인결과가 처음 정한 형식과 완료 조건에 맞는지 확인되고, 어긋난 지점이 있으면 짚어집니다.
터미널·IDE·데스크톱 등 어디서 작업해도 CLAUDE.md·설정·MCP 연결은 다시 맞추지 않고 그대로 씁니다.
연습
위임한 결과를 받으면, 판단 담당인 본인이 원하는 기준에 맞는지 검수해 보세요.
판단이 필요한 부분과 반복 실행 부분을 구분해 다른 실행 주체에 나눠 맡길 수 있으면 통과입니다.
알아두면 좋습니다
위임 문장에 기준과 완료 조건을 담지 않으면, 실행 담당이 임의로 판단해 다시 고쳐야 하는 결과가 나옵니다. 이때는 원하는 형식과 범위를 문장에 명시해 재작업을 줄입니다. 짧은 일까지 전부 위임하면 왕복 비용이 직접 하는 것보다 커지고 검수할 사람도 사라지니, 판단이 필요한 만큼만 남기고 나머지만 넘깁니다.
06설치MCPClaude에 Higgsfield 연결하기Claude에 Higgsfield를 연결하고, 생성 없이 잔여 크레딧과 예상 크레딧부터 확인할 수 있습니다.내용 열기내용 접기
연결 뒤 첫 요청은 잔액 확인입니다
Higgsfield: 이미지와 영상을 만드는 유료 AI 생성 서비스. 만들 때마다 계정 크레딧이 줄어듭니다
Claude에 연결하면 이미지·영상 생성 도구를 대화 안에서 부를 수 있습니다
첫 요청: 생성이 아니라 연결 상태와 잔여 크레딧 확인
크레딧 차감 기준: 모델, 해상도 같은 설정
모델을 고른 뒤 higgsfield generate cost로 1회 생성에 필요한 크레딧을 먼저 확인합니다
생성 전에 네 가지가 있어야 합니다
승인된 콘티(장면마다 무엇을 보여 줄지 적은 구성표)
사용할 입력 이미지
모델과 설정
예상 크레딧과 생성 횟수
하나라도 비어 있으면 생성하지 않습니다
여러 테이크가 필요해도 한 장 또는 한 숏으로 방향을 확인한 뒤 다음 생성을 승인받습니다
이름이 비슷한 두 명령 가운데 강조 상자만 실제로 생성합니다.
이미지가 없으면 Codex에서 먼저 만듭니다
쓸 이미지가 없으면 Codex의 이미지 생성으로 시작 프레임을 만듭니다
사람이 제품 형태, 글자, 구도, 브랜드 기준을 확인해 승인한 이미지 한 장만 Higgsfield 영상 입력으로 넘깁니다
같은 유료 도구에서 이미지와 영상을 연속으로 만들면 어긋난 단계를 찾기 어렵고 크레딧도 두 번 씁니다
정지 이미지에서 방향을 먼저 고정하면 영상 단계에서는 움직임만 검수합니다
승인 문장에는 범위를 적습니다
네 항목을 한 줄에 적습니다
승인: SHOT-01 · 영상 1회 · 예상 24cr · 입력 이미지 approved-frame.png
이 문장의 승인 범위: SHOT-01 한 건, 1회 생성
모델, 길이, 해상도, 생성 횟수가 바뀌면 비용을 다시 확인하고 새 승인을 받습니다
Claude 웹이나 데스크톱 앱에서 사용자 지정 커넥터를 엽니다. 아래 공식 연결 페이지의 버튼을 누르면 입력창까지 바로 이동합니다. Pro·Max는 Customize > Connectors에서 직접 추가하고, Team·Enterprise는 관리자가 조직 설정에서 먼저 추가해야 목록에 보입니다. 무료 플랜은 사용자 지정 커넥터를 하나까지만 둘 수 있습니다.
Set up Higgsfield for me so I can generate images and videos from here.
1. Install the CLI: run `npm i -g @higgsfield/cli`.
2. Authenticate: run `higgsfield auth login` and complete the sign-in in the browser it opens.
3. Install the companion skills: run `npx skills add higgsfield-ai/skills`.
Once that's done, let me know when it's ready.
Higgsfield를 연결한 뒤 생성하지 않은 상태에서 잔여 크레딧과 예상 크레딧 확인 명령을 각각 한 번 확인합니다.
Claude에서 Higgsfield 연결 상태를 확인하고, 생성 없이 잔여 크레딧과 한 숏의 예상 크레딧을 확인할 수 있으면 통과입니다.
알아두면 좋습니다
Higgsfield 공식 페이지는 Claude 웹·데스크톱 앱에는 MCP 연결을, Claude Code에는 CLI 설치를 안내합니다. 둘을 한꺼번에 설치할 필요는 없습니다. 사용자 지정 커넥터에 API 키나 OAuth 시크릿을 직접 적지 않습니다. `generate cost`와 `generate create`는 이름이 비슷하지만, 앞의 명령은 예상 비용만 계산하고 뒤의 명령은 실제 크레딧을 씁니다.
예시 화면 Claude의 커스텀 커넥터 입력창에 이름과 공식 MCP 주소를 적은 화면입니다.
크레딧이 충전돼 있어도 구독이 없으면 생성이 실행되지 않습니다. 첫 확인으로 실패 이유를 미리 가립니다
Claude 데스크톱 앱이나 웹에서 Customize > Connectors를 열고, Connectors 제목 옆의 + 버튼을 눌러 Add custom connector를 고릅니다. Team·Enterprise 플랜은 관리자가 조직 설정에서 먼저 추가해야 목록에 보입니다.
화면에서 확인할 것Comfy 공식 문서(docs.comfy.org, GPL-3.0)의 로그인 화면입니다. 문서는 Claude 데스크톱과 Codex 설정에 같은 화면을 싣고 있어, 창 제목에 Codex가 보입니다. Comfy Cloud MCP 로그인 · Comfy 공식 문서 화면
연결한 뒤에는 생성하지 말고 구독 등급과 잔액, 쓸 수 있는 템플릿부터 확인합니다. 검색은 구독 없이 됩니다.
Comfy Cloud 연결 상태를 확인해 주세요. 이미지나 영상은 생성하지 마세요. 현재 구독 등급과 크레딧 잔액을 알려 주고, 제품 사진의 배경을 지우는 템플릿을 세 개만 찾아 이름과 넣어야 하는 입력값을 표로 보여 주세요.
확인구독 등급과 크레딧 잔액, 템플릿 세 개의 표가 나오고 생성 작업은 시작되지 않습니다.
Claude Code에서 쓸 사람은 Comfy 공식 플러그인을 설치합니다. 설치 뒤 /mcp에서 comfy-cloud를 골라 Authenticate를 누르면 같은 로그인 창이 열립니다.
명령어로 직접 하기
Claude Code 채팅창에 한 줄씩 입력합니다. 설치가 끝나면 /comfy-cloud:help로 쓸 수 있는 명령 목록을 확인합니다.
확인플러그인 설치가 끝나고, 로그인한 뒤에는 /comfy-cloud:로 시작하는 명령을 쓸 수 있습니다.
연습
Comfy Cloud를 연결한 뒤 생성 없이 템플릿 하나를 골라, 그 템플릿에 넣을 입력값과 결과를 저장할 폴더를 적어 보세요.
Claude의 Connectors 목록에 Comfy Cloud가 연결돼 있고, 생성 없이 받은 구독 등급·잔액·템플릿 표를 확인했습니다.
알아두면 좋습니다
크레딧만 충전해서는 생성이 실행되지 않고 활성 구독이 있어야 합니다. 요금제 금액과 크레딧 양은 바뀔 수 있으므로 구독 전에 comfy.org/cloud/pricing에서 확인합니다. Comfy Cloud는 결과 파일을 내 컴퓨터에 직접 쓰지 않고 잠깐만 유효한 다운로드 명령을 돌려주는데, 이 주소를 고치면 받을 수 없으므로 그대로 실행합니다. Claude 데스크톱에서 명령이 실행되지 않으면 명령을 복사해 터미널에서 직접 실행하거나 Claude Code로 연결합니다. Comfy MCP는 2026-09-24 기준 공개 베타라 도구 이름과 동작이 바뀔 수 있습니다.
예시 화면 Comfy 공식 문서(docs.comfy.org, GPL-3.0)에 실린 Claude 데스크톱 설정 화면입니다. 이름과 주소를 적고 Add를 누릅니다.
08실습비용유료 실행 전에 확인하기크레딧이나 요금이 나가는 실행을 걸기 전에 무엇을 몇 건 만들고 얼마가 나갈지 여섯 줄로 적어 확인받을 수 있습니다내용 열기내용 접기
텍스트 대화: 몇 번을 주고받아도 요금제 안에서 끝남
이미지·영상: 실행 한 번이 그대로 크레딧으로 빠져나감
여섯 줄로 적습니다
적는 시점: 실행 직전
줄
적을 것
예
도구
무엇으로 만드는지
힉스필드
건수
무엇을 몇 개
마감 컷 6구간 × 2번씩
단가
한 건당
8크레딧
합계
이번 실행
약 96크레딧
누적
오늘 지금까지
160크레딧
잔액
남은 것
약 929크레딧
여섯 줄을 다 채우지 못해도 됩니다
모르는 줄은 모른다고 적으면 그 자체가 확인할 지점이 됩니다
적어 두는 것은 승인이 아닙니다
브리프를 적고 바로 실행하면 승인을 받은 것이 아닙니다
적은 다음 진행할지 묻고, 답을 듣고 실행합니다
한 장을 요청받고 세 장을 뽑아 고르라고 하면, 두 장은 묻지 않고 쓴 돈입니다
같은 요청으로 여러 장을 만드는 것도 따로 묻습니다
실행 뒤에 실제 값을 적습니다
끝나면 같은 기록에 실제로 나간 값을 적습니다
예상과 다르면 다음번 단가를 고칩니다
몇 번 반복하면 브리프의 숫자가 실제와 가까워져, 적는 데 몇 초밖에 안 걸립니다
자동 실행은 상한을 같이 정합니다
사람이 보지 않는 상태로 반복 실행되는 설정은 잘못된 조건에서도 계속 돌아갑니다
이런 설정을 만들 때는 실행 횟수나 하루 상한을 함께 정합니다
실행하기 전에 여섯 줄을 적습니다. 도구 이름, 무엇을 몇 건 만드는지, 한 건당 비용, 이번 실행 합계, 지금까지 누적, 남은 잔액입니다.
적은 여섯 줄을 사람에게 보여 주고 진행 여부를 확인받습니다. 적어 둔 것만으로는 승인이 아닙니다.
승인받은 건수만큼만 실행합니다. 같은 요청으로 두 장 이상 뽑는 것도 따로 묻습니다.
실행이 끝나면 같은 기록에 실제로 나간 비용을 적습니다. 예상과 다르면 다음 브리프의 한 건당 비용을 고칩니다.
연습
다음에 이미지 한 장을 만들 때, 누르기 전에 여섯 줄을 먼저 적어 보세요. 적고 나서 정말 그 건수가 필요한지 다시 보면 대개 줄어듭니다.
마지막으로 유료 실행을 하기 전에 몇 건에 얼마가 나갈지 미리 알고 있었는지 답할 수 있으면 통과입니다.
알아두면 좋습니다
예상 비용을 적어 두는 것과 승인을 받는 것은 다른 일입니다. 적어만 두고 진행하면 승인 없이 쓴 것입니다. 수정 요청도 크레딧이 다시 차감되므로 한 번 더 묻습니다. 자동으로 반복 실행되는 설정은 한 번 걸어 두면 지켜보지 않는 사이에도 계속 차감되므로, 실행 횟수 상한을 함께 정합니다.
runbook 초안이 나오면, 다음 세션에 실제로 그 순서로 시작할 수 있는지 훑어보세요.
runbook을 보고 다음 세션을 시작할 수 있고, 한 가지 개선점을 회고에 적었으면 통과입니다.
알아두면 좋습니다
회고 없이 절차만 쌓이면 runbook이 실제 작업 방식과 어긋난 채로 낡습니다. 이때는 세션을 마칠 때마다 어디서 막혔는지 한 줄을 남기고, 그 기록으로 정기적으로 갱신합니다. runbook이 한 페이지를 넘어가면 끝까지 읽히지 않아 지켜지지 않으니, 분량이 늘면 자주 쓰는 절차만 남기고 나머지는 정리합니다.
10실습Headless창 없이 한 번에 실행하기대화창을 열지 않고 요청 하나를 실행해 결과를 파일로 받을 수 있습니다내용 열기내용 접기
대화 세션이 맞는 일: 사람이 중간에 판단해야 할 때
요청이 매번 같고 결과 형태가 정해져 있으면, 세션 열기부터 답 복사·붙여넣기까지가 전부 반복 비용입니다
claude -p: 대화창을 열지 않고 요청 하나를 실행합니다
답은 터미널 출력으로 나오고, 실행이 끝나면 세션이 닫힙니다
결과를 파일로 넘기거나 다른 프로그램에 이어 붙일 수 있습니다
쓰는 곳: 정해진 검사를 저장소에 올릴 때마다 자동으로 돌리는 CI
데스크탑 앱에는 같은 기능이 없어, 이 코스에서 명령어를 피하기 어려운 몇 안 되는 지점입니다
필요한 세 조각: 요청 문장, 미리 승인할 도구, 결과를 보낼 곳
미리 승인하는 도구는 좁게 잡습니다
-p 실행에는 확인 창이 없어, 승인이 필요한 지점에 닿으면 거기서 멈춥니다
--allowedTools로 미리 승인하면 멈추지 않고 끝까지 진행합니다
넓게 잡을수록 확인 없이 실행되는 범위가 넓어집니다
읽어서 정리하는 일: Read
파일을 고쳐야 할 때: Edit 추가
Bash: 명령을 직접 실행하는 도구라 초보 단계의 자동 실행에는 넣지 않습니다
내가 만들지 않은 폴더에서는 —bare를 붙입니다
-p 세션에는 폴더 신뢰 확인 창이 뜨지 않습니다
옵션 없이 실행하면 .claude/settings.json의 Hook이 그대로 실행되고, .mcp.json의 서버에도 연결됩니다
문제가 되는 곳: 내려받은 저장소, 남에게 받은 폴더
--bare: Hook·스킬·플러그인·MCP 서버·CLAUDE.md를 모두 읽지 않고 실행합니다
어느 컴퓨터에서 돌려도 같은 결과가 나와, 저장소를 처음 열어 볼 때와 CI 검사에 씁니다
성공 여부는 종료 코드로 확인합니다
화면에 답이 나왔다고 성공한 것은 아닙니다
실행이 실패하면 0이 아닌 종료 코드를 남깁니다
인증이 빠진 경우처럼 실행 도중 생긴 실패는 결과에 그대로 출력됩니다
명령을 이어 붙이거나 자동으로 돌릴 때는 종료 코드로 다음 동작을 정합니다
순서 아래 명령을 그대로 붙여넣어 결과 파일이 실제로 만들어지는지 확인해 보세요
한 번에 끝낼 요청 하나를 문장으로 정합니다. 결과가 화면 출력이나 파일로 남는 일만 고르고, 중간에 사람에게 되물어야 하는 일은 대화 세션에 남겨 둡니다.
작업할 폴더로 이동한 뒤 요청을 붙여 실행합니다. 답이 대화창 대신 터미널에 바로 출력됩니다.
명령어로 직접 하기
일반 터미널에서 실행합니다. Claude Code 세션 안이 아닙니다. -p는 --print의 짧은 형태이고, 실행이 끝나면 세션이 그대로 닫힙니다.
claude -p "이 폴더의 README를 읽고 핵심을 다섯 줄로 요약해 줘"
쓸 도구를 미리 지정합니다. 지정하지 않으면 실행 도중 승인 창이 필요한 지점에서 멈춥니다.
명령어로 직접 하기
미리 승인한 도구는 실행 중 확인 없이 쓰입니다. 읽기만 필요하면 Read만 넣고, 파일을 고치거나 명령을 실행하는 도구는 필요한 것만 하나씩 추가합니다.
claude -p "이 폴더의 문서 목록을 표로 정리해 줘" --allowedTools "Read"
결과를 파일로 받습니다. 화면에 흘려보내지 않고 남겨야 다음 작업에서 쓸 수 있습니다.
명령어로 직접 하기
> 뒤에 적은 이름으로 파일이 새로 만들어집니다. 같은 이름이 이미 있으면 덮어쓰므로 새 이름을 씁니다.
claude -p "이 폴더의 README를 읽고 핵심을 다섯 줄로 요약해 줘" --allowedTools "Read" > summary.md
내가 만들지 않은 폴더에서 실행할 때는 그 폴더의 설정을 읽지 않게 합니다.
명령어로 직접 하기
--bare는 그 폴더의 Hook·스킬·플러그인·MCP 서버·CLAUDE.md를 읽지 않고 실행합니다. 붙이지 않으면 신뢰 확인 창 없이 그것들이 그대로 실행됩니다.
claude -p "이 폴더가 무슨 프로젝트인지 설명해 줘" --bare --allowedTools "Read"
명령이 끝난 뒤 종료 코드를 확인합니다. 0이면 성공이고, 0이 아니면 실행이 실패한 것입니다.
명령어로 직접 하기
직전 명령의 종료 코드를 출력합니다. Windows PowerShell에서는 $LASTEXITCODE를 씁니다.
echo $?
연습
지금 작업 중인 폴더에서 읽기만 하는 요청 하나를 골라 claude -p로 실행하고, 결과를 파일로 저장해 열어 보세요.
대화창을 열지 않고 결과 파일이 만들어졌고, 종료 코드가 0이면 됩니다. 화면에 답이 나왔더라도 파일이 비어 있으면 통과로 세지 않습니다.
알아두면 좋습니다
--bare 없이 실행하면 그 폴더의 .claude/settings.json에 있는 Hook과 .mcp.json에 적힌 서버가 신뢰 확인 창 없이 실행되고 연결됩니다. 내려받은 폴더나 남이 준 폴더에서는 --bare를 붙이거나 설정 파일을 먼저 열어 봅니다. --allowedTools에 Bash를 통째로 넣으면 확인 없이 명령이 실행되므로, 삭제·배포·발송이 섞일 수 있는 요청에는 쓰지 않습니다. 결과를 > 로 내보낼 때 기존 파일 이름을 쓰면 내용이 덮어써집니다.
11실습Routines정해진 시각에 혼자 돌리기반복 작업 하나를 Routine으로 저장해 정해진 시각에 클라우드에서 실행할 수 있습니다내용 열기내용 접기
Routine: 맡길 일을 한 번 저장하면 정해진 시각이나 조건에서 Claude가 혼자 실행하는 기능
예: “매주 월요일 9시에 지난주 자료를 정리해 보고서 파일로 남겨 줘”
실행 위치: 앤트로픽의 서버. 내 노트북이 꺼져 있어도 결과가 쌓입니다
앞 단계까지는 실행 버튼을 누르는 사람이 있었지만, Routine에는 실행 중에 확인해 줄 사람이 없습니다
Routine의 세 조각: 실행할 프롬프트, 작업할 GitHub 저장소(파일을 올려 두고 바뀐 이력을 남기는 온라인 폴더), 실행을 시작시키는 트리거
트리거 종류: 정해진 주기로 도는 일정, 다른 프로그램이 정해진 주소로 실행을 요청하는 API, 저장소에 파일이 올라오는 것 같은 변화에 반응하는 GitHub 이벤트
하나의 Routine에 트리거 여러 개를 함께 걸 수 있습니다
강조 상자부터는 확인해 줄 사람이 없으므로, 되돌리기 어려운 동작은 마지막 상자의 사람에게 남깁니다.
프롬프트는 되묻지 않아도 끝까지 가야 합니다
대화 세션에서는 애매한 지점에서 Claude가 되묻고 사람이 답하지만, Routine 실행에는 그 사람이 없습니다
프롬프트에 적을 것: 무엇을 할지, 무엇을 성공으로 볼지, 조건이 안 맞으면 어떻게 할지
이 셋이 없으면 실행이 중간에 멈추거나 엉뚱한 방향으로 갑니다
되돌리기 어려운 동작은 넣지 않습니다: 파일 삭제, 배포, 메시지 발송, 결제
Routine에는 확인하고 정리해서 보고하는 데까지만 시키고, 실행 여부는 보고를 읽고 사람이 정합니다
조건을 먼저 확인합니다
이용 조건: Pro·Max·Team·Enterprise 플랜, 웹 Claude Code 켜짐
회사 계정이라면 관리자가 조직 전체에서 꺼 두었을 수 있습니다
GitHub 저장소가 필요합니다
저장소는 실행마다 기본 브랜치(저장소의 기준이 되는 버전)에서 새로 내려받고, 변경 사항은 claude/로 시작하는 새 브랜치에 쌓여 기존 작업을 직접 덮어쓰지 않습니다
기본 환경은 패키지 저장소나 일반적인 개발용 주소처럼 미리 정해진 목록에만 연결됩니다
사내 서비스나 목록 밖 주소에 닿아야 하면 환경의 네트워크 설정을 먼저 손봅니다
환경 변수(실행할 때 넘겨주는 설정값)는 그 환경을 쓰는 사람 모두에게 보이므로, 자격증명을 넣어도 되는 곳인지 판단한 뒤 넣습니다
상태: 리서치 프리뷰(정식 출시 전 시험 공개)
동작과 제한, 외부 호출 방식이 예고 없이 바뀔 수 있어 지금 확인한 화면과 다음 달 화면이 다를 수 있습니다
저장한 뒤 바로 한 번 돌려 봅니다
저장 화면만 보고 예정 시각을 기다리면 프롬프트가 잘못돼 있어도 다음 실행까지 알 수 없습니다
저장 직후 직접 한 번 실행해 결과 세션을 열고, 요청한 산출물이 나왔는지와 어디서 막혔는지 확인합니다
여기서 고친 프롬프트가 이후 모든 실행에 그대로 적용됩니다
실습: 순서를 따라 Routine 하나를 저장하고, 예정 시각을 기다리지 말고 그 자리에서 직접 실행해 결과를 확인합니다
조건부터 확인합니다. Routines는 Pro·Max·Team·Enterprise 플랜에서 웹 Claude Code가 켜져 있어야 쓸 수 있고, 회사 계정이면 관리자가 꺼 두었을 수 있습니다. 데스크톱 앱에서는 Code 탭 사이드바의 Routines에서 New routine을 누르고 Cloud를 고릅니다. Local을 고르면 클라우드가 아니라 내 컴퓨터에서 도는 예약 작업이 됩니다.
확인Routine 목록 화면이 열립니다. 정책으로 꺼져 있으면 사용할 수 없다는 안내가 대신 나옵니다.
새 Routine을 만들고 이름과 프롬프트를 적습니다. 실행 중에 되물을 사람이 없으므로, 무엇을 하고 무엇이 성공인지까지 프롬프트 안에 다 적습니다.
확인이름·프롬프트·모델을 고르는 입력 화면이 나옵니다.
실행할 GitHub 저장소를 지정합니다. 저장소는 실행이 시작될 때마다 기본 브랜치에서 새로 내려받고, 변경 사항은 claude/로 시작하는 새 브랜치에 쌓입니다.
확인지정한 저장소가 목록에 붙고, 기존 브랜치를 직접 덮어쓰지 않는다는 것을 확인할 수 있습니다.
실행 환경을 고릅니다. 기본 환경은 정해진 목록의 주소에만 연결되므로, 사내 서비스처럼 목록 밖 주소가 필요하면 환경을 먼저 손봅니다.
확인네트워크 범위·환경 변수·준비 스크립트를 정하는 항목이 보입니다.
트리거를 고릅니다. 정해진 주기로 도는 일정, 외부에서 호출하는 API, 저장소 이벤트 세 가지가 있고 함께 걸 수도 있습니다. 처음에는 주 1회 일정 하나로 시작합니다.
확인선택한 트리거가 Routine에 붙고, 다음 실행 예정 시각이 표시됩니다.
맨 아래 Connectors 목록을 확인합니다. 연결해 둔 커넥터가 모두 기본으로 들어가고, 실행 중에는 쓰기 작업도 묻지 않고 하므로 이 Routine에 필요 없는 커넥터는 뺍니다.
확인Routine에 필요한 커넥터만 목록에 남습니다.
저장한 뒤 한 번 직접 실행해 결과를 확인합니다. 예정된 시각까지 기다렸다가 처음 결과를 보면, 잘못된 프롬프트가 그대로 반복됩니다.
확인실행 기록에 세션 하나가 남고, 그 안에서 요청한 산출물과 실패 지점을 볼 수 있습니다.
연습
매주 반복하는 점검 하나를 골라 Routine으로 저장하고, 예정 시각을 기다리지 말고 그 자리에서 한 번 직접 실행해 결과를 확인해 보세요.
직접 실행한 기록에 세션이 남고, 요청한 산출물이 그 안에 있으면 됩니다. Routine이 저장됐다는 화면만 보고 통과로 세지 않습니다.
알아두면 좋습니다
Routines는 리서치 프리뷰라 동작과 제한이 예고 없이 바뀔 수 있습니다. 실행 중에는 확인을 받을 사람이 없으므로, 삭제·배포·메시지 발송·결제처럼 되돌리기 어려운 동작은 프롬프트에 넣지 말고 보고까지만 시킵니다. 환경 변수는 그 환경을 쓰는 사람 모두에게 보이므로 자격증명을 넣을 때 이 점을 감안합니다. API 트리거 토큰은 생성 직후 한 번만 보이고 나중에 다시 볼 수 없습니다. 실행에 GitHub 저장소가 필요하므로, 저장소 없이 문서만 다루는 업무에는 맞지 않습니다.
12개념게시승인한 게시물만 예약 목록에 올리기게시물마다 승인·사실 확인·권리 확인 칸을 둔 대기열 파일을 만들고, 세 칸이 모두 확인된 항목만 예약 목록으로 뽑을 수 있습니다내용 열기내용 접기
studio.soluta 인스타그램 대기열 30건에 점검을 돌린 실제 결과입니다. 내 승인 칸을 채운 항목이 없어서 예약 목록이 비어 있습니다.
예약 발행 대기열: 게시할 항목과 예약 시각을 파일 하나에 적고, 조건을 채운 항목만 예약 목록으로 넘기는 방식
조건에 사람이 직접 채우는 확인 칸을 넣으면 확인을 마치지 않은 게시물은 예약 목록에 오르지 않습니다
확인 칸 기준: 게시한 뒤에 고치기 어려운 문제
studio.soluta 인스타그램 대기열의 세 칸:
칸
확인하는 것
ownerApproved
내가 게시물을 보고 내보내도 된다고 정했는지
factsChecked
날짜·수치·이름 같은 사실을 원문과 대조했는지
rightsCleared
이미지·음악·인용을 쓸 권리를 확인했는지
점검은 파일에 적힌 값만 읽고 파일을 고치지 않습니다
예약 목록에 오르는 조건: 세 칸 모두 true, 예약 시각 기재, 캡션과 이미지 파일 실재
조건을 못 채운 항목은 예약 목록에 오르지 않고, 빠진 확인이 표에 남습니다
예시 그림: studio.soluta 대기열 30건에 이 점검을 돌린 실제 결과
30건 모두 내 승인 칸이 비어 있어 예약 목록은 0건입니다
연습
다음 주에 올릴 게시물 하나를 대기열에 넣고 세 칸을 직접 확인해 true로 바꾼 뒤, 점검 결과에 그 항목만 올라오는지 확인해 보세요.
대기열 파일의 모든 항목에 확인 칸 세 개가 있고, 점검 결과 표에는 내가 직접 true로 바꾼 항목만 예약 목록에 올라와 있습니다.
알아두면 좋습니다
AI에게 확인 칸까지 채우게 하면 칸이 있어도 아무것도 막지 않습니다. 세 값은 사람이 직접 바꾸고, 요청에 「true로 바꾸지 마」를 적어 둡니다. 점검을 루틴으로 돌릴 때는 게시하지 말고 보고까지만 하도록 요청에 적습니다. 루틴은 실행 중에 승인을 묻지 않고, 연결한 도구로 쓰기 작업까지 할 수 있습니다.
13실습전달고객 전달본 한 장으로 정리하기확정한 결과물의 규격, 들어간 음원·사진·글꼴·생성 컷의 출처와 라이선스, 검사 기록, 고객이 확인할 항목을 한 장의 HTML 전달 페이지로 모을 수 있습니다.내용 열기내용 접기
고객 전달본: 결과물 파일과 함께 보내는 한 장짜리 페이지
받는 사람이 알 수 있는 것: 파일을 어디에 어떻게 써도 되는지, 무엇을 확인해 줘야 하는지
칸
적는 것
확정본
최종 결과물과 확정한 날짜, 비교했던 시안은 아래에
규격
해상도, 길이, 초당 프레임 수, 코덱, 용량
출처·라이선스
음원·사진·글꼴·생성 컷마다 출처, 라이선스, 상업 사용, 표시 의무
검사 기록
실제로 돌린 검사 명령과 결과
확인할 것
고객이 정해 줘야 하는 날짜, 로고 원본, AI 생성 표시 방법
Claude Code: 결과물 파일과 작업 기록에서 값을 뽑습니다
사람: 확인하지 못한 줄을 판단하고, 페이지를 읽은 뒤 보냅니다
확정한 결과물만 골라 규격을 숫자로 잽니다.
[프로젝트 폴더]에서 최종 결과물 파일을 찾아 줘. 파일마다 해상도, 길이, 초당 프레임 수, 코덱, 용량을 ffprobe로 재서 표로 만들고, 시안이나 중간본은 표에서 빼고 따로 목록으로 알려 줘.
확인최종 결과물만 들어간 규격 표와, 빠진 시안 목록이 나뉘어 나옵니다.
결과물에 들어간 소스를 하나씩 찾아 출처와 라이선스를 적게 합니다.
결과물에 들어간 음원, 사진, 글꼴, 생성형 AI로 만든 이미지와 영상을 하나씩 찾아 출처 주소, 라이선스 이름, 상업적 사용 가능 여부, 출처 표시 의무를 표로 적어 줘. 라이선스 원문을 직접 확인하지 못한 항목은 「확인 필요」로 남기고, 생성형 AI로 만든 컷은 만든 도구 이름을 따로 적어 줘.
확인소스마다 출처·라이선스·상업 사용·표시 의무가 적힌 표가 나오고, 확인하지 못한 줄에는 「확인 필요」가 붙어 있습니다.
결과물을 검사한 기록을 모읍니다.
이 결과물을 만들면서 돌린 검사 명령과 결과(렌더 검사, 음원 길이 대조, 글자 잘림 확인 등)를 모아 한 표로 정리해 줘. 돌리지 않은 검사는 표에 넣지 마.
확인실제로 실행한 검사 명령과 결과만 들어간 표가 나옵니다.
세 표와 고객이 확인할 것을 한 장으로 묶고, 보내기 전에 직접 봅니다.
위 세 표와, 고객이 확인해 줘야 할 항목(날짜·로고 원본·AI 생성 표시 방법처럼 아직 정하지 않은 것)을 한 장의 HTML 전달 페이지로 만들어 줘. 확정본을 맨 위에, 비교했던 시안은 그 아래에 두고, 고객에게 보내기 전에 나에게 먼저 보여 줘.
확인확정본·규격·출처·검사·확인할 것 순서의 전달 페이지가 생기고, 열어 볼 수 있는 경로가 나옵니다.
연습
최근에 만든 결과물 하나로 출처·라이선스 표만 먼저 만들어 보고, 「확인 필요」로 남은 줄이 몇 개인지 세어 보세요.
전달 페이지에 규격 표, 출처·라이선스 표, 검사 기록 표, 고객이 확인할 것 목록이 모두 있고, 출처 표의 모든 줄에 라이선스 이름이나 「확인 필요」가 적혀 있습니다.
알아두면 좋습니다
「무료」로 내려받은 음원과 사진도 라이선스마다 상업적 사용과 출처 표시 조건이 다르므로 원문을 확인합니다. Creative Commons 라이선스는 종류에 따라 상업적 이용 금지(NC)나 변경 금지(ND) 조건이 붙습니다. 생성형 AI 컷을 어떻게 표시할지는 고객과 정해 확인할 것에 적습니다. 전달 페이지는 고객에게 보내는 외부 공유이므로 보내기 전에 사람이 한 번 읽습니다.
예시 화면 2026-09-30 리브위드에 보낸 모닝레이브 티저 전달 페이지의 머리 부분과 확정본 표입니다. 가운데 영상 칸은 잘라 냈습니다.
