클로드코드 01-overview.md

# Claude Code 개요 > Claude Code는 터미널에서 실행되는 AI 기반 에이전틱 코딩 도구다. 코드베이스를 읽고, 파일을 수정하고, 명령어를 실행하며, 개발 도구와 통합할 수 있다. ## Claude Code란? Claude Code는 Anthropic이 만든 에이전틱(주도적인) 코딩 어시스턴트다. 단순히 코드를 제안하는 것을 넘어서, 실제로 파일을 편집하고 명령어를 실행하며 여러 파일에 걸친 작업을 수행한다. ### 주요 특징 - **전체 코드베이스 이해**: 현재 디렉토리의 모든 파일을 접근할 수 있어 여러 파일을 동시에 수정한다. - **도구 사용**: 파일 읽기/쓰기, 셸 명령어 실행, 웹 검색, git 조작 등 다양한 도구를 사용한다. - **대화형 작업**: 자연어로 요청하면 계획을 세우고 실행한다. - **반복 개선**: 첫 시도가 완벽하지 않아도 대화를 통해 방향을 수정할 수 있다. ## 사용할 수 있는 환경 Claude Code는 여러 환경에서 동일한 엔진을 사용한다. | 환경 | 특징 | |------|------| | **Terminal (CLI)** | 가장 기능이 많은 버전. 파일 편집, 명령어 실행, 전체 프로젝트 관리 | | **VS Code** | IDE 내에서 직접 사용. 인라인 diff, @-mentions, 키보드 단축키 | | **JetBrains** | IntelliJ, PyCharm, WebStorm 등에서 사용 | | **Desktop app** | GUI 환경. 드래그 앤 드롭, 병렬 세션, 시각적 diff | | **Web (claude.ai/code)** | 브라우저에서 실행. 별도 설치 없이 사용 | | **Slack** | `@Claude` 멘션으로 작업 요청 및 PR 생성 | | **CI/CD** | GitHub Actions, GitLab CI/CD에서 자동화 | ## Claude Code로 할 수 있는 일 ### 지루한 작업 자동화 - 테스트가 없는 코드에 테스트 작성 - 프로젝트 전체의 lint 오류 수정 - merge conflict 해결 - 의존성 업데이트 - 릴리즈 노트 작성 ### 기능 개발 및 버그 수정 자연어로 원하는 것을 설명하면 Claude Code가 계획을 세우고 여러 파일에 걸쳐 코드를 작성한 뒤 검증한다. ```text add input validation to the user registration form ``` 버그의 경우 에러 메시지를 붙여넣거나 증상을 설명하면, 코드베이스를 추적해 원인을 파악하고 수정한다. ### Git 통합 Claude Code는 git과 직접 연동된다. ```text commit my changes with a descriptive message create a new branch called feature/quickstart help me resolve merge conflicts ``` ### 외부 도구 연결 (MCP) Model Context Protocol(MCP)을 통해 Google Drive, Jira, Slack 등 외부 도구와 연결할 수 있다. ### 커스터마이징 - **CLAUDE.md**: 프로젝트별 코딩 표준, 아키텍처 결정, 선호 라이브러리 지정 - **Skills**: 팀에서 공유할 수 있는 재사용 가능한 워크플로우 (`/review-pr`, `/deploy-staging` 등) - **Hooks**: 파일 편집 후 자동 포맷팅, 커밋 전 lint 실행 등 ## 다음 단계 - [02-installation.md](02-installation.md) - 설치 가이드 - [03-authentication.md](03-authentication.md) - 인증 설정 - [04-quickstart.md](04-quickstart.md) - 첫 세션 시작하기