[기타/AI] Claude Code 설치와 사용법: Anthropic 코딩 에이전트를 터미널에 붙이는 법
업데이트:
한눈에 고르기
| 상황 | 먼저 보기 |
|---|---|
| 공식 권장 흐름으로 빠르게 설치 | 설치 스크립트 중심으로 시작 |
| 패키지 매니저로 관리하고 싶음 | Homebrew 경로 검토 |
| Codex, Cursor와 비교해서 고를 예정 | 터미널 중심인지 IDE 중심인지부터 구분 |
빠른 답
- Claude Code는 Anthropic의 터미널 코딩 에이전트입니다.
- 가장 빠른 설치는 공식 스크립트나 Homebrew 경로이고, Windows는 WSL 기준으로 접근하는 편이 안정적입니다.
- 긴 문맥을 읽으며 설명형으로 협업하는 데 강하지만, GUI 중심 편집이 더 중요하면 Cursor가 더 편할 수 있습니다.
어떤 도구인가
Claude Code는 긴 문맥과 설명형 협업 감각이 강한 코딩 에이전트입니다. 리포지토리 맥락을 읽고, 파일을 수정하고, 테스트를 돌리고, Memory와 Hooks 같은 요소까지 붙여 팀 워크플로우에 적응시키는 방식이 핵심입니다.
개념이나 비교 관점이 먼저 필요하면 Claude Code란 무엇인가?도 같이 보면 연결이 더 잘 됩니다. 도구의 포지션과 철학을 먼저 읽고 싶다면 기존 개념 글이 배경이 됩니다.
공식 사이트와 다운로드 경로
- 공식 사이트: Claude Code 공식 문서
- 다운로드/접속 경로: Claude Code Quickstart
- 공식 문서: Claude Code Hooks 문서
지원 환경과 설치 방법
Windows
공식 quickstart 기준으로 Claude Code는 Windows에서 WSL을 통한 사용을 안내합니다. 순수 PowerShell보다 WSL을 기준으로 보는 편이 안전하고, 이후 Git과 셸 도구 연동도 더 자연스럽습니다.
가장 대표적인 설치법은 두 가지입니다. 첫 번째는 PowerShell에서 네이티브 설치 스크립트를 실행하는 방법이고, 두 번째는 Node를 이미 쓰고 있다면 npm으로 설치하는 방법입니다.
irm https://claude.ai/install.ps1 | iex
npm install -g @anthropic-ai/claude-code
macOS
macOS는 설치 스크립트, npm, Homebrew 경로를 모두 공식 문서가 다룹니다. 가장 빠른 진입은 설치 스크립트이고, 패키지 관리 흐름을 선호하면 Homebrew나 npm 경로도 괜찮습니다.
보통은 네이티브 설치 스크립트나 Homebrew cask 둘 중 하나만 기억해 두면 충분합니다.
curl -fsSL https://claude.ai/install.sh | bash
brew install --cask claude-code
Linux
Linux는 설치 스크립트나 npm 경로가 가장 일반적입니다. 서버나 원격 개발 환경에서도 잘 맞지만, 셸 권한과 프로젝트 권한을 먼저 점검하는 편이 좋습니다.
대표적으로는 네이티브 설치 스크립트와 npm 전역 설치를 많이 씁니다.
curl -fsSL https://claude.ai/install.sh | bash
npm install -g @anthropic-ai/claude-code
기본 사용법
Claude Code는 설치 후 바로 Hooks와 Memory를 다 붙이기보다, 대화형 작업부터 안정시키는 편이 좋습니다. 리포지토리 하나를 골라 파일 탐색과 작은 수정, 테스트 실행이 자연스럽게 이어지는지부터 확인하면 이후 설정이 훨씬 쉬워집니다.
- 공식 quickstart의 설치 스크립트 또는 npm, Homebrew 경로로 설치합니다.
- 리포지토리 루트에서
claude를 실행하고, 작업 범위와 선호하는 명령 흐름을 정리합니다. - 작은 수정부터 맡기고 Memory와 Hooks 설정은 이후 단계에서 붙입니다.
curl -fsSL https://claude.ai/install.sh | bash
# 또는
npm install -g @anthropic-ai/claude-code
claude
어떤 사람에게 잘 맞나
Claude Code는 설명과 코드 이해를 함께 다루고 싶거나, 터미널 안에서 장문 컨텍스트 협업을 선호하는 사람에게 잘 맞습니다. 문서와 코드가 섞인 작업에서 특히 편합니다.
주의할 점
WSL 여부, 셸 권한, 훅 자동화 범위가 꼬이면 처음 체감이 생각보다 무거울 수 있습니다. 처음부터 모든 자동화를 붙이기보다, 대화형 사용부터 안정시키는 편이 좋습니다.
요약
Claude Code는 설치보다 워크플로우 적응력이 매력인 도구입니다. 공식 quickstart의 기본 설치를 따라간 뒤, 작은 코드 수정과 설명형 협업부터 시작하면 장점이 빨리 드러납니다.
참고 자료
이 글과 함께 보면 좋은 글
지금 읽은 내용을 바로 확장하거나, 실제 선택과 설치까지 이어질 만한 글들만 골랐습니다.
- Codex CLI 설치와 사용법 OpenAI 계열 CLI와 비교할 때
- Cursor 설치와 사용법 IDE 기반 에이전트와 비교할 때
- MCP란 무엇인가 도구 연결 구조까지 이해하고 싶을 때
이런 주제는 어떠신가요?
비교 글과 설치 가이드를 함께 보면 나에게 맞는 도구를 더 빨리 고르기 좋습니다.
댓글남기기