Claude Code.

Claude Code는 Anthropic의 에이전트형 코딩 도구입니다. 코드베이스를 읽고, 파일을 수정하고, 명령을 실행하며, 터미널·IDE·데스크톱·웹 등 여러 면에서 같은 엔진으로 동작합니다.

🧩 무엇을 하나

• 탐색: 레포 구조를 읽고 관련 파일·심볼을 찾습니다.
• 구현: 여러 파일에 걸친 기능 추가, 버그 수정, 리팩터 초안을 만듭니다.
• 검증: 테스트·린트를 돌리고 실패를 고치는 루프를 돕니다.
• Git 연동: 커밋 메시지, 브랜치, PR 초안 작업을 돕습니다.
• 자동화: CI, 스케줄, 슬랙 등에서 반복 작업을 돌릴 수 있습니다.

터미널에서 프로젝트 루트로 들어가 claude를 실행하는 방식이 기본입니다. VS Code·Cursor 확장, JetBrains 플러그인, 데스크톱 앱, 웹(claude.ai/code)도 같은 계열입니다. 자세한 설치·서피스는 Claude Code overview를 참고합니다.

📝 CLAUDE.md와 메모리

프로젝트 루트의 **CLAUDE.md**는 세션 시작 시 읽는 고정 지시 파일입니다.

• 코딩 스타일, 아키텍처 결정, 선호 라이브러리, 리뷰 체크리스트를 적습니다.
• 팀이 공유하면 사람마다 다른 “기본값”으로 작업하는 일을 줄입니다.
• 자동 메모리와 skills, hooks로 반복 워크플로를 패키징할 수 있습니다.

프론트엔드 레포에서는 Emotion 규칙, Pages Router 제약, QA 순서(format → lint → test → build)처럼 깨지기 쉬운 팀 규칙을 여기에 두는 편이 효과적입니다.

🔌 MCP와 도구

**MCP(Model Context Protocol)**로 외부 데이터·도구를 연결합니다. 이슈 트래커, 문서, 브라우저, 사내 API 등을 에이전트가 읽거나 호출할 수 있습니다.

• 도구 권한이 넓을수록 생산성과 위험(잘못된 rm, 비밀 유출)이 같이 커집니다.
• 읽기 전용 도구와 쓰기·셸 도구의 승인 정책을 나눠 두는 편이 안전합니다.

💡 같이 알아둘 것

• Claude Code는 “채팅창에 코드 붙여넣기”보다 레포 안에서 도구를 돌리는 하네스에 가깝습니다.
• 긴 작업은 목표·완료 조건·금지 사항(배포, force push 등)을 먼저 명시합니다.
• 생성 결과는 항상 diff와 테스트로 검토합니다.

🔗 참고 자료

• Claude Code overview — 설치 서피스와 주요 기능을 설명합니다.
• Claude Code — Memory (CLAUDE.md) — 프로젝트 지시와 자동 메모리를 설명합니다.
• Claude Code — MCP — 외부 도구 연결 방식을 설명합니다.
• Claude Code — Best practices — 효과적인 사용 패턴을 정리합니다.