[Claude] 워크플로우 기초부터 실전까지(1)

JAMEe_·2026년 3월 13일

AI툴

목록 보기
1/2

Model Alias

클로드 코드에서 모델은 아래와 같이 구성되어있다.
Opus: 상급
Sonnet: 중급
Haiku: 초급
만약 기획을 Opus 로 짜고, 코드는 Sonnet 으로 작성하고 싶다면
매번 모델을 변경하면서 번거롭게 해야할까?

/model opusplan

/model 에서는 앞선 3개의 종류만 명시되어있는데,
공식문서를 읽다보니 발견된 opusplan!
설계나 기획은 opus 를 사용하고, 실제 코드 작성할때는 내부적으로 Sonnet 으로 전환됨
유용하게 사용할 수 있을 것 같다

Context window

현재까지의 대화를 담은 통
보통 200K tokens (책 한권 분량)
차면 찰수록 AI 가 바보가 될 확률이 올라감
input(입력) 과 output(응답) 모두 컨텍스트에 담김
서브 에이전트, MCP 등 확장 기능도 Context window 차지

  1. 새로운 기능 구현할 때 clear 명령
  2. 구현하면서 /context 로 현재 컨텍스트 사용량 체크
  3. 컨텍스트 사용량이 70%를 넘어가면 clear, 계속 대화를 이어가고 싶다면 compact
/model sonnet[1m]

위와 같이 입력하면 100만 토큰(Beta) 지정

최대 사용량 비교

플랜별로 어떤 모델을 사용하면 좋을지 정리

사용량 확인

/usage

Current session: 5시간 단위로 리셋
Current week(all models): 일주일 단위로 리셋 opus, sonnet, haiku
Current week(sonnet only): 일주일 단위로 리셋 sonnet

/statusline

토큰 효율적으로 사용 방법

명확하게 범위를 제한해서 요청하기
ex)) 간단한, 단일 파일로, ~줄 이하, 배포/테스트/빌드 제외

응답 출력 스타일 변경

(구)
/output-style
(현)
/config 안에 들어있음
  1. Default: 기본값
  2. Explanatory: 코드 작성하면서 중간중간 교육적 인사이트 제공. 왜 이렇게 구현했으며 패턴은 무엇인지
  3. Learning: 통찰력 공유 및 TODO 마커를 남겨서 사용자가 직접 구현하도록 유도

settings.json 파일내에 outputStyle 지정 시 매번 해당 스타일로 응답

나만의 커스텀 출력 만들기

아래와 같이 형식이 나뉘어져 있음

  1. 출력 스타일의 메타정보를 갖고 있는 프론트 메터 부분
    name, description 외에 keep-coding-instructions: true 가 선언되어있어야 코드 작성됨
  2. 실제 어떻게 응답하라는 지침

이렇게 설정하면 /output-style 에서 해당 커스텀 스타일을 선택할 수 있음

메모리 파일

세션을 종료(/exit) 하면 백지 상태가 됨
이 프로젝트에서 매번 지켜야할 규칙 정리 (CLAUDE.md)
매번 세션 시작할때 Claude 가 자동으로 읽음

이미 프로젝트가 진행되어있는 경우
아래 명령어를 통해 초기 CLAUDE.md 파일 생성
현재 프로젝트 구조 분석해서 규칙 정리
/init

현재 작성된 사용자, 프로젝트, 로컬 등 메모리 편집하고 싶다면
/memory

CLAUDE.md 파일은 500줄 이하로 유지 권장
그러므로 파일 참조 import 구문을 적극 활용하여 작성하기

모듈형 규칙

CLAUDE.md 파일에 import 구문으로 작성하면 정리가 안되고 방대해지는 문제가 있음
모듈형 규칙을 사용하면 디렉토리 구조가 더 깔끔해지고 별도의 import 도 필요없이 매번 세션 시작할때마다 rules 도 함께 읽음

추가로 특정 디렉토리나 파일에만 적용시키고 싶은 경우
path frontmatter 사용
ex)) API 작성 규칙

.claude/rules/ 디렉토리에 md 파일 배치

각 파일은 하나의 주제를 다루어야함
파일명만 봐도 내용을 알 수 있어야함

MCP 활용

Context7: AI 어시스턴트들이 항상 최신 라이브러리 정보를 알 수 있게 도와주는 서비스

클로드코드에서 권장하는 개발 워크플로우

Explore(탐색): 도메인 지식, 관련 파일, 이미지 등 정보 수집
plan(계획): 특정 문제에 접근하는 방법에 대한 계획
code(구현): "~기능 만들어줘" 진행 단계마다 멈춰서 "이 부분은 잘 동작할까?", "빠뜨린 건 없는가?" 검증
commit(커밋)

프롬프트 엔지니어링 기법

  1. CoT (생각의 사슬)
    Chain of Thought.
    단계별로 문제를 해결하면 일반적으로 복잡한 작업에서 오류가 줄어듬

  2. 페르소나
    특정 도메인 지식을 필요로 할 때 역할을 부여하면 성능을 크게 향상시킬 수 있음

커스텀 커맨드 만들기

/.claude/commands 경로에 md 파일로 생성한 파일은
커맨드로 사용할 수 있음
그룹화도 가능

/.claude/commands/git/commit.md 작성된 md 파일을 명령어로 사용

/git:commit

동적 파라미터 커맨드

$ARGUMENTS 또는 $숫자 를 이용해서 커맨드 명령어 뒤에 입력한 내용이 동적으로 들어감

// git/commit.md
---
description: git 커밋 생성
---
커밋 메시지: $ARGUMENTS
/git:commit 로그인 기능 완료

ㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡㅡ

커밋메시지: $1, $2
/git:commit 로그인기능 장바구니기능

추가 (3/17):

skills 로 통합되어 슬래쉬 명령어 할 필요 없이 요청에 맞는 커맨드를 자체적으로 찾아 실행
커스텀 커맨드(레거시) => skills

서브 에이전트

프로젝트를 진행하면 새로운 기능, 코드 리뷰, 보안취약점, 테스트 등과 같이 여러 고려할 사항이 있는데
이걸 하나의 에이전트에서 하면 전문성도 떨어지고, 메인 컨텍스트의 맥락도 어지럽혀짐
그래서 서브 에이전트로 각각 처리하는 방식이 베스트

/agents

추가 (3/17):

Claude Code 에 Skills 라는게 업데이트되면서 서브 에이전트는 Skills 로도 생성이 가능하며
컨텍스트 효율 측면에서도 우위
일회성이 아닌 이상 skills 로 구현하기

호출방법

  1. Claude 가 우리 요청을 분석해서 적절한 서브 에이전트 자동 호출
  2. 프롬프트 요청 시 해당 서브 에이전트 언급해서 요청

주요 이점

유연한 권한: 코드리뷰의 경우 READ 권한만 부여
재사용성: 한번 생성하면 다양한 프로젝트에서 사용하며 일관된 워크플로우 제공
전문 지식: 서브 에이전트만의 페르소나를 입력
컨텍스트 보존: 각 서브 에이전트는 자체 컨텍스트에서 작동하여 결과만 요약하여 메인 컨텍스트에 전달

훅

Claude Code 생명주기 다양한 지점에서 실행되는 명령어
1. Bash 와 같은 명령어가 실행된 이후 작업될 내용
2. 코드 수정 후 포맷팅 작업을 한다던가
3. Claude 에게 특정 작업을 요청 후 슬랙에서 완료했다는 알람을 받는다던가

profile
JAMEe_
안녕하세요
다음 포스트

[Claude] 워크플로우 기초부터 실전까지(2)

0개의 댓글