Claude Code 소개

Claude Code란?

Claude Code는 Anthropic이 만든 AI 기반 CLI(Command Line Interface) 도구입니다. 터미널에서 직접 Claude AI와 대화하며 코드를 작성하고, 파일을 편집하고, 버그를 수정하고, 복잡한 소프트웨어 엔지니어링 작업을 자동화할 수 있습니다.

단순한 코드 자동완성을 넘어, 프로젝트 전체 맥락을 이해하고 파일을 직접 읽고 수정하며 명령을 실행하는 자율 에이전트입니다.

주요 특징

파일 시스템 직접 접근

Claude Code는 프로젝트 디렉토리의 파일을 직접 읽고 편집합니다. "이 버그 고쳐줘"라고 말하면 관련 파일을 탐색하고 수정까지 완료합니다.

터미널 명령 실행

테스트 실행, 빌드, Git 커밋 등 셸 명령을 직접 실행하고 결과를 바탕으로 다음 작업을 이어갑니다.

멀티 에이전트 오케스트레이션

복잡한 작업을 여러 서브에이전트에 병렬로 위임하여 대규모 작업도 효율적으로 처리합니다.

MCP(Model Context Protocol) 지원

외부 도구와 서비스를 MCP 서버로 연결하여 Slack, Jira, GitHub, 데이터베이스 등을 Claude에서 직접 제어할 수 있습니다.

프로젝트 맥락 학습

CLAUDE.md 파일로 프로젝트 관습, 코딩 스타일, 주의사항을 Claude에게 전달합니다.

작동 방식

사용자 → 자연어 요청
    ↓
Claude Code → 프로젝트 파악 (파일 읽기, 검색)
    ↓
계획 수립 → 파일 편집 / 명령 실행 / API 호출
    ↓
결과 확인 → 테스트 실행 → 피드백
    ↓
완료 보고

지원 플랫폼

플랫폼	지원 방식
macOS	CLI, 데스크탑 앱
Linux	CLI
Windows	CLI (WSL 권장)
VS Code	익스텐션
JetBrains	익스텐션
claude.ai	웹 앱 (`/code`)

Claude Code vs 다른 AI 코딩 도구

도구	특징	적합한 사용
Claude Code	자율 에이전트, 파일/터미널 직접 접근	복잡한 멀티파일 작업, 리팩토링, 자동화
GitHub Copilot	에디터 내 자동완성	코드 작성 보조
Cursor	AI 통합 IDE	에디터 중심 작업
ChatGPT	대화형, 파일 접근 제한	질문/답변, 코드 리뷰

시작하기

이 가이드는 Claude Code를 처음 접하는 개발자부터 고급 자동화를 구성하려는 팀까지 모두를 위한 문서입니다.

사용자 가이드: 설치, 기본 사용법, MCP 연동, IDE 설정
관리자 가이드: API 키 관리, 권한 설정, 훅, 보안
유용한 팁: 실무 워크플로우, 프롬프트 작성 요령, 생산성 향상 팁