GitHubAboutDocsTech-Log

Claude Code Core Features and Usage Guide

Claude Code는 Anthropic이 개발한 터미널 기반 AI 어시스트턴트다.

  • GUI나 IDE 확장 프로그램에 집중하는 것과 달리, Claude Code는 개발자의 핵심 작업 공간인 터미널(CLI) 환경에 직접 통합

  • 이 접근 방식 덕분에 단순한 코드 생성을 넘어, Git 명령어 실행, 파일 시스템 조작, Bash 스크립트 실행, 테스트 구동 등 개발 워크플로우 전반에 직접 개입 가능

Claude Code 컨텍스트 관리 기술

AI 성능의 핵심인 컨텍스트를 Claude Code는 다음과 같은 고유한 명령어로 관리한다.

기능/명령어
핵심 역할
상세 설명

/init

초기 컨텍스트 학습

프로젝트 첫 실행 시 전체 구조와 코드를 스캔하고 색인화(RAG 준비)

CLAUDE.MD

영구적 컨텍스트 저장

AI가 항상 기억해야 할 아키텍처, 기술 스택, 코딩 규칙을 정의 (전역/프로젝트별 설정 가능)

@ (참조)

명시적 컨텍스트 주입

AI의 컨텍스트 윈도우에 특정 파일이나 폴더를 직접 지정하여 집중시킴

Claude Code 대화 및 세션 관리

컨텍스트 윈도우의 한계를 관리하고 AI의 기억을 제어하는 기능이다.

명령어
핵심 기능
사용 목적

/clear

컨텍스트 윈도우 초기화

(단기 기억 삭제) 컨텍스트 용량 초과 방지, 비용 절감, 새 작업 시작 시 혼선 방지

# (기록)

영구 컨텍스트로 승격

(단기 기억 -> 영구 기억) 대화 중 얻은 유용한 규칙이나 정보를 CLAUDE.MD에 저장

/compact

컨텍스트 요약

이전 맥락을 압축하여 유지하면서 컨텍스트 윈도우 여유 공간 확보 (성능 저하 시 유용)

/resume

이전 대화 복원

/clear로 지워진 내용을 다시 불러와 대화를 이어감

/export

세션 내보내기

현재 대화 내용을 마크다운 파일 등으로 백업 및 문서화

/rewind

체크 포인트 복원

특정 시점으로 대화 상태 및 코드 상태를 되돌림

상호작용 및 워크플로우

효율적인 입력을 통해 개발 워크플로우를 자동화하는 기능이다.

명령어 큐 (순차적 작업)

  • 여러 명령을 연속 입력(Shift + Enter)하면, 큐에 쌓아두고 순차적으로 처리

  • (예: 1. analyze project (Enter) 2. refactor code (Enter))

워크플로우 연동

  • Git 연동: commit my changes with a descriptive message -> AI가 git diff를 분석하여 커밋 메시지 생성 및 실행

  • 테스트/디버깅: run and fix failed tests -> AI가 테스트 실패 로그를 분석하고 코드 수정을 시도

고급 워크플로우: 자동화

커스텀 명령어 (Custom Command)

반복적인 프롬프트(예: 코드 리뷰, Git 커밋)를 나만의 명령어로 저장하여 자동화하는 기능이다.

  • 생성: .claude/commands (프로젝트별) 또는 ~/.claude/commands (전역) 폴더에 .md 파일로 프롬프트 작성

  • 파일 내용:

    • 순수 텍스트 프롬프트 작성

    • $ARGUMENTS 변수 사용 가능 (명령어 인자 전달용)

  • 사용법: 터미널에서 /명령어이름 [인자] 형태로 호출

# 코드 리뷰어 역할을 하는 커스텀 명령어 예시

Review the code in the file `$ARGUMENTS`.
Please check for readability and potential null pointer exceptions (NPEs).
# 터미널에 명령어와 '인자(파일명)'를 함께 입력
/review src/main/java/UserService.java

IDE 연동 (IntelliJ 기준)

IntelliJ 플러그인과 함께 사용할 때의 추가적인 활용법이다.

  • Diff 뷰 활용

    • AI가 제안한 코드 변경 사항을 터미널 텍스트가 아닌 IDE의 시각적인 Diff 뷰로 검토 가능

    • AI의 제안을 직관적으로 검토하고 수락(Accept)하거나 거부(Reject) 가능

  • 컨텍스트 공유

    • 플러그인을 통해 현재 IDE에서 열린 파일이나 선택된 코드 블록을 Claude Code 컨텍스트로 쉽게 공유

Claude Code 실행 권한

AI 모델(서버)이 생성한 코드나 명령어를 사용자 PC(클라이언트)에서 실행할 때의 제어 방식이다.

설정 / 옵션
설명
위험도

권한 요청 (Yes/No) (기본값)

AI가 생성한 파일 변경/Bash 명령어를 사용자가 검토하고 승인하는 안전장치

낮음

--dangerously-skip-permissions

모든 권한 요청을 건너뛰고 AI의 제안을 즉시 실행

높음

Last updated

Was this helpful?