실제로 쓰기

요청·구조·연결·규칙을 손에 익혀 실제 일에 씁니다.

요청

좋은 요청

같은 요청인데도 결과가 매번 다르게 나온 적 있지 않나요? 무엇을 원하는지만 말하면 나머지는 Claude가 짐작해서 채웁니다.

화살표가 그려진 쪽지를 받으면 헤매지 않고 곧장 갑니다
  1. 원하는 결과물을 한 문장으로 정리합니다.
  2. 그 결과물을 어디에 쓸지, 왜 필요한지 덧붙입니다.
  3. 형식·톤·분량 같은 제약을 나열합니다.
  4. 참고할 예시가 있으면 함께 첨부합니다.
  5. 반복되는 제약은 요청 대신 CLAUDE.md에 옮겨 적습니다.

구조

프로젝트 구조

작업을 맡겼더니 결과물이 엉뚱한 폴더에 들어가 있던 적 있지 않나요? 파일이 어디에 있는지 정해 두지 않으면 결과물도 아무 데나 놓입니다.

더미를 만지기 전에 구조부터 세웁니다
  1. 현재 폴더 구조를 훑어 확인합니다.
  2. 산출물·원본·임시 파일이 들어갈 위치를 각각 정합니다.
  3. 정본(SSoT, Single Source of Truth) 파일을 하나 지정합니다.
  4. 정한 구조 규칙을 CLAUDE.md에 기록합니다.

Git

Git 기본

Claude가 파일을 고친 뒤 정확히 뭐가 바뀌었는지 몰라 당황한 적 있지 않나요? Git(버전 관리 도구)이 있으면 그 변화를 기록하고 언제든 되돌릴 수 있습니다.

갈림길에 체크포인트를 남기고 시도합니다
  1. git status로 현재 상태를 확인합니다.
  2. 작업용 branch를 새로 만듭니다.
  3. Claude에게 원하는 변경을 요청합니다.
  4. 변경된 내용을 diff로 확인합니다.
  5. 확인이 끝난 상태를 commit으로 기록합니다.

MCP

Notion 연결 — MCP

Notion에 있는 자료를 Claude에게 보여주려고 매번 복사해서 붙여넣은 적 있지 않나요? MCP(Model Context Protocol, 모델 컨텍스트 프로토콜)가 있으면 Claude Code가 Notion 같은 외부 서비스에 직접 접근합니다.

외부 도구를 케이블 하나로 연결합니다
  1. 연결할 외부 도구를 정합니다(예: Notion).
  2. claude mcp add --transport http notion https://mcp.notion.com/mcp 같은 명령으로 연결을 요청하거나, Claude에게 문장으로 맡깁니다.
  3. 서버가 인증을 요구하면 /mcp를 실행해 브라우저에서 로그인합니다.
  4. claude mcp list로 연결 상태를 확인하고, 페이지 하나를 조회해 테스트합니다.

서브에이전트

서브에이전트 위임

긴 조사를 시켰더니 대화가 점점 늘어지고 처음 정한 규칙까지 흐려진 적 있지 않나요? 서브에이전트(전용 워커)에게 넘기면 본 대화에는 결과만 돌아옵니다.

작은 워커에게 일을 넘깁니다
  1. 위임할 조사나 반복 작업을 정의합니다.
  2. "서브에이전트로 조사해 줘"처럼 자연어로 위임을 요청합니다.
  3. 작업이 끝나면 결과 요약을 받습니다.
  4. 받은 결과가 기준에 맞는지 검수합니다.

CLAUDE.md

규칙 파일 — CLAUDE.md

같은 규칙을 매 요청마다 반복해서 적고 있지 않나요? 그렇다면 그 규칙은 파일로 옮길 때가 된 것입니다.

반복하던 규칙을 압정으로 한 번에 고정합니다
  1. /init을 실행해 CLAUDE.md 초안을 받거나, 직접 파일을 만듭니다.
  2. 반복해서 말해 온 규칙을 옮겨 적습니다.
  3. 세션 중 새로 정한 규칙을 CLAUDE.md에 직접 추가합니다.
  4. /memory로 지금 로드된 파일을 확인하고, 안 쓰는 규칙은 주기적으로 지웁니다.

Context

Context 관리

긴 작업 도중 Claude가 아까 분명히 정한 규칙을 갑자기 잊은 것처럼 굴 때 있지 않나요? 대화가 길어지면 Claude는 앞에서 정한 내용을 잊기 시작합니다.

길어진 작업을 묶어 이어 갑니다
  1. 응답이 늘어지거나 앞서 정한 규칙을 놓치는 신호를 확인합니다.
  2. 지금까지의 결정과 남은 일을 파일로 요약합니다.
  3. /compact로 대화를 정리하거나 /clear로 새로 시작합니다.
  4. 새 세션에서 요약 파일을 읽혀 이어갑니다.

Skills

Skills · Plugin

같은 순서로 하는 작업을 매번 처음부터 다시 설명하고 있지 않나요? 그 순서를 패키지로 묶어 두면 다음부터는 불러 쓰기만 하면 됩니다.

반복 작업을 블록으로 끼워 둡니다
  1. 반복하는 절차 하나를 글로 정리합니다.
  2. .claude/skills/<이름>/SKILL.md 파일을 만들어 절차를 적습니다.
  3. /스킬이름으로 불러 실행합니다.
  4. 쓰면서 빠진 단계나 잘못된 가정을 다듬습니다.

이유를 넣은 요청부터 프로젝트 구조·Git·MCP·서브에이전트·규칙 파일·Context·Skills까지.