Claude Code

Claude Code는 Anthropic이 개발한 AI 기반 CLI 도구로, 터미널에서 직접 Claude와 상호작용하며 코드 작성, 분석, 리팩토링, 디버깅 등 개발 작업을 수행한다.

개요

Claude Code는 단순한 코드 자동완성 도구가 아니라, 프로젝트 전체를 이해하고 파일을 읽고 쓰며 명령을 실행할 수 있는 agentic 개발 보조 도구다.

• 터미널에서 claude 명령으로 실행
• 파일 읽기/쓰기, 터미널 명령 실행, 코드 검색 등 수행 가능
• 대화 맥락을 유지하며 복잡한 멀티스텝 작업 처리

CLAUDE.md — 프로젝트 컨텍스트 설정

CLAUDE.md는 Claude Code가 프로젝트를 시작할 때 자동으로 로드하는 컨텍스트 파일이다. 프로젝트의 구조, 규칙, 주의사항을 정의하여 Claude가 해당 프로젝트에 맞는 방식으로 동작하도록 가이드한다.

위치 및 우선순위

작성 내용

• 프로젝트 구조: 디렉토리 구성, 주요 파일 설명
• 기술 스택: 사용 언어, 프레임워크, 라이브러리
• 코딩 컨벤션: 네이밍 규칙, 파일 구조 패턴
• 금지 사항: 수정하면 안 되는 파일, 피해야 할 패턴
• 자주 하는 작업: 반복 명령어, 빌드/테스트 방법

MCP 서버 연동

MCP(Model Context Protocol)는 Claude가 외부 시스템에 접근할 수 있도록 하는 표준 프로토콜이다. Claude Code에 MCP 서버를 연결하면 Claude가 데이터베이스, API, 파일 시스템 등에 직접 접근할 수 있다.

설정 방법

~/.claude/claude.json 또는 프로젝트의 .claude/claude.json에 MCP 서버를 등록한다.

{
  "mcpServers": {
    "my-db": {
      "command": "node",
      "args": ["./mcp-server.js"]
    }
  }
}

활용 사례

• 데이터베이스 조회: Claude가 직접 DB에 쿼리를 실행하여 실제 데이터를 기반으로 답변
• 사내 시스템 연동: 이슈 트래커, 문서 도구, 슬랙 등과 연결
• 외부 API 호출: 날씨, 환율 등 외부 서비스 실시간 조회

슬래시 명령어

Claude Code는 / 접두사로 시작하는 슬래시 명령어를 지원한다.

활용 패턴

반복 작업 자동화

CLAUDE.md에 프로젝트 규칙을 정의하고, Claude Code를 통해 파일 생성·수정을 자동화한다.

코드 리뷰 및 리팩토링

변경된 파일의 diff를 기반으로 코드 리뷰를 요청하거나, 특정 파일의 구조 개선을 요청할 수 있다.

이슈 해결

에러 메시지나 버그 설명을 전달하면 관련 코드를 탐색하고 수정 방안을 제안·적용한다.