Claude Code 편의 기능 모음

Jaewoo Kim·2026년 3월 31일
AIAI에이전트claude code코딩에이전트클로드코드

Claude Code 설치가이드 (Windows용)

목록 보기
2/6


Claude Code의 기본 사용법을 익혔다면 이제 한 단계 더 나아갈 차례다.
서브에이전트(Subagents), 병렬 개발, 비용 절약 설정 등 알아두면 확실히 효율이 달라지는 기능들을 정리했다.

자주 쓰는 명령어 목록

Claude Code 안에서 사용 가능한 명령어. 앞에 /를 붙여 입력한다.

컨텍스트 관리 (대화 정리)

명령어설명언제 사용?
/clear대화를 전부 지우고 초기화다른 작업을 시작할 때
/compact대화를 요약해서 압축응답이 느려졌을 때
/context현재 대화량(컨텍스트 사용량) 확인얼마나 쌓였는지 보고 싶을 때

💡 핵심 습관
작업이 바뀔 때마다 /clear를 실행하자. 대화 이력이 누적될수록 Claude의 응답 품질이 떨어지고 비용도 늘어난다.

비용 관리

명령어설명
/cost현재 세션에서 사용한 토큰(≒비용) 확인
/model haiku저렴한 모델로 전환
/model sonnet표준 모델로 전환 (기본값)
/model opus고성능 모델로 전환 (비쌈)

되돌리기

명령어설명
/rewindClaude의 변경 사항을 되돌리기
Esc 키 2번동일 기능 (단축키)

Claude가 엉뚱한 파일을 수정했을 때 즉시 사용하자.

세션 관리

명령어설명
/resume이전에 중단한 대화를 재개
claude -c지난 세션에 이어서 시작 (Claude Code 실행 시 사용)

편리한 키 조작

⚠️ 중요
아래에서 소개하는 키 조작은 Claude Code 안에서의 동작이다.
PowerShell 창에서의 키 조작과 혼동하지 않도록 주의.

서제스트(자동완성 제안) 활용

Claude가 작업을 완료하면 다음에 이어서 할 법한 명령이 회색 글자로 표시된다 (서제스트).

키동작
Tab서제스트를 입력란에 삽입 후 직접 편집 가능
Enter서제스트를 그대로 즉시 실행

예시:

> hello.txt에 「안녕하세요」라고 써줘

（Claude 실행 완료）

> 파일 내용을 확인해줘    ← 회색으로 표시됨（서제스트）

Tab을 누르면 서제스트가 입력란에 들어와 내용을 수정할 수 있고, Enter를 누르면 그대로 바로 실행된다.

기타 키 조작 (Claude Code 안)

키동작
Ctrl + CClaude Code 종료
Ctrl + R과거 입력 기록 검색
Esc 2번변경 사항 되돌리기 메뉴 표시
↑ 키이전에 입력한 명령어 불러오기

참고: PowerShell에서의 키 조작

Claude Code를 실행하기 전 PowerShell 화면에서는 키 동작이 다르다. 헷갈리기 쉬우므로 정리해둔다.

키PowerShell에서의 동작
→ 키회색 서제스트(예측 입력)를 받아들이기
Tab파일·폴더명 자동 완성 후보를 순서대로 표시
Shift + Tab자동 완성 후보를 역순으로 표시
Ctrl + Space자동 완성 후보 목록 표시 (방향키로 선택)
↑ 키이전에 입력한 명령어 불러오기

⚠️ Tab 키 동작 차이 정리

  • PowerShell: Tab → 파일명 자동 완성 전환. 서제스트 수락은 → 키
  • Claude Code: Tab → 회색 서제스트 수락

겉보기에 똑같은 "회색 글자"지만 수락 키가 다르므로 주의.

💡 Claude Code에서 파일명 자동 완성은 필요 없다
Claude Code에서는 파일명을 직접 타이핑할 일이 거의 없다.
"〜 파일 읽어줘", "〜 폴더 내용 보여줘"처럼 자연어로 말하면 Claude가 알아서 찾아준다.

모델 사용 구분

Claude Code는 3가지 모델을 지원한다. 작업 성격에 따라 구분하면 비용을 크게 절약할 수 있다.

모델특징적합한 작업비용
Haiku가볍고 빠름문서 작성, 간단한 수정, README 작성저렴
Sonnet균형형 (기본값)일반 코딩 작업보통
Opus고성능어려운 버그 추적, 복잡한 아키텍처 설계비쌈

💡 처음에는 Sonnet(기본값)으로 충분하다. 사용 패턴이 생기면 작업별로 나눠 써보자.

모델 전환 활용 예:

/model haiku
README.md를 작성해줘

（작성 완료 후）

/model sonnet
타이머 앱을 만들어줘

문서 작성만이라면 Haiku로도 충분하다. 같은 작업에 Opus를 쓰는 것 대비 비용 차이가 꽤 크다.

Subagents (서브에이전트)

서브에이전트는 전문가를 별도로 고용하는 것과 비슷한 개념이다.

평소 대화하는 Claude(메인 에이전트)가 특정 작업을 별도 Claude(서브에이전트)에게 위임하는 구조다.

+---------------------------+
|  메인 에이전트            |  ← 평소 대화하는 Claude
|  （Claude Code 본체）     |
+---------------------------+
       |
       | 「이 작업 맡아줘」
       ↓
+---------------------------+
|  서브에이전트             |  ← 전문가로 호출됨
|  （예: 코드 리뷰 담당）   |
+---------------------------+
       |
       | 「결과만 보고」
       ↓
+---------------------------+
|  메인 에이전트            |
+---------------------------+

서브에이전트를 쓰면 좋은 점

  • 별도 작업 공간: 메인 대화가 복잡해지지 않는다. 결과만 받아볼 수 있다
  • 권한 제한 가능: "파일 읽기만 허용, 수정 금지" 등 세밀한 제어 가능
  • 사전 지시 설정: 매번 설명하지 않아도 전문적인 지시를 미리 설정해둘 수 있다

서브에이전트 만들기

Claude Code에 직접 요청한다:

> 코드 리뷰 전용 서브에이전트를 만들어줘

Claude가 .claude/agents/ 폴더와 정의 파일을 자동 생성해준다.

생성 예시: 코드 리뷰 전용 서브에이전트

파일: .claude/agents/code-reviewer.md

---
name: code-reviewer
description: 코드 리뷰 전용. 보안과 품질을 체크.
tools: Read, Grep, Glob
disallowedTools: Write, Edit, NotebookEdit
---

당신은 코드 리뷰 전문가입니다.

체크 포인트:
1. 보안 리스크
2. 퍼포먼스 문제
3. 에러 처리 미비

문제를 발견하면 구체적인 수정안을 제시해주세요.

💡 tools / disallowedTools 설명

  • tools: Read, Grep, Glob → 이 서브에이전트에게 허용할 작업 (읽기 계열만)
  • disallowedTools: Write, Edit, NotebookEdit → 명시적으로 금지할 작업

둘 다 지정해두면 "읽기 전용 서브에이전트"가 완성된다. 리뷰 담당이 코드를 멋대로 수정하는 상황을 방지할 수 있다.

글로벌로 등록하기 (모든 프로젝트에서 재사용)

한번 만든 서브에이전트를 다른 프로젝트에서도 쓰고 싶다면:

Windows (PowerShell):

$claudeDir = "$env:USERPROFILE\.claude"
New-Item -ItemType Directory -Force -Path "$claudeDir\agents\code-reviewer"
Copy-Item ".\.claude\agents\code-reviewer.md" "$claudeDir\agents\code-reviewer\"

macOS / Linux:

mkdir -p ~/.claude/agents/code-reviewer
cp .claude/agents/code-reviewer.md ~/.claude/agents/code-reviewer/

💡 로컬 vs 글로벌 비교

위치경로용도
로컬.claude/agents/해당 프로젝트에서만 사용
글로벌~/.claude/agents/내 모든 프로젝트에서 사용 가능

커스텀 명령어(후술)도 마찬가지로 ~/.claude/skills/에 배치하면 전역으로 쓸 수 있다.

서브에이전트 사용 방법

설정해두면 Claude가 상황에 맞춰 자동으로 활용한다.

명시적으로 지정하고 싶을 때:

code-reviewer 서브에이전트를 사용해서 이번 변경사항을 리뷰해줘

병렬 개발

복수의 Claude Code를 동시에 실행해서 서로 다른 작업을 병렬로 처리하는 방법이다.

시작 방법

  1. Windows Terminal 실행 (Microsoft Store에서 무료 설치 가능)
  2. 탭 여러 개 열기 (Ctrl + Shift + T)
  3. 각 탭에서 같은 프로젝트 폴더로 이동한 뒤 Claude Code 실행

💡 핵심: 반드시 같은 폴더에서 시작
두 탭 모두 동일한 프로젝트 폴더에서 claude를 실행해야 한다.
그래야 탭1이 생성한 파일을 탭2가 바로 읽을 수 있다.

실전 예시: 개발하면서 실시간 리뷰받기

앞서 만든 코드 리뷰 서브에이전트를 병렬 탭과 함께 활용하는 예시.

+-------------------------------------------+
|            Windows Terminal               |
+---------------------+---------------------+
|       탭1           |       탭2           |
|      구현 담당      |     리뷰 담당       |
+---------------------+---------------------+
|                     |                     |
| > cd ~/my-project   | > cd ~/my-project   |  ← 같은 폴더
| > claude            | > claude            |
|                     |                     |
| 타이머 앱을         | 방금 만든 코드를    |
| 만들어줘            | 리뷰해줘            |
|                     |                     |
+---------------------+---------------------+
         ↓                     ↓
   파일 생성            그 파일을 읽어서 리뷰

작업 흐름:

  1. 두 탭 모두 같은 폴더에서 claude 실행
  2. 탭1에서 코드 작성
  3. 어느 정도 완성되면 탭2에서 리뷰 요청 (탭1이 만든 파일을 즉시 읽을 수 있음)
  4. 지적 사항을 탭1에서 수정
  5. 반복

병렬 개발 주의사항

  • 같은 파일을 동시에 편집하지 말 것 (파일 충돌 발생)
  • 비용은 탭 수만큼 비례해서 증가한다
  • 여유가 있는 작업이라면 탭 1개로 순차 처리하는 게 경제적

커스텀 명령어

반복해서 사용하는 지시를 단축 명령어로 등록해두는 기능이다.

만드는 방법

Claude Code에 직접 요청한다:

> /test라고 입력하면 npm test를 실행하는 커스텀 명령어를 만들어줘

Claude가 .claude/commands/ 폴더와 정의 파일을 자동 생성한다.

생성 예시: 테스트 실행 명령어

파일: .claude/commands/test.md

---
description: 테스트를 실행하고 결과를 보고
---

npm test를 실행해주세요.
실패한 테스트가 있으면 원인을 분석하고 수정안을 제시해주세요.

사용 방법

/test

이것만으로 위에 정의한 지시 전체가 실행된다.

💡 활용 아이디어

  • /deploy → 빌드 + 배포 스크립트 자동 실행
  • /review → 코드 리뷰 서브에이전트 호출
  • /docs → 현재 파일에 대한 문서 자동 생성

확인 생략 설정 (Auto-accept)

Claude Code는 안전을 위해 파일 편집이나 명령어 실행 때마다 확인을 요청한다.
반복 작업 시 번거롭다면 자동 승인 설정을 활용하자.

방법 1: 그 자리에서 일시 전환 (가장 추천)

Claude Code 화면에서 Shift + Tab을 누르면 모드가 순환 전환된다.

모드화면 표시동작
일반 모드(표시 없음)모든 변경에 대해 확인 요청
Auto-acceptauto-accept edit on파일 편집 자동 승인
Plan 모드plan mode on읽기 전용 (조사·계획 전용)

💡 추천 사용 방식
처음에는 일반 모드로 Claude의 작업을 직접 확인하면서 익히고,
작업 패턴을 파악한 후 Auto-accept로 전환하는 것이 안전하다.

방법 2: 설정 파일에 영구 적용

매번 모드를 바꾸기 번거롭다면 설정 파일에 기록해둘 수 있다.

Claude Code에 직접 요청하거나:

> 설정 파일을 만들어서 파일 편집은 자동으로 허가하도록 해줘

수동으로 파일을 만들어도 된다.

파일: ~/.claude/settings.json (모든 프로젝트에 공통 적용)

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

💡 설정 파일 위치

위치경로적용 범위
전역 설정~/.claude/settings.json내 PC의 모든 프로젝트
프로젝트 설정.claude/settings.json해당 프로젝트 폴더에만 적용

방법 3: 특정 명령어만 선택 허용

"npm 명령어만 자동 승인하고 나머지는 확인받고 싶다"는 경우:

{
  "permissions": {
    "allow": [
      "Bash(npm run:*)",
      "Bash(npm test:*)"
    ]
  }
}

💡 와일드카드 패턴

npm run:* → npm run으로 시작하는 모든 명령어를 허용
* → 어떤 문자열과도 일치하는 패턴

Auto-accept 사용 시 안전 수칙

⚠️ 확인을 생략하면 그만큼 리스크도 커진다

  • Claude가 의도치 않은 파일을 수정해도 알아채지 못하고 진행될 수 있다
  • 실수로 중요한 파일이 삭제될 수 있다
  • Git으로 수시로 커밋해서 언제든 되돌릴 수 있는 상태를 유지할 것

절대 하면 안 되는 것:

  • --dangerously-skip-permissions 플래그 사용 금지 (모든 확인을 건너뛰는 매우 위험한 옵션)
  • 처음 접하는 오픈소스 프로젝트에서 Auto-accept 사용 금지
  • .env, API 키, 비밀번호 등 민감한 정보가 포함된 폴더에서 Auto-accept 사용 금지

비용 관리 요령

Claude Code는 사용량에 따라 비용이 발생한다. 아래 습관을 들이면 불필요한 비용을 줄일 수 있다.

1. /clear를 작업 단위로 실행하기

대화가 길어질수록 매 요청마다 이전 대화 전체를 다시 처리하므로 토큰 소비가 급증한다.
작업이 바뀔 때마다 /clear로 초기화하자.

2. 작업 성격에 맞는 모델 사용하기

작업권장 모델이유
문서 작성, 번역Haiku빠르고 저렴, 품질도 충분
일반 코딩Sonnet속도·품질·비용의 균형
어려운 버그, 복잡한 설계Opus고성능이 필요한 경우에만

3. /cost로 사용량 수시 확인하기

/cost

현재 세션에서 사용한 토큰과 예상 비용을 확인할 수 있다.
비용이 예상보다 빠르게 오른다면 /clear로 초기화하거나 모델을 전환하자.

profile
Jaewoo Kim
AI-fluent liberal arts engineer | AX Consulting | AI Workflow Architect | LLM Engineer | Claude Code | AI강의/개발/기술자문 | AI 업무 자동화 컨설팅
이전 포스트

Claude Code 설치 가이드 (Windows)

다음 포스트

Claude Code가 실행되지 않을 때 보는 페이지 (Windows 트러블슈팅)

0개의 댓글