Claude Code 가이드

소개

Claude Code란?

Claude Code는 터미널에서 실행되는 AI 에이전트입니다.
단순한 자동완성 도구가 아니라, 전체 프로젝트를 이해하고 자율적으로 행동하는 페어 프로그래머입니다.

일반 인라인 어시스턴트

현재 파일만 인식
텍스트 응답 중심
수동 실행 필요
단일 파일 편집

VS

Claude Code

전체 프로젝트 파악
도구로 실제 행동
테스트·커밋 자율 수행
다중 파일 조정 편집

📁

파일 작업

파일 읽기, 코드 편집, 새 파일 생성, 재구성

🔍

검색

패턴으로 파일 찾기, 정규식으로 콘텐츠 검색

⚡

실행

셸 명령 실행, 서버 시작, 테스트 실행, git 사용

🌐

웹

웹 검색, 문서 가져오기, 오류 메시지 조회

🧠

코드 인텔리전스

타입 오류 확인, 정의로 이동, 참조 찾기

🤖

AI 에이전트

코딩에 특화된 터미널 기반 AI 에이전트

작동 원리

에이전트 루프

Claude Code는 작업을 받으면 세 단계를 반복합니다.

프롬프트 입력

↓

①

컨텍스트 수집

파일 읽기, 코드 탐색

→

②

작업 수행

파일 편집, 명령 실행

→

③

결과 검증

테스트 실행, 오류 확인

↓

완료 (또는 다시 ①로)

예시

"실패한 테스트를 수정해"

1 테스트를 실행해 어떤 게 실패했는지 확인

2 오류 출력을 읽고 관련 소스 파일을 검색

3 해당 파일을 읽어 코드 이해

4 파일을 편집해 문제 수정

5 테스트를 다시 실행해 검증

💡 사용자도 이 루프의 일부입니다. 언제든지 중단하고, 방향을 바꾸거나 추가 컨텍스트를 줄 수 있습니다.

설치

지금 바로 시작하세요

운영체제에 맞는 방법으로 설치하세요. 로그인 후 자격 증명이 저장되어 매번 로그인할 필요가 없습니다.

macOS / Linux / WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Homebrew (macOS)

brew install --cask claude-code

WinGet (Windows)

winget install Anthropic.ClaudeCode

로그인 및 시작

          # 처음 실행 시 로그인 메시지 표시
claude

# 이미 실행 중이라면
/login
        

👤

Claude.ai 구독 플랜 (권장)

🔑

Claude Console 선불 크레딧 API 액세스

활용

주요 사용 예시

다양한 방식으로 Claude Code를 활용하세요.

🔎

코드베이스 이해

> what does this project do?

> explain the folder structure

> where is the main entry point?

✏️

코드 변경

> add input validation to the form

> refactor auth module to async/await

> add a hello world function

🐛

버그 수정

> users can submit empty forms - fix it

> fix login bug: blank screen after wrong credentials

📦

Git 작업

> commit my changes with descriptive message

> create branch feature/my-feature

> help me resolve merge conflicts

🧪

테스트 작성

> write unit tests for the calculator

> run tests and show failures

📝

문서화

> update README with installation instructions

> review my changes and suggest improvements

효과적으로 사용하는 법

더 잘 활용하는 4가지 팁

01

구체적으로 요청하기

❌ "fix the bug"
✅ "fix the login bug where users see a blank screen after entering wrong credentials"

02

먼저 탐색, 그 다음 구현

복잡한 작업은 Shift+Tab 두 번으로 Plan Mode를 활성화해 계획을 확인한 뒤 구현하세요.

03

검증 기준 제공하기

테스트 케이스를 함께 제공하면 Claude가 구현 후 자동으로 검증합니다.

04

대화처럼 반복하기

완벽한 프롬프트가 아니어도 됩니다. 방향이 맞지 않으면 중단하고 수정하면 됩니다.

안전

안전 및 권한 제어

🔄

체크포인트 (변경 취소)

Claude가 파일을 편집하기 전에 스냅샷을 자동으로 생성합니다.

Esc 두 번 → 마지막 변경 취소
Claude에게 직접 "취소해줘"라고 요청 가능

🛡️

권한 모드

Shift+Tab으로 모드를 순환합니다.

기본값	파일 편집 및 명령 실행 전 항상 승인 요청
자동 수락 편집	파일 편집은 자동, 명령은 여전히 승인 요청
Plan Mode	읽기 전용, 계획만 생성하고 검토 후 실행

참조

필수 명령 참조

CLI 명령

`claude`	대화형 모드 시작
`claude "task"`	일회성 작업 실행
`claude -p "query"`	쿼리 실행 후 바로 종료
`claude --continue`	가장 최근 대화 계속
`claude --resume`	이전 대화 선택해서 재개
`claude --continue --fork-session`	현재 세션 포크
`claude commit`	Git 커밋 생성

세션 내 명령

`/help`	사용 가능한 명령 표시
`/init`	CLAUDE.md 생성 안내
`/context`	컨텍스트 사용량 확인
`/compact`	컨텍스트 수동 압축
`/model`	모델 전환
`/clear`	대화 기록 초기화
`exit` 또는 `Ctrl+C`	종료

단축키

`Shift+Tab`	권한 모드 순환
`Esc × 2`	마지막 변경 취소
`Tab`	명령 완성
`↑`	명령 기록 탐색
`?`	전체 단축키 목록 보기

Claude Code Overview