Claude Code 설치 및 기본 사용법 가이드
Claude Code는 AI 기반 코딩 어시스턴트로, 기능 구축, 버그 수정, 개발 작업 자동화를 돕습니다. 전체 코드베이스를 이해하고 여러 파일과 도구를 활용하여 작업을 완료합니다.
Claude Code는 다양한 환경에서 사용할 수 있습니다:
대부분의 플랫폼은 Claude 구독 또는 Anthropic Console 계정이 필요합니다. 터미널 CLI와 VS Code는 써드파티 제공자도 지원합니다.
터미널에서 직접 Claude Code를 사용하는 가장 완전한 방법입니다. 파일 편집, 명령 실행, 프로젝트 관리를 모두 할 수 있습니다.
Native Install (권장)
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell:
irm https://claude.ai/install.ps1 | iexWindows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
&&토큰이 유효한 statement separator가 아니라는 오류가 나타나면 PowerShell을 사용 중입니다. CMD를 사용하거나 위의 PowerShell 명령어를 사용하세요. 프롬프트에PS C:\가 표시되면 PowerShell이고,C:\만 표시되면 CMD입니다.
네이티브 Windows에서는 Claude Code가 Bash 도구를 사용할 수 있도록 Git for Windows 설치를 권장합니다. Git for Windows가 설치되어 있지 않으면 Claude Code는 PowerShell을 셸 도구로 사용합니다. WSL 설정에는 Git for Windows가 필요하지 않습니다. 네이티브 설치는 최신 버전을 유지하기 위해 백그라운드에서 자동으로 업데이트됩니다.
Homebrew (macOS/Linux)
brew install --cask claude-codeHomebrew는 두 가지 Cask를 제공합니다.
claude-code는 안정적인 릴리스 채널을 추적하며, 일반적으로 약 일주일 정도 지연되고 주요 회귀가 있는 릴리스는 건너뜁니다.claude-code@latest는 최신 채널을 추적하며, 새 버전이 출시되는 즉시 받습니다. Homebrew 설치는 자동 업데이트되지 않습니다. 최신 기능 및 보안 수정 사항을 얻으려면 설치한 Cask에 따라brew upgrade claude-code또는brew upgrade claude-code@latest를 실행하세요.
WinGet (Windows)
winget install Anthropic.ClaudeCodeWinGet 설치는 자동 업데이트되지 않습니다. 최신 기능 및 보안 수정 사항을 얻으려면 주기적으로
winget upgrade Anthropic.ClaudeCode를 실행하세요.
다른 패키지 관리자 (Debian, Fedora, RHEL, Alpine)
apt, dnf, 또는 apk를 사용하여 설치할 수도 있습니다.
설치 완료 후
cd your-project
claude첫 사용 시 로그인 창이 나타납니다. 진행하면 됩니다!
고급 설정을 통해 더 많은 설치 옵션, 수동 업데이트, 제거 방법을 확인하세요.
설치 문제 해결 페이지를 방문하여 문제가 발생했을 때 도움을 받으세요.
VS Code 에디터에서 inline diff, @-멘션, 계획 검토, 대화 기록을 사용할 수 있습니다.
설치 방법:
IDE나 터미널 없이 독립적으로 Claude Code를 실행합니다. Diff 시각화, 여러 세션 병렬 실행, 재발생 작업 스케줄링, 클라우드 세션이 가능합니다.
다운로드 및 설치:
설치 후 앱을 실행하고 로그인한 후 Code 탭을 클릭하면 시작됩니다. 유료 구독이 필요합니다.
로컬 설정 없이 브라우저에서 바로 Claude Code를 사용합니다. 오래 실행되는 작업 시작 후 나중에 확인하거나, 로컬에 없는 저장소를 작업하거나, 여러 작업을 병렬로 실행할 수 있습니다.
Desktop 브라우저와 Claude iOS 앱에서 사용 가능합니다.
claude.ai/code에서 코딩 시작
IntelliJ IDEA, PyCharm, WebStorm 등 JetBrains IDE의 플러그인입니다. 대화형 diff 보기와 선택 컨텍스트 공유를 지원합니다.
설치 방법:
Claude Code는 매일 반복하는 지루한 작업을 처리합니다: 테스트되지 않은 코드에 테스트 작성, 프로젝트 전체 lint 오류 수정, merge conflict 해결, 의존성 업데이트, 릴리스 노트 작성 등.
claude "write tests for the auth module, run them, and fix any failures"자연어로 원하는 기능을 설명하세요. Claude Code가 접근 방식을 계획하고, 여러 파일에서 코드를 작성하고, 정상 작동을 검증합니다. 버그의 경우 오류 메시지를 붙여넣거나 증상을 설명하면, Claude Code가 코드베이스 전체를 추적하여 근본 원인을 찾고 수정합니다.
Claude Code는 Git과 직접 연동합니다. 변경사항을 스테이징하고, 설명적인 commit 메시지를 작성하고, 브랜치를 만들고, pull request를 열 수 있습니다.
claude "commit my changes with a descriptive message"CI/CD에서는 GitHub Actions나 GitLab CI/CD로 자동 코드 리뷰와 이슈 분류를 할 수 있습니다.
Model Context Protocol (MCP)은 AI 도구를 외부 데이터 소스와 연결하는 개방형 표준입니다. MCP를 통해 Claude Code는 Google Drive에서 설계 문서를 읽고, Jira에서 티켓을 업데이트하고, Slack에서 데이터를 가져오거나, 커스텀 도구를 사용할 수 있습니다. MCP 빠른 시작 가이드는 첫 서버를 엔드 투 엔드로 연결하는 방법을 안내합니다.
CLAUDE.md: 프로젝트 루트에 추가하는 마크다운 파일입니다. Claude Code는 모든 세션 시작 시 이를 읽고, 코딩 표준, 아키텍처 결정, 선호 라이브러리, 리뷰 체크리스트를 설정합니다. Claude는 또한 빌드 명령어, 디버깅 인사이트 같은 학습 내용을 자동 메모리에 저장하므로 매번 써주지 않아도 됩니다.
커스텀 명령어 (Skills): /review-pr, /deploy-staging 같은 반복 가능한 워크플로우를 패키징하여 팀이 공유할 수 있습니다.
Hooks: Claude Code 작업 전후에 셸 명령어를 실행합니다. 예를 들어, 파일 편집 후 자동 포맷팅을 하거나 테스트를 실행할 수 있습니다.
Claude Code는 당신이 이미 사용 중인 플랫폼과 도구에 통합됩니다.
어디서나 Claude Code에 접근하세요. 데스크톱 브라우저와 Claude iOS 앱에서 코딩하고, 장시간 실행되는 작업을 시작한 후 나중에 확인할 수 있습니다.
데스크톱 앱에서 여러 세션을 병렬로 실행하거나, 클라우드 세션을 시작하여 리소스 집약적인 작업을 오프로드합니다.
VS Code, JetBrains IDE, Cursor에서 네이티브 통합으로 작업하세요. 대화형 diff 보기, 컨텍스트 공유, 계획 검토 기능을 활용할 수 있습니다.
Claude Code in Slack으로 팀과 함께 작업하거나, CI/CD 파이프라인에 통합하여 GitHub Actions와 GitLab CI/CD에서 자동 코드 리뷰를 실행합니다.
CLAUDE.md 파일과 자동 메모리 시스템을 활용하여 Claude Code의 동작을 커스터마이징할 수 있습니다. 프로젝트 규칙, 코딩 표준, 자주 사용하는 명령어 등을 저장하면 모든 세션에서 적용됩니다.
Claude Code의 파일 접근 및 명령 실행 권한을 세밀하게 제어할 수 있습니다. 프로젝트별로 또는 세션별로 권한을 설정하여 보안을 강화하세요.
cd your-project
claude첫 실행 시 로그인 창이 나타납니다. Anthropic 계정으로 로그인하면 됩니다.
대화형 모드 없이 단일 명령을 실행할 수도 있습니다.
claude "이 프로젝트의 구조를 설명해줘"Claude Code는 여러 Claude 모델을 지원합니다. 작업 목적에 맞는 모델을 선택하세요.
모델이란 Claude AI의 "두뇌 버전"입니다. 사람도 경험이 다르듯, AI도 모델에 따라 능력이 다릅니다.
Max Plan이나 Pro Plan을 사용하면 모델 선택을 크게 신경 쓰지 않아도 됩니다. 기본 설정 그대로 사용하면 됩니다.
| 항목 | 내용 |
|---|---|
| 용도 | 에이전트 작업 최적, 가장 강력한 모델 |
| 컨텍스트 | 200K 토큰 |
| 강점 | 복잡한 다단계 추론, 대규모 리팩토링, 아키텍처 설계 |
| 비용 | 가장 높음 |
| 항목 | 내용 |
|---|---|
| 용도 | 일상 코딩, 범용 작업 |
| 컨텍스트 | 200K 토큰 |
| 강점 | 빠른 응답 속도, 비용 효율적, 균형 잡힌 성능 |
| 비용 | 중간 |
| 항목 | 내용 |
|---|---|
| 용도 | 서브에이전트, 코드 탐색 |
| 컨텍스트 | 200K 토큰 |
| 강점 | 저비용, 빠른 응답, 탐색 작업에 최적 |
| 비용 | 가장 낮음 |
# 특정 모델로 시작
claude --model claude-opus-4-6대화 중: Alt+P로 모델 전환, /model 명령어로 선택, /fast로 Fast Mode 토글
Claude Code는 여러 계층의 설정 파일을 사용합니다.
설정 파일은 Claude Code에게 **"이 프로젝트에서는 이렇게 일해줘"**라고 알려주는 메모장 같은 것입니다. 예를 들어 "이 프로젝트는 TypeScript를 사용해", "테스트는 이렇게 실행해" 같은 정보를 적어두면 Claude가 매번 물어보지 않고도 알아서 처리합니다. 처음에는 신경 쓰지 않아도 되며, 익숙해진 후에 하나씩 설정하면 됩니다.
프로젝트 루트에 위치하며, Claude에게 프로젝트 컨텍스트를 제공합니다.
# 프로젝트 규칙
- TypeScript strict 모드 사용
- 테스트는 Vitest로 작성
- 커밋 메시지는 Conventional Commits 형식프로젝트별 설정, 에이전트, 명령어 등을 저장합니다.
.claude/
settings.json #