Claude Code클로드 코드
터미널과 IDE 에서 코드를 읽고 고치고 실행하는 Anthropic 의 AI 코딩 에이전트
공식 사이트(claude.com)로 이동해 내려받습니다. 본 사이트는 설치 파일을 직접 제공하지 않습니다.
클로드 코드 소개
클로드 코드(Claude Code)는 클로드를 만든 Anthropic 이 개발자용으로 내놓은 AI 코딩 도구입니다. 일반 채팅과 달리 내 컴퓨터의 프로젝트 폴더에서 직접 동작해, 코드베이스를 스스로 읽고 여러 파일을 고치고 빌드·테스트 명령을 실행합니다. 윈도우, 맥, 리눅스 터미널에서 쓰는 CLI 가 중심이며, VS Code 와 JetBrains 확장, Claude 데스크톱 앱, 웹 브라우저에서도 사용할 수 있습니다.
"이 프로젝트 구조를 설명해 줘", "로그인 폼에 입력 검증을 추가해 줘"처럼 자연어로 요청하면 관련 파일을 찾아 변경안을 만들고, 필요하면 테스트를 돌려 결과를 확인합니다. 커밋 메시지 작성이나 브랜치 생성 같은 Git 작업도 대화로 처리하고, 프로젝트 규칙을 적어 두는 CLAUDE.md, 팀이 공유하는 .claude/settings.json, 외부 도구를 연결하는 MCP 서버로 작업 방식을 맞출 수 있습니다.
파일 수정이나 명령 실행 전에 권한을 묻는 권한 모드가 있어 어디까지 자동으로 맡길지 직접 정할 수 있습니다. 무료 요금제에는 포함되지 않고 Claude 유료 요금제나 Console API 계정이 필요합니다. 이 페이지에서는 클로드 코드 공식 페이지 바로가기와 함께 설치 명령, 기본 사용법, 권한 설정, 오류 해결, 삭제 방법을 정리해 안내합니다.
주요 기능
Shift+Tab 으로 바꿔 가며 쓸 수 있습니다.CLAUDE.md 에 적어 두면 세션마다 자동으로 불러와 따릅니다.기본 정보
| 프로그램명 | Claude Code (클로드 코드) |
|---|---|
| 개발사 | Anthropic |
| 라이선스 | 유료 구독 — Claude 유료 요금제(Pro·Max·Team·Enterprise)에 포함되거나, Claude Console API 계정으로 쓴 만큼 과금 |
| 지원 OS | Windows, macOS, Linux, 웹 |
| 언어 | 한국어 포함 다국어(명령어·메뉴는 영어) |
| 카테고리 | AI 도구 |
| 공식 사이트 | code.claude.com |
| 최신 버전 | 공식 다운로드 페이지에서 확인 |
| 이전 버전 | 공식 이전 버전 보관 페이지 |
설치 요약

- 공식 문서의 시스템 요구사항(윈도우 10 이상, macOS 13 이상, 주요 리눅스 배포판, 인터넷 연결)을 확인합니다.
- 맥·리눅스·WSL 은 터미널에서
curl -fsSL https://claude.ai/install.sh | bash를 실행합니다. - 윈도우는 PowerShell 에서
irm https://claude.ai/install.ps1 | iex를 실행합니다. Homebrew(brew install --cask claude-code)나 WinGet(winget install Anthropic.ClaudeCode)으로도 설치할 수 있습니다. - 새 터미널 창을 열고
claude --version으로 설치를 확인합니다. - 작업할 프로젝트 폴더에서
claude를 실행하고, 브라우저 안내에 따라 Claude 유료 계정이나 Console 계정으로 로그인합니다.
주의사항
- 설치 명령은 공식 문서에 나온
claude.ai주소만 사용하세요. 블로그나 영상에 적힌 변형된 설치 스크립트, 이름이 비슷한 npm 패키지는 악성 코드일 수 있습니다. npm 패키지 이름은@anthropic-ai/claude-code입니다. - 클로드 코드는 내 컴퓨터에서 파일을 수정하고 명령을 실행합니다. 처음에는 수동 모드로 변경 내용을 확인하며 쓰고, 모든 확인을 건너뛰는
bypassPermissions모드는 격리된 컨테이너나 가상 머신에서만 쓰세요. .env파일, API 키, 고객 데이터처럼 민감한 파일은.claude/settings.json의 deny 규칙으로 읽지 못하게 막아 두세요. 출처를 모르는 저장소를 열 때는 그 안의 지시문이 의도치 않은 작업을 유도할 수 있음을 염두에 두세요.- AI 가 만든 코드는 동작이 맞아 보여도 보안 문제나 버그가 있을 수 있습니다. 커밋 전에 변경 내용을 직접 검토하고 테스트를 돌리세요.
자주 묻는 질문
sudo npm install -g 는 쓰지 말라고 공식 문서가 안내합니다.claude --version 을 실행하면 버전이 나옵니다. 네이티브 설치는 백그라운드에서 자동 업데이트되고, 바로 적용하려면 claude update 를 실행합니다. Homebrew·WinGet 설치는 각각 brew upgrade, winget upgrade 로 직접 업데이트합니다.Ctrl+Shift+X, 맥은 Cmd+Shift+X)에서 'Claude Code' 를 검색해 설치하면 편집기 안에서 쓸 수 있습니다. JetBrains IDE 용 플러그인도 있습니다./usage 를 입력하면 사용량과 한도를 확인할 수 있으며, 요금은 공식 요금 페이지에서 확인하세요./logout 으로 로그아웃한 뒤 클로드 코드를 종료하고 claude 로 다시 로그인하는 것이 가장 먼저 해 볼 방법입니다. 브라우저가 열리지 않으면 로그인 화면에서 c 를 눌러 주소를 복사해 직접 열고, WSL·SSH 환경이라면 claude auth login 을 사용하세요. 무료 요금제 계정은 클로드 코드에 로그인해도 쓸 수 없습니다. 자세한 방법은 오류 해결 가이드를 참고하세요.