🎓 유데미 강의 추천
Claude Code 실전 강의 — AI 코딩을 지금 시작하세요
설치부터 자동화·에이전트 활용까지, 실무에서 바로 쓰는 Claude Code 활용법을 단계별로 배울 수 있습니다.
강의 보러가기 →
Claude Code 가이드 #1 — 개요와 설치
Claude Code 는 Anthropic이 만든 에이전트 코딩 도구입니다. 코드를 읽고, 파일을 편집하고, 명령을 실행하고, 개발 도구와 통합할 수 있습니다. 🎓 유데미 강의 추천 Claude Code 실전 강의 — AI 코딩을 지금 시작하세요 설치부터 자동화·에이전트 활용까지, 실무에서 바로 쓰는 Claude Code 활용법을 단계별로 배울 수 있습니다.
by Lee
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
💡 팁: npm으로 설치하면 자동 업데이트가 됩니다. Homebrew나 WinGet은 수동 업데이트가 필요합니다 (
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가 프로젝트를 훨씬 정확하게 이해하고, 일관된 코드를 생성합니다.
자주 묻는 질문
Claude Code를 사용하려면 어떤 플랜이 필요한가요?
Claude Pro($20/월) 이상이면 Claude Code CLI를 사용할 수 있습니다. 맥스 플랜($100/월)은 더 많은 토큰과 오푸스 모델을 제공합니다. API 종량제로도 사용 가능합니다.
npm 외에 다른 설치 방법이 있나요?
네. Claude Code 데스크톱 앱(macOS/Windows)이나 VS Code 확장으로도 설치 가능합니다. CLI는 Node.js 18+ 환경에서 npm install -g @anthropic-ai/claude-code로 설치합니다.
설치 후 claude 명령어가 인식되지 않습니다.
npm global 경로가 PATH에 없는 경우입니다. which npm으로 경로 확인 후 .zshrc에 export PATH 설정을 추가하세요. npm prefix -g로 경로를 확인할 수 있습니다.
첫 실행 시 인증 화면이 나타나지 않습니다.
이미 인증이 완료된 상태이거나 캐시된 세션이 있는 경우입니다. claude auth status로 현재 상태를 확인하고, 필요하면 claude auth logout 후 재인증하세요.
Windows에서도 Claude Code를 설치할 수 있나요?
네. WSL2(Windows Subsystem for Linux)를 설치하면 Linux 환경에서 동일하게 사용 가능합니다. 또는 Claude Code 데스크톱 앱(Windows 버전)을 사용하는 방법도 있습니다.
🎓 관련 강의
Claude Code 완전 정복 — 유데미 강의
이 글에서 다룬 내용을 더 체계적으로 배우고 싶다면 강의를 확인해보세요. 실전 예제 중심으로 구성되어 있습니다.
강의 살펴보기 →
claude-code클로드 코드vibe-coding설치입문터미널
