가이드

완전 초보용 · 어려운 말 없이

기초편 — 이것부터

에이전트·스킬을 쓰기 전에, 클로드를 똑똑하게 만드는 파일 3개와 필수 명령어부터. 이 3개 파일이 “클로드가 나를 기억하고, 내 규칙대로 일하게” 만듭니다.

터미널 여는 법30초 · Windows / Mac

터미널은 글자로 명령하는 창이고, 클로드 코드는 그 안에서 돌아갑니다. 여는 법만 알면 절반은 끝난 겁니다.

Windows

시작 버튼(또는 ⊞ Win 키) 누르고 “터미널” 검색 → 터미널(또는 PowerShell) 클릭. 단축키는 Win+R → wt 입력 → Enter.

Mac

Cmd+Space(스포트라이트) → “터미널”(terminal) 입력 → Enter.

VSCode 쓴다면

Ctrl+`(백틱) 하나로 내장 터미널이 열립니다. 따로 안 열어도 됩니다.

열렸으면

claude 치고 Enter — 클로드 코드가 시작됩니다. “명령을 찾을 수 없다”고 나오면 아래 설치부터.

설치엔 Node.js가 먼저 필요합니다(nodejs.org에서 LTS 설치). 설치 후 터미널을 껐다 다시 열고 claude. 터미널 없이 시작하고 싶다면 프롬프트 라이브러리를 claude.ai에서 먼저 써보세요.

핵심 파일 3종매번 자동 적용

필수 명령어6개만 알면 충분

채팅창에 /를 치면 명령. 이 6개만 알면 대화를 안 끊기게 오래 끌고 갈 수 있습니다.

/context

지금 대화가 얼마나 찼는지 %로 봅니다. 꽉 찰수록 느려지고 비싸집니다 — 80% 넘으면 압축 신호.

/compact

긴 대화를 요약해 압축. 맥락은 유지하며 공간 확보. 작업 하나 끝난 자연스러운 구간에서. “요약하고 PROGRESS.md 갱신 후 이어가”처럼 지시할 수 있습니다.

/clear

대화를 완전히 비우고 새로 시작(압축과 달리 맥락 안 남김). 전혀 다른 작업 시작할 때.

/model

쓸 모델 바꾸기. 어려운 설계·분석 = Opus, 표준 작업 = Sonnet, 단순 잡무 = Haiku.

Esc

실행 중인 걸 즉시 중단. 엉뚱하게 가고 있으면 누르고 다시 지시합니다.

/help

전체 명령 목록 보기. 기억 안 나면 여기서.

처음엔 이 스킬만목적별

카탈로그가 방대하니, 처음엔 목적별로 이것만 기억하세요. (자세한 건 카탈로그에서 검색)

복잡한 일 자동으로

autopilot — 계획·실행·검증까지 알아서. 큰 작업 통째로 맡길 때.

코드 점검

code-reviewer(작성 직후) · security-reviewer(커밋 전 보안). “이 코드 리뷰해줘”로 호출.

리서치·조사

deep-research · insane-search(막힌 사이트도 뚫어 읽음).

토큰 절약

caveman · token-diet — 출력 짧게, 비용 절감.

단순하게 정리

ponytail(과잉설계 제거) · deslop(AI 군더더기 청소).

설치가 됐는지 확인하는 법did it work? · 30초

설치 명령을 실행했는데 된 건지 모르겠다 — 가장 흔한 막힘입니다. 경로별 30초 확인법:

플러그인·마켓 설치

클로드 코드에서 /plugin → Installed 목록에 이름이 있으면 성공.

폴더에 직접 설치

~/.claude/skills에 넣었다면 클로드 코드 재시작 후 /를 쳐서 목록에 뜨는지 확인.

만능 확인 문장

어느 경로든 아래 문장을 붙여넣고 [스킬명]만 바꾸면 됩니다. 스킬을 알아보고 답하면 성공:

“그런 스킬 없는데요”라고 하면 ① 재시작 ② 이름 오타 확인 ③ Q&A의 “스킬을 썼는데 아무 변화가 없어요” 순서로. 터미널 없이 claude.ai에 스킬 파일을 올린 경우도 같은 문장으로 확인합니다.

터미널 없이 스킬 쓰기claude.ai 업로드

터미널이 아직 부담스러우면 건너뛰어도 됩니다 — claude.ai(웹·앱)에 스킬 zip 파일을 올리면 대화에서 바로 쓸 수 있습니다. 3단계:

1. zip 내려받기

필요한 것만 받으세요: first-setup.zip(클로드 코드 첫 설치를 한 단계씩 완주) · ko-writer.zip(번역투 없는 자연스러운 한국어 글쓰기) · excel-helper.zip(엑셀·CSV 정리를 원본 보존 원칙으로) · did-it-work.zip(설치가 됐는지 증거로 판정) · ppt-draft.zip(발표자료 초안을 목차 승인부터 발표 노트까지) · meeting-actions.zip(회의록을 결정·액션아이템 표로, 날조 금지 원칙) · naver-seo-check.zip(네이버 SEO를 3판정 체크리스트로 진단) · youtube-script.zip(유튜브 대본을 훅부터 CTA까지 구조로) · no-git-backup.zip(git 없이 백업 습관, 복원 리허설까지) · resume-coach.zip(이력서·자소서를 지어내지 않고 사실만으로 개선) · image-batch.zip(이미지 수백 장을 원본 보존하며 일괄 변환·압축) · contract-check.zip(계약서를 확인 질문 목록으로, 법률 자문 아님 고지) · budget-log.zip(가계부를 파일 기록·파이썬 검산으로)

2. claude.ai에 올리기

claude.ai 설정 → 기능(Capabilities) → 스킬에서 zip을 업로드합니다. 스킬 업로드는 유료 플랜 기능입니다. (무료 플랜이라면 zip 안의 SKILL.md를 열어 내용을 대화에 붙여넣어도 비슷한 효과를 냅니다)

3. 대화에서 부르기

“first-setup 스킬로 설치 도와줘”처럼 스킬명을 언급하면 그 스킬 방식대로 일합니다. 적용됐는지 애매하면 위의 만능 확인 문장으로 확인하세요.

일관성 있는 보고서방법 + 스킬

“매번 같은 형식”의 핵심은 스킬 하나가 아니라 틀을 규칙으로 박아두는 것입니다.

1. 형식 고정

좋은 보고서를 한 번 만들고 → 그 형식(제목·항목 순서·말투)을 CLAUDE.md에 규칙으로 적거나 나만의 스킬로 만듭니다(skillify / skill-create). 그러면 매번 같은 틀.

2. 문서 생성

document-generate · make-pdf · 오피스 docx · pptx · xlsx — Word/PPT/엑셀/PDF로 바로 뽑기.

3. 정기 보고

standup(일일) · weekly-digests(주간) · retro(회고) — 반복 보고를 같은 틀로.

핵심

상태를 파일에 두면 사람이 바뀌어도 일관됩니다. PROGRESS.md(진행)·logs/날짜.md(회고)처럼 보고서도 틀을 파일에 두는 것이 원리.

자동화 · 확장 · 오케스트레이션

중급편 — 한 단계 위

기초가 익었으면 이제 반복을 자동화하고, 도구를 붙이고, 여러 작업을 동시에 돌리는 단계. 여기부터가 진짜 생산성입니다.

핵심 도구 3가지자동화·확장

워크플로 — 큰 작업 통째로OMC Tier-0

여러 단계를 알아서 계획·실행·검증. 키워드만 쓰면 발동합니다.

autopilot

기능 하나를 계획→구현→리뷰→검증까지 자동. “큰 거 하나 맡기고 싶을 때” 기본값.

ultrawork

(ulw) 멈추지 않고 끝까지 밀어붙이는 고강도 모드. 목표가 명확할 때.

ralph

“바위는 멈추지 않는다” — 완료·검증까지 반복 루프. 지루한 대량 작업에.

team

여러 전문 에이전트를 팀으로 병렬 실행. 큰 프로젝트 분업.

ralplan

계획을 먼저 세우고 루프 실행. 불확실한 작업은 계획부터.

병렬 · 백그라운드 · 플랜속도·품질

독립 작업은 동시에, 오래 걸리는 건 뒤에서, 복잡한 건 계획 먼저.

병렬 위임

서로 무관한 일은 여러 에이전트에 동시에. “보안 리뷰·성능 리뷰·타입체크 동시에 돌려”.

백그라운드

빌드·테스트처럼 오래 걸리는 건 뒤에서 돌리고 다른 일 계속. 끝나면 알림.

플랜 모드

코드 건드리기 전에 계획부터 세우고 승인받기(Shift+Tab로 전환). 큰 변경 전 필수.

ultrathink

“깊게 생각해” 신호 — 어려운 설계·근본원인은 이 키워드로 추론량을 늘립니다.

설정 · 권한 · 모델settings.json

클로드가 얼마나 알아서 하게 할지, 어떤 두뇌를 쓸지 조절합니다.

권한 모드

매번 물어보기 ↔ 자동 수락. 믿을 만한 계획엔 자동 수락, 탐색적일 땐 물어보게. (위험한 --dangerously-skip는 쓰지 말 것)

모델 라우팅

어려운 설계·분석 = Opus/Fable, 표준 = Sonnet, 잡무 = Haiku(싸고 빠름). 잡무까지 Opus면 낭비.

allowedTools

자주 쓰는 안전한 명령은 미리 허용해 물어보는 횟수를 줄입니다(settings.json).

킬 스위치

자동화가 과하면 DISABLE_OMC 등으로 끕니다. 즉시 중단 Esc는 기초편 참고.

커밋 · PR — 깃 작업 시키기/create-pr

코드를 main에 바로 넣지 않고 “이 변경 검토해줘”로 올리는 게 PR(풀 리퀘스트). 커밋·푸시·PR 생성을 클로드에게 통째로 맡길 수 있습니다.

커밋 = 저장점

변경을 의미 단위로 묶어 기록. “커밋해줘” 또는 메시지까지 “feat: 로그인 추가로 커밋해줘”. 되돌리기·리뷰의 기준점이 됩니다.

푸시 = 원격 반영

로컬 커밋을 GitHub에 올리기. 운영 중 repo는 push = 자동 재배포일 수 있으니 확인부터(Q&A 참고).

/create-pr

브랜치 생성 → 커밋 → 푸시 → PR 생성까지 한 번에. 자연어로 “PR 올려줘”도 같은 뜻. (환경 따라 명령 이름이 다르면 그냥 “PR 만들어줘”)

브랜치 먼저

main에선 PR을 못 만듭니다 → 클로드가 피처 브랜치를 먼저 만들어 그 위에 올립니다. 이게 정상.

초안(draft) PR

바로 병합용이 아니라 검토용 초안으로 올리는 게 안전. 본문엔 무엇을·왜·리뷰 포인트를 적게 합니다.

ship

테스트·빌드까지 돌리고 PR을 올리는 배포 워크플로 스킬. “ship”·“배포해줘”로 발동.

전제: gh(GitHub CLI) 로그인 + GitHub 저장소. 기본 브랜치(main)에 직접 푸시하지 말고 PR로 검토받는 습관이 사고를 막습니다.

오케스트레이션 · 자동화 파이프라인

고급편 — 직접 짜고, 무인으로 돌린다

중급까지가 “주어진 걸 잘 쓰기”라면, 고급은 내 워크플로를 직접 설계하고 사람 없이도 돌아가게 만드는 단계. 여기서부터 클로드가 도구가 아니라 시스템이 됩니다.

핵심 역량 3가지설계·무인화

CI · 헤드리스 자동화사람 없이

대화 밖에서 — 스크립트·CI·서버에서 클로드를 프로그램처럼 호출합니다.

헤드리스

claude -p "프롬프트" — 창 없이 한 번 실행하고 결과만. 스크립트·cron에서 호출.

GitHub Actions

PR 열리면 자동 리뷰·수정, 이슈에 답변. 워크플로에 클로드를 한 단계로.

Agent SDK

내 앱·서버 코드에서 클로드 에이전트를 직접 임베드(TS/Python). 제품에 AI 기능 넣을 때.

MCP 서버 배포

내 데이터·도구를 MCP로 공개 → 누구나 claude mcp add로 연결.

컨텍스트 무중단 — 오래 끌기끊기지 않게

긴 프로젝트를 압축·재시작에도 무손실로. “상태는 대화가 아니라 파일에.”

단계로 쪼개기

각 단계 산출물 = 코드 + 갱신된 문서. 단계 사이엔 컨텍스트를 비워도 무손실.

경로만 주기

큰 파일·긴 로그는 통째로 넣지 말고 경로만 → 필요할 때 읽게. 출력도 파일로 빼기.

서브에이전트 위임

독립 하위작업은 에이전트에 맡기고 결과만 받습니다 → 메인 컨텍스트 경량 유지.

압축 타이밍

70~80% 차면 자연스러운 구간에서 /compact. 프롬프트 캐시는 5분 — 이어서 할 거면 텀을 짧게.

토큰 예산 · 라우팅 심화비용·품질 저울

얼마나 깊게 팔지를 돈으로 조절. 깊이와 비용은 저울입니다.

예산 지시

“+500k”처럼 이번 턴 토큰 목표를 주면 워크플로가 그만큼 깊이·병렬을 자동 확장.

모델 티어

잡무는 Haiku(3배 저렴)·표준 Sonnet·최고 난도만 Opus/Fable. 에이전트별로 다르게 지정 가능.

캐시 활용

같은 컨텍스트 재사용은 프롬프트 캐시로 싸집니다. 5분 TTL — 이어서 할 거면 텀을 짧게.

절약 스킬

caveman·token-diet로 출력 자체를 줄이기. 긴 세션에 누적 효과 큼.

에이전트를 여러 대 굴릴 때 — 외부 도구서드파티 · 선택

한 대로 모자라면 여러 대를 나란히 돌리는 전용 프로그램을 씁니다. 이건 스킬이 아니라 앱이라 스킬 카탈로그에는 없습니다 — 설치는 각 저장소에서.

Orca

에이전트 여러 대를 동시에 굴리는 IDE. 작업마다 worktree를 따로 떼어 서로 안 밟게 하고, Claude Code·Codex 같은 코딩 에이전트를 쓰던 구독 그대로 붙여 씁니다. 데스크톱·모바일 둘 다. MIT 오픈소스 · stablyai/orca ↗

문제 → 해결

자주 막히는 것 (Q&A)

처음에 흔히 부딪히는 문제들. 대부분 인코딩 · 맥락 · 재시작 세 가지로 풀립니다.

표시 · 설치 문제4

응답 · 품질 문제4

권한 · 배포 문제2