1. 개요
`Claude Code`는 Anthropic이 만든 터미널 기반 AI 코딩 에이전트입니다. ChatGPT나 Cursor처럼 에디터에 붙어서 코드 한 줄을 완성해 주는 수준이 아니라, 프로젝트 전체를 이해하고 파일을 읽고 쓰고 실행까지 자율적으로 수행합니다.
이 글에서는 개발을 위해 `Claude Code`를 처음 접할 때 반드시 알아야 할 기본 기능을 단계별로 정리했습니다.
2. Claude Code 기본 기능 정리
2-1. 설치 및 계정 연결
설치는 운영체제에 따라 한 줄 명령어로 끝납니다.
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash# Window PowerShell
irm https://claude.ai/install.ps1 | iex`Homebrew` 또는 `npm` 설치도 가능하지만 공식 인스톨러 사용을 권장합니다.
자동으로 업데이트를 지원하기 때문입니다. 설치 후 `claude --version`으로 정상 설치를 확인할 수 있습니다.
터미널에서 `claude`를 입력하면 계정 연결 화면이 나타납니다.
Claude Pro 이상 구독이 필요하며 사용량이 많다면 Max 플랜($200/월)이 가성비가 가장 좋습니다.
2-2. 모델 선택
클로드 코드 실행 후, `/model` 명령어로 AI 모델을 선택할 수 있고, 현재 세 가지 옵션이 있습니다.
| 모델 | 특징 | 추천 상황 |
| Haiku | - 가장 빠른 응답 | - 간단한 질문, 파일 찾기 |
| Sonnet | - 올라운더 - 속도 및 품질 균형 |
- 일반적인 개발 작업 |
| Opus | - 최강 추론 능력 - 토큰 소모 큼 |
- 복잡한 설계 - 대규모 코드 생성 |
최근 업데이트로 Opus 모델은 1M 토큰 컨텍스트 윈도우를 지원합니다.
즉, 대화 내용을 더 많이 기억하고 오랫동안 작업할 수 있습니다.
Max 플랜이라면 Opus 4.6을 기본으로 사용하는 것을 추천합니다.
2-3. 모드 전환
`Shift+Tab`을 누르면 모드가 전환됩니다.
- Accept edits on: 코드 변경을 자동으로 수락
- Plan mode: 계획만 세우고 코드는 변경하지 않음
- Default mode: 파일 diff를 확인하며 진행
`claude --dangerously-skip-permissions`로 실행하면 모든 권한 확인을 스킵할 수 있습니다.
편리하긴 하지만 프롬프트 인젝션 등의 위험이 있으므로 주의해야 합니다.
2-4. Plan Mode
`Claude Code`를 처음에 사용할 때 추천하는 방식은 항상 `Plan Mode`부터 시작하는 것입니다.
계획 없이 바로 코드 생성을 요청하면 엉뚱한 방향으로 달려가고, 수정하는 데 처음부터 제대로 계획하는 것보다 훨씬 오래 걸립니다. Plan Mode에서는 코드를 전혀 변경하지 않고, AI가 인터뷰어처럼 질문을 던지며 요구사항을 구체화합니다.
큰 프로젝트에서는 전체를 한 번에 계획하지 말고, 기능 단위로 Plan Mode를 분리해서 사용하는 것도 좋습니다.
2-5. 계획 실행
`Yes, and bypass permissions`를 선택하면 계획이 실행됩니다.
이전 대화 컨텍스트는 클리어되지만, 계획은 `. claude`폴더에 마크다운으로 저장되어 유지됩니다.
2-6. Memory와 CLAUDE.md
Claude Code는 `. claude`폴더를 통해 프로젝트 수준의 기억을 유지합니다.
`/init`명령어로 `CLAUDE.md`파일을 생성할 수 있으며, 이 파일은 매 프롬프트에 자동으로 주입되는 시스템 프롬프트 역할을 합니다.
아키텍처 컨벤션, 라이브러리 규칙, 코드 스타일 등을 기록해두면 매번 설명할 필요가 없습니다.
단, MIT 연구에서 시스템 프롬프트 파일이 오히려 품질을 저하시킬 수 있다는 결과도 있습니다.
토큰을 소모하고 모델의 집중도를 분산시킬 수 있기 때문입니다.
꼭 필요한 핵심 규칙만 간결하게 담는 방식으로 활용하세요.
2-7. 콘텍스트 관리
전체 대화 기록이 곧 콘텍스트입니다. 대화가 길어질수록 환각이 증가하고 응답 품질이 떨어집니다.
LLM에는 'Lost in the middle'이라는 현상이 있어, 긴 프롬프트의 중간 정보가 소실되는 경향이 있습니다.
`/context` 명령어로 토큰 사용량을 시각화 할 수 있는데 사용량이 70% 이상 도달했다면 정리가 필요합니다.
| 명령어 | 동작 |
| `/clear` | - 대화 기록 완전 초기화 (계획 및 파일은 유지) |
| `/compact` | - 핵심 정보를 보존하면서 요약 - 어떻게 요약하는지 컨트롤 할 수 없어서 비추천 |
3. 결론
이번 포스팅에서는 `Claude Code`의 기본 기능에 대해 살펴봤습니다.
클로드 코드는 단순한 코드 자동완성이 아니라 프로젝트를 이해하고 자율적으로 실행하는 AI 에이전트입니다.
제대로 활용하려면 몇 가지 원칙을 지키는 게 좋습니다.
- 항상 Plan Mode에서 시작 -> 계획 없이 코드 생성부터 시키지 않기
- 컨텍스트 70%에서 정리 -> `/clear` 또는 `/compact` 활용
- 생성된 코드는 반드시 리뷰 -> 규모자 커질수록 이상한 코드가 섞일 수 있음. Git 활용
- Git으로 커밋 및 브랜치 관리 -> AI가 망칠 때 롤백할 수 있는 안전망 확보
개발자의 역할이 코드 작성자에서 AI 에이전트 오케스트레이터로 바뀌고 있습니다.
다만 기술적 기초 없이 오직 AI에만 의존하면 바이브 코더에 불과합니다.
Claude Code를 잘 다루는 것도 결국 기술적 이해도에서 시작한다고 생각합니다.
다음 포스팅에서는 MCP, Skills에 대하여 알아보겠습니다.