Claude Code 가이드 #1 — 개요와 설치
Claude Code란 무엇인지, 설치 방법부터 첫 실행까지. 터미널, VS Code, 데스크톱 환경별 시작 안내.
Claude Code는 Anthropic이 만든 에이전트 코딩 도구입니다. 코드를 읽고, 파일을 편집하고, 명령을 실행하고, 개발 도구와 통합할 수 있습니다. 터미널, VS Code, 데스크톱 앱, 브라우저에서 사용할 수 있습니다.
이 시리즈는 공식 문서(docs.anthropic.com)를 기반으로, Claude Code를 처음 시작하는 개발자를 위해 핵심만 정리합니다. 첫 편에서는 설치부터 첫 실행까지 다룹니다.
Claude Code란 무엇인가?
Claude Code는 터미널에서 실행되는 AI 코딩 에이전트입니다. 단순한 코드 자동완성이 아니라, 프로젝트 전체를 이해하고 파일을 직접 편집하며 명령어를 실행할 수 있습니다.
- 코드베이스 탐색: 프로젝트 구조를 파악하고 관련 파일을 찾습니다
- 파일 편집: 코드를 직접 수정하고 새 파일을 생성합니다
- 명령 실행: npm install, git commit, 테스트 등을 터미널에서 실행합니다
- 도구 통합: MCP를 통해 외부 서비스(Jira, Slack, Google Drive)와 연결됩니다
설치하기
Claude Code는 여러 방법으로 설치할 수 있습니다. Node.js 18 이상이 필요합니다.
npm (권장)npm install -g @anthropic-ai/claude-code
macOS - Homebrewbrew install claude-code
Windows - WinGetwinget install Anthropic.ClaudeCode
brew upgrade claude-code).첫 실행
설치 후, 프로젝트 디렉토리에서 claude를 실행합니다.
프로젝트 폴더에서 시작cd my-project claude
처음 실행하면 인증 과정을 거칩니다. Claude 구독 또는 Anthropic Console 계정이 필요합니다. 인증이 완료되면 바로 자연어로 작업을 지시할 수 있습니다.
예시: 첫 번째 명령> 이 프로젝트의 구조를 분석하고 README를 만들어줘
사용 환경별 안내
Claude Code는 세 가지 환경에서 사용할 수 있습니다.
- 터미널 CLI: 가장 기본적인 사용법. 모든 기능 지원.
claude명령으로 시작 - VS Code 확장: 에디터 안에서 Claude Code를 사용. 코드 컨텍스트를 자동으로 공유
- 데스크톱 앱: 독립 실행형 앱으로 사용
터미널 CLI가 가장 강력하고, 대부분의 개발자가 선호하는 환경입니다.
다음 편 예고
다음 편에서는 Claude Code의 핵심 설정 파일인 CLAUDE.md를 다룹니다. 프로젝트 루트에 CLAUDE.md를 잘 작성하면 Claude Code가 프로젝트를 훨씬 정확하게 이해하고, 일관된 코드를 생성합니다.