Claude Code(클로드 코드)는 Anthropic의 터미널 AI 에이전트입니다. 공식 권장은 Node.js가 필요 없는 네이티브 설치입니다. 아래 npm 방식도 선택할 수 있지만 Node.js 22 이상이 필요합니다. 기존 첫 실행 화면은 보존했고, 설치 조건은 2026년 10월 2일 공식 문서와 대조했습니다. 모든 운영체제에서 새로 설치 시험을 한 것은 아닙니다.
설치 — 윈도우와 맥
새로 설치한다면 아래 공식 네이티브 스크립트를 권장합니다. 별도 Node.js 설치 없이 사용할 수 있습니다. 윈도우 PowerShell:
irm https://claude.ai/install.ps1 | iex맥·리눅스(우분투 포함):
curl -fsSL https://claude.ai/install.sh | bashnpm 대안
npm 대안을 쓰려면 Node.js 22 이상이 필요합니다. 없다면 윈도우는 winget install OpenJS.NodeJS.LTS, 맥은 brew install node로 먼저 설치하고 터미널을 다시 여세요.
npm install -g @anthropic-ai/claude-code설치 확인은 claude --version. 버전 번호가 나오면 명령이 실행되는 단계까지 확인한 것입니다. 로그인·폴더 접근·실제 작업 성공은 별도로 확인하세요.
설치 후 첫 실행 — 로그인
작업할 폴더로 이동해 claude를 입력하면 시작됩니다. 처음에는 브라우저가 열리며 Claude 계정으로 로그인하고(Pro·Max·Team·Enterprise 또는 Console 인증 필요; 무료 Claude 플랜은 Claude Code를 포함하지 않음), 이어서 아래처럼 “이 폴더를 신뢰하느냐”고 묻습니다. Claude Code가 그 폴더의 파일을 읽고 수정할 수 있기 때문에 확인하는 절차입니다.
기본 사용법 — 이것만 알면 시작됩니다
- 그냥 한국어로 시키면 됩니다 — 처음에는 “파일을 수정하거나 명령을 실행하지 말고, 이 연습 프로젝트의 구조와 확인할 파일만 설명해줘”처럼 읽기 전용으로 요청하세요. 변경이 필요하면 먼저 제안과 대상 파일을 검토하고 승인합니다.
- Shift+Tab — 기본·편집 허용·계획 등 권한 모드를 순환합니다. 표시되는 모드와 허용 범위를 확인한 뒤 지시하세요.
- Esc 두 번 — 되감기 메뉴를 엽니다. 되돌릴 대화·파일 변경 범위를 확인하고 선택하세요.
- claude –resume — 지난 세션을 이어서 합니다. 대화는 자동 저장됩니다.
설치가 안 될 때
- “claude를 찾을 수 없습니다” — 터미널을 완전히 껐다 다시 여세요. 계속 인식되지 않으면 Windows PowerShell의
Get-Command claude -All, macOS·Linux의command -v claude로 경로를 확인하세요. 설치 실패와 PATH 문제를 구분해야 합니다. - npm 오류 —
node --version이 22 이상인지 확인하고, 네트워크·설치 권한·오류 메시지도 대조하세요. - 맥 권한 오류(EACCES) —
sudo npm install -g를 바로 사용하지 말고, 공식 네이티브 설치나 npm 권한 오류 안내를 확인하세요.
같이 보면 좋은 글
Codex·Gemini·Grok까지 8종 CLI의 설치 명령을 비교하려면 AI 코딩 CLI 설치 총정리를, 클로드 웹에서 결과물을 페이지로 뽑는 기능이 궁금하면 클로드 아티팩트 사용법을 참고하세요.
공식 확인: Claude Code 설치·인증 안내 · 참고: @anthropic-ai/claude-code — npm 공식 패키지
CLI로 만든 확장을 스토어에 올리실 계획이라면 — AI로 만든 크롬 확장이 웹스토어 심사에서 걸리는 지점 6가지에 권한·원격 코드·난독화처럼 코드를 짜는 단계에서 미리 잡아야 하는 항목을 정리해 뒀습니다.
답글 남기기