이번 블로그에서는 Claude Code에 대해 알아보고 활용하는 방법에 대한 글을 작성해보겠습니다.
What is Claude Code?
- Anthropic의 CLI 기반 AI 코딩 에이전트입니다.
- 코드베이스를 읽고, 파일을 편집하고, 명령을 실행하고, 개발 도구와 통합하는 에이전트 코딩 도구입니다.
- Fable 5.1, Sonnet 5, Opus 5 등 최신 모델을 사용하고 있습니다.
- 뛰어난 컨텍스트 관리 및 툴 호출 능력을 가지고 있습니다.
Initial Setup
- Mac / Linux 기준
# 설치
curl -fsSL <https://claude.ai/install.sh> | bash
# 프로젝트 시작
mkdir my-project
cd my-project
claude- Windows 기준
# Powershell
irm <https://claude.ai/install.ps1> | iex
# CMD
curl -fsSL <https://claude.ai/install.cmd> -o install.cmd && install.cmd && del install.cmd
# 프로젝트 시작
mkdir my-project
cd my-project
claude
Chatting Mode (3가지)
Interactive
- 터미널 UI로 계속 대화합니다.
- 필요 시 권한 프롬프트가 뜨게 됩니다.
claude
Print / Headless
- 한 번 실행하고 응답을 stdout에 출력 후 종료합니다.
claude -p "질문"
Bare 모드
- headless보다도 더 가볍게 시작합니다.
- hooks, skills, 커스텀 커맨드, 서브에이전트, 플러그인, MCP 서버, auto memory, CLAUDE.md 자동 탐색을 전부 건너뜁니다.
- CI에서 어느 머신에서 실행해도 항상 같은 결과가 필요할 때 사용합니다.
claude --bare -p "..."
Permission Mode
- 세션 안에서 Claude가 확인 없이 어디까지 행동해도 되는가를 결정하는 설정입니다.
CLI에서는 Shift+Tab으로 순환 전환 가능합니다.
| 모드 (config 값) | CLI 표시 이름 | 확인 없이 실행되는 것 | 용도 |
| default | Manual | 읽기(Read)만 | 민감한 작업, 모든 액션을 직접 검토 |
| acceptEdits | Accept Edits | 읽기 + 파일 편집 + 기본 파일시스템 명령(mkdir,touch,mv,cp 등) | 이미 검토 중인 코드를 반복 수정할 때 |
| plan | Plan Mode | 읽기만 (auto 모드 사용 가능 시 classifier가 승인한 명령 포함) | 변경 전에 코드베이스 탐색 |
| auto | Auto Mode | 거의 모든 것 (별도 분류기 모델이 백그라운드에서 안전성 검사) | 장시간 작업, 프롬프트 피로 감소 - Pro/Max/Team 플랜의 기본값 |
| dontAsk | Don't Ask | 읽기 + 사전 승인된 도구만. 나머지는 전부 거부 | 잠금된 CI/스크립트 환경 |
| bypassPermissions | Bypass Permissions | 전부 | 격리된 컨테이너/VM 내부에서만 사용 권장 |
Memory System
- Claude Code의 각 세션은 매번 빈 컨텍스트로 시작합니다.
세션 간 지식을 이어주는 장치가 두 가지 있습니다.
| CLAUDE.md | Auto Memory | |
| 작성 주체 | 사용자 | Claude |
| 내용 | 지시·규칙 | 학습한 내용·패턴 |
| 범위 | 프로젝트 / 사용자 / 조직 | 저장소 단위 |
| 로드 시점 | 세션 시작 시 | 세션 시작 시 |
| 용도 | 코딩 표준, 워크플로, 프로젝트 아키텍처 | 사용자 선호, 교정 사항, 코드로 알기 어려운 맥락 |
Commands
핵심 커맨드
- /compact - 대화 맥락 압축 및 요약
- /context - 컨텍스트·토큰 사용량 확인
- /model - AI 모델 전환
- /cost - 사용 비용 확인
- /review - 코드 리뷰 요청
세션 관리
- /clear - 현재 대화 내용 초기화
- /rewind - 이전 상태로 되돌리기
- /resume - 이전 세션 이어서 작업
프로젝트 · 메모리
- /init - CLAUDE.md 생성 및 프로젝트 초기화
- /memory - 메모리 확인·편집
- /todos - 작업 목록 확인
진단 · 연결
- /doctor - Claude Code 설치·환경 진단
- /status - 현재 상태 및 설정 확인
- /mcp - MCP 서버 및 연결 상태 확인
이것으로 Claude Code Guide 글을 마치겠습니다. 감사합니다!