Skip to content
포켓인포
포켓인포

테크·IT·AI 도구 실전 가이드

  • 트렌드 뉴스
  • AI 도구
  • AI 반도체
  • 신기술 해설
  • 개발자 팁
  • 오류 해결
  • HBM
  • AI반도체
  • 메모리
포켓인포

테크·IT·AI 도구 실전 가이드

Claude Code 설치 가이드 — 초보자도 따라하는 macOS·Windows 단계별 설정 (예문 포함)

지금을산다는것, 2026-05-292026-05-31

요약 · Claude Code 설치는 macOS·Windows에서 한 줄로 설치하고 로그인해 첫 질문까지 가는 절차입니다. 이 글은 Native·Homebrew·WinGet·WSL·데스크탑 앱까지 5분 내 따라하기를 담았습니다.

핵심 포인트

  • Claude Code 설치는 한 줄 명령으로 시작해 로그인 후 즉시 사용
  • macOS는 Native 또는 Homebrew, Windows는 PowerShell·CMD·WinGet·WSL 선택
  • WSL 2는 샌드박싱 지원, Native Windows는 간편하나 샌드박싱 미지원
  • 필수 명령은 claude, claude -p, claude -c, claude -r와 세션 내 슬래시 명령
  • 업데이트는 Native 자동, Homebrew·WinGet은 수동 업그레이드 필요

목차

  1. 5분 가이드: Claude Code 설치 한눈에
  2. Claude Code로 할 수 있는 일
  3. 시스템 요구사항 체크리스트
  4. 설치 전 준비: 셸 확인과 계정
  5. macOS 옵션 A: Native 한 줄 설치
  6. macOS 옵션 B: Homebrew 설치
  7. macOS 옵션 C: 데스크탑 앱
  8. Windows 설치 방식 선택: Native vs WSL
  9. Windows 옵션 D: PowerShell 설치
  10. Windows 옵션 E: CMD 설치
  11. Windows 옵션 F: WinGet 설치
  12. Windows 옵션 G: WSL 2 설치
  13. Windows 옵션 H: 데스크탑 앱과 Git for Windows
  14. 첫 로그인: 터미널에서 계정 연결
  15. 첫 세션 5분 따라하기
  16. 필수 명령 요약과 예문
  17. 권한 모드와 단축키
  18. 업데이트·제거·버전 고정 가이드
  19. 자주 만나는 오류 해결

5분 가이드: Claude Code 설치 한눈에

Claude Code는 터미널(검은 화면)에서 사람 말로 코드를 부탁할 수 있게 해주는 Anthropic 공식 AI 도구입니다. 이 가이드는 Claude Code 설치부터 로그인, 첫 질문까지 5분 안에 따라 하도록 순서를 정리했습니다.

셸은 컴퓨터에 명령을 입력하는 창을 말하며, macOS의 터미널과 Windows의 PowerShell·CMD가 대표적입니다. 설치는 OS별로 한 줄 명령을 붙여넣는 방식이 가장 간단하고, 데스크탑 앱으로 시작하는 방법도 있습니다.

자세한 단계와 명령은 공식 문서를 기준으로 정리했습니다. 추가 확인이 필요하면 code.claude.com/docs/en/quickstart와 code.claude.com/docs/en/setup, code.claude.com/docs/en/desktop 내용을 참고하세요.

Claude Code로 할 수 있는 일

Claude Code는 폴더의 파일을 읽고 요약하거나, 함수 추가 같은 코드 수정 제안을 만들고 사용자 승인 후 자동 반영합니다. 예를 들어 “이 프로젝트가 뭐 하는 거야?”라고 물으면 주요 파일을 살펴 한두 문단으로 설명을 돌려줍니다.

또한 “main 파일에 hello world 함수 추가해 줘”처럼 자연어로 요청하면 변경 계획을 보여주고, 승인을 받으면 실제 파일을 수정합니다. 한국어로 요청해도 무리 없이 동작하며, 작업 맥락은 같은 폴더 기준으로 이어집니다.

대화형 모드와 단발성 작업 모드를 모두 지원해, 빠른 질의부터 연속적인 리팩토링까지 폭넓게 쓸 수 있습니다. 명령어는 간단하지만, 각 옵션의 의미를 이해하면 훨씬 효율적으로 사용할 수 있습니다.

시스템 요구사항 체크리스트

운영체제는 macOS 13.0 이상, Windows 10 1809 이상(또는 Windows Server 2019 이상), Ubuntu 20.04+, Debian 10+, Alpine 3.19+를 지원합니다. 하드웨어는 RAM 4GB 이상, x64 또는 ARM64 프로세서가 필요합니다.

네트워크는 인터넷 연결이 필수입니다. 셸은 Bash, Zsh, PowerShell, CMD 중 하나면 충분하며, 운영체제에 기본으로 들어 있는 도구 그대로 사용 가능합니다.

지역은 Anthropic 지원 국가에서 사용할 수 있으며 한국도 포함됩니다. ripgrep이라는 검색 도구가 함께 들어 있어 별도 설치는 필요하지 않습니다.

초보자용 한 줄 풀이: macOS는 2022년쯤 이후 모델이면 거의 다 됩니다. Windows는 10 또는 11이면 OK, 메모리는 4GB 이상이면 됩니다.

근거와 세부 표기는 공식 요구사항을 참조하세요. code.claude.com/docs/en/setup에 정리되어 있습니다.

설치 전 준비: 셸 확인과 계정

macOS에서는 런치패드에서 ‘터미널’을 검색해 실행하면 보통 Zsh 셸이 열립니다. 프롬프트는 대개 ‘이름@맥북 ~ %’처럼 보입니다.

Windows에서는 시작 메뉴에서 PowerShell 또는 명령 프롬프트(CMD)를 검색하세요. PowerShell이면 프롬프트 맨 앞에 ‘PS’가 붙어 ‘PS C:\Users\이름>’처럼 보이고, CMD는 ‘C:\Users\이름>’처럼 PS 없이 시작합니다.

예문: 내 PC 프롬프트가 ‘PS C:\Users\aiden>’로 보이면 PowerShell입니다. 아래 PowerShell 명령을 그대로 복사해 사용하면 됩니다.

또한 사용할 계정이 필요합니다. Claude 유료 구독(Pro/Max/Team/Enterprise), Claude Console(선결제 API 크레딧), 또는 회사에서 쓰는 클라우드(Bedrock/Vertex AI/Foundry) 중 하나면 됩니다. 로그인은 설치 후 첫 실행 시 브라우저로 연결됩니다.

macOS 옵션 A: Native 한 줄 설치

macOS에서 가장 빠른 방식입니다. 자동 업데이트가 켜져 있어 유지 관리가 편합니다. 맥북을 처음 쓰는 입문자에게 특히 추천됩니다.

  • 명령: curl -fsSL https://claude.ai/install.sh | bash
  • 이 명령은 무엇을 하는가: 공식 사이트의 설치 스크립트를 내려받아 즉시 실행해 Claude Code를 설치합니다.
  • 예상 결과(예문): 설치 마지막에 ‘Claude Code installed successfully’ 비슷한 문구가 뜨고, 새 터미널에서 ‘claude –version’ 입력 시 버전이 출력됩니다.
  • 흔한 오류: ‘command not found: claude’가 나오면 설치 직후 터미널을 새로 열지 않은 경우가 많습니다. 터미널을 닫았다가 다시 열고 시도하세요.

자동 업데이트 덕분에 별도의 업그레이드 명령 없이 최신 버전을 유지합니다. 기업 환경에서도 개인 개발용으로 간편하게 적용할 수 있습니다.

macOS 옵션 B: Homebrew 설치

평소 brew를 사용하는 분에게 알맞습니다. 안정 채널과 최신 채널 중 하나를 고르면 됩니다. 회사 환경에서 검증된 버전을 선호하면 안정 채널이 좋습니다.

  • 사전 준비 확인 명령: brew –version
  • 이 명령은 무엇을 하는가: Homebrew가 설치되어 있는지와 버전을 확인합니다.
  • 예상 결과(예문): ‘Homebrew 4.x.x’처럼 버전 문자열이 표시됩니다.
  • 흔한 오류: ‘command not found: brew’가 나오면 Homebrew가 설치되지 않은 상태입니다. Homebrew 설치 후 다시 진행하세요.
  • 안정 채널 설치: brew install –cask claude-code
  • 이 명령은 무엇을 하는가: 검증된 릴리스 버전의 Claude Code 데스크탑을 설치합니다.
  • 예상 결과(예문): 설치 완료 후 런치패드에 Claude 앱이 보입니다.
  • 흔한 오류: 권한 관련 경고가 뜨면 ‘brew doctor’로 진단 후 안내에 따라 권한을 조정하세요.
  • 최신 채널 설치: brew install –cask claude-code@latest
  • 이 명령은 무엇을 하는가: 출시 즉시 배포되는 최신 릴리스를 설치합니다.
  • 예상 결과(예문): 설치 직후 가장 최근 기능이 포함된 버전이 실행됩니다.
  • 흔한 오류: 드물게 잔버그가 있을 수 있습니다. 문제가 있으면 ‘brew uninstall –cask claude-code@latest’ 후 안정 채널로 전환하세요.

Homebrew는 자동 업데이트가 되지 않습니다. 주기적으로 ‘brew upgrade claude-code’ 또는 ‘brew upgrade claude-code@latest’를 실행하세요.

macOS 옵션 C: 데스크탑 앱

터미널이 낯선 사용자에게 쉬운 방법입니다. claude.ai 다운로드 페이지에서 macOS용 DMG를 받아 드래그 설치한 뒤 Claude 앱을 실행하세요. 앱 상단의 ‘Code’ 탭을 클릭하면 코드 도우미 기능을 GUI로 사용할 수 있습니다.

  • 작업: claude.ai 다운로드 페이지 접속 → DMG 다운로드 → 응용 프로그램 폴더로 드래그 → Claude 실행 → Code 탭 클릭
  • 이 절차는 무엇을 하는가: 터미널 없이도 Claude Code 기능을 앱 안에서 시작하게 해줍니다.
  • 예상 결과(예문): 첫 실행 시 로그인 안내가 뜨고 로그인 완료 후 Code 탭에서 바로 프로젝트를 열 수 있습니다.
  • 흔한 오류: 보안 설정으로 실행이 차단되면 시스템 설정의 보안 항목에서 ‘열기’를 허용한 뒤 다시 실행하세요.

데스크탑 앱은 시각적 인터페이스를 제공해 승인·변경 내역 확인이 한결 수월합니다. 추후 익숙해지면 터미널 명령과 병행해도 좋습니다.

Windows 설치 방식 선택: Native vs WSL

Windows에서는 크게 Native 설치와 WSL 2 중에서 고를 수 있습니다. Native는 윈도우 환경 그대로 사용하며 간단합니다. 다만 샌드박싱(명령을 안전하게 격리 실행) 기능은 지원되지 않습니다.

WSL 2는 윈도우 안에 리눅스를 띄우는 기능입니다. 리눅스 도구가 익숙하거나 샌드박싱이 필요하면 WSL 2를 추천합니다. 회사 보안 정책으로 WSL 2가 제한된 경우에는 WSL 1을 쓸 수 있으나, 가능하면 WSL 2가 더 낫습니다.

입문자 한 줄 가이드: 윈도우만 써왔다면 Native Windows를, 리눅스 명령에 익숙하면 WSL 2를 선택하세요. 프로젝트 특성과 사내 정책을 함께 고려하면 결정이 쉬워집니다.

Windows 옵션 D: PowerShell 설치

PowerShell은 Windows에서 권장되는 셸 중 하나입니다. 관리자 권한이 없어도 보통 설치가 가능합니다.

  • 명령: irm https://claude.ai/install.ps1 | iex
  • 이 명령은 무엇을 하는가: 공식 설치 스크립트를 내려받아 PowerShell에서 즉시 실행합니다.
  • 예상 결과(예문): 설치 완료 후 새 PowerShell 창에서 ‘claude –version’을 입력하면 버전이 표시됩니다.
  • 흔한 오류: ‘irm is not recognized’ 메시지가 나오면 지금 셸이 CMD라는 뜻입니다. 시작 메뉴에서 PowerShell을 다시 실행한 뒤 같은 명령을 시도하세요.

기업 PC에서 스크립트 실행 정책이 엄격한 경우가 있습니다. 정책 오류가 발생하면 IT 부서 정책에 맞는 대안을 사용하거나 WinGet·데스크탑 앱 설치를 고려하세요.

Windows 옵션 E: CMD 설치

CMD는 오래된 기본 셸로, 회사 환경에서 여전히 널리 사용됩니다. PowerShell이 제한된 환경에서 유용합니다.

  • 명령: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  • 이 명령은 무엇을 하는가: 설치 스크립트를 파일로 저장한 뒤 실행하고, 완료 후 스크립트를 삭제합니다.
  • 예상 결과(예문): 명령이 모두 성공하면 ‘claude –version’ 입력 시 버전이 출력됩니다.
  • 흔한 오류: ‘The token '&&' is not a valid statement separator’가 뜨면 지금 셸이 PowerShell입니다. PowerShell용 명령으로 다시 시도하세요.

CMD에서는 줄바꿈 없이 명령을 그대로 붙여넣는 편이 안전합니다. 권한 상승이 필요한 경우 관리자 권한 CMD로 실행하세요.

Windows 옵션 F: WinGet 설치

WinGet은 마이크로소프트의 표준 패키지 관리자입니다. 설치 및 업그레이드 절차가 깔끔하고 로그 관리가 편합니다.

  • 명령: winget install Anthropic.ClaudeCode
  • 이 명령은 무엇을 하는가: Microsoft 스토어 리포지토리를 통해 Claude Code를 설치합니다.
  • 예상 결과(예문): 설치 후 시작 메뉴에서 Claude 앱을 검색해 실행할 수 있습니다.
  • 흔한 오류: ‘winget’이 인식되지 않으면 앱 설치 관리자(WinGet)가 오래되었거나 미설치 상태입니다. Microsoft Store에서 앱 설치 관리자를 업데이트하세요.

업데이트는 자동이 아닙니다. ‘winget upgrade Anthropic.ClaudeCode’를 주기적으로 실행해 최신 상태를 유지하세요.

Windows 옵션 G: WSL 2 설치

WSL 2에서는 리눅스 도구 체인과 함께 Claude Code를 사용할 수 있습니다. 리눅스 친화적인 워크플로와 샌드박싱을 원할 때 적합합니다.

  • 1단계 명령(관리자 PowerShell): wsl –install
  • 이 명령은 무엇을 하는가: WSL 2를 활성화하고 기본 리눅스 배포판(보통 Ubuntu)을 설치합니다.
  • 예상 결과(예문): 재부팅 안내가 나오고, 재부팅 후 Ubuntu 초기 설정이 진행됩니다.
  • 흔한 오류: 회사 정책으로 WSL 설치가 차단될 수 있습니다. IT 부서 정책 확인 후 대안을 선택하세요.
  • 2단계 명령(WSL Ubuntu 셸): curl -fsSL https://claude.ai/install.sh | bash
  • 이 명령은 무엇을 하는가: 리눅스 환경에서 Claude Code를 설치합니다.
  • 예상 결과(예문): 설치 완료 후 ‘claude –version’으로 버전을 확인할 수 있습니다.
  • 흔한 오류: 네트워크 제한으로 스크립트 다운로드가 차단되면 프록시 설정이나 다른 네트워크에서 다시 시도하세요.

예문: Ubuntu 셸 프롬프트가 ‘aiden@DESKTOP:~$’로 보이면 그 안에서 macOS와 동일한 명령을 그대로 사용하면 됩니다. WSL 내부에서는 Git for Windows가 별도로 필요하지 않습니다.

Windows 옵션 H: 데스크탑 앱과 Git for Windows

데스크탑 앱은 GUI 기반으로 설정과 권한 승인이 쉬워 입문자에게 편합니다. 설치는 claude.com/download에서 진행하고, 설치 후 Claude 앱의 ‘Code’ 탭을 클릭해 시작합니다.

Windows에서는 처음 Code 탭을 열 때 Git for Windows 설치를 요구할 수 있습니다. 안내에 따라 설치한 뒤 앱을 재시작하면 됩니다. Git이 있으면 Bash 도구와 리눅스 스타일 명령을 활용할 수 있어 개발 경험이 개선됩니다.

  • 체크포인트: Git for Windows는 필수가 아닙니다. 없으면 Claude Code가 PowerShell을 셸 도구로 사용합니다.
  • 장점 요약: Git 사용이 잦거나 Bash 친화 워크플로를 선호한다면 설치를 권장합니다.
  • 흔한 오류: Git 설치 후에도 인식이 안 되면 PATH 적용을 위해 로그아웃·로그인을 하거나 재부팅하세요.

첫 로그인: 터미널에서 계정 연결

설치가 끝났다면 로그인으로 넘어갑니다. 터미널 또는 WSL 셸에서 명령 하나면 됩니다. 처음 실행 시 브라우저가 자동으로 열립니다.

  • 명령: claude
  • 이 명령은 무엇을 하는가: Claude Code 인터랙티브 모드를 시작하며, 첫 실행이면 브라우저를 열어 로그인 절차로 안내합니다.
  • 예상 결과(예문): 브라우저에서 로그인 완료 후 터미널에 ‘Successfully logged in as …’ 메시지가 출력됩니다.
  • 흔한 오류: ‘Sign in failed’가 나오면 회사 네트워크 정책으로 차단된 경우일 수 있습니다. 다른 네트워크에서 시도하거나 보안 정책을 확인하세요.

계정 종류는 Pro/Max/Team/Enterprise, Claude Console(선결제 크레딧), 그리고 회사에서 쓰는 클라우드(Bedrock/Vertex AI/Foundry) 경로가 있습니다. 세션 중 계정을 바꾸려면 ‘/login’을 입력해 다시 연결할 수 있습니다.

첫 세션 5분 따라하기

프로젝트 폴더로 이동한 뒤 Claude Code를 시작하고, 프로젝트 요약을 받아보는 순서로 연습해 봅니다. 이어서 메인 진입점을 묻고, 간단한 코드 변경까지 경험하면 흐름을 금방 익힐 수 있습니다.

  • 1단계 명령(macOS): cd ~/projects/my-app
  • 이 명령은 무엇을 하는가: 홈 디렉터리 아래 projects/my-app 폴더로 이동합니다.
  • 예상 결과(예문): 프롬프트 경로가 ‘…/projects/my-app’으로 바뀝니다.
  • 흔한 오류: ‘No such file or directory’가 나오면 폴더 경로를 실제에 맞게 수정하세요.
  • 1단계 명령(Windows PowerShell): cd $env:USERPROFILE\projects\my-app
  • 이 명령은 무엇을 하는가: 사용자 홈 아래 projects\my-app 폴더로 이동합니다.
  • 예상 결과(예문): 프롬프트 경로가 ‘C:\Users\이름\projects\my-app’으로 바뀝니다.
  • 흔한 오류: 경로에 공백이 있으면 따옴표로 감싸세요.
  • 2단계 명령: claude
  • 이 명령은 무엇을 하는가: 대화형 세션을 시작합니다.
  • 예상 결과(예문): 환영 화면이 표시되고 입력 대기 상태가 됩니다.
  • 흔한 오류: ‘command not found: claude’가 보이면 설치 후 새 셸을 열지 않은 경우입니다. 새 창을 열어 다시 시도하세요.
  • 3단계: “이 프로젝트는 뭐 하는 거야?”라고 입력합니다.
  • 예상 결과(예문): 폴더를 읽고 1~2문단으로 요약이 출력됩니다.
  • 4단계: “메인 진입점은 어디야?”라고 묻습니다.
  • 예상 결과(예문): src/index.ts 같은 파일 경로를 구체적으로 알려줍니다.
  • 5단계: “main 파일에 hello world 함수 추가해 줘.”라고 요청합니다.
  • 예상 결과(예문): 변경 계획을 보여주고 승인 여부를 묻습니다. ‘y’를 입력하면 실제 코드가 수정됩니다.
  • 6단계 종료: exit 또는 Ctrl+D
  • 이 명령은 무엇을 하는가: 현재 세션을 종료합니다.
  • 예상 결과(예문): 프롬프트가 일반 셸로 돌아옵니다.

필수 명령 요약과 예문

대화형과 단발성 작업 모두에 익숙해지면 활용 폭이 크게 넓어집니다. 아래 명령은 실무에서 가장 자주 씁니다.

  • 명령: claude
  • 이 명령은 무엇을 하는가: 인터랙티브 모드를 시작해 대화창처럼 사용합니다.
  • 예상 결과(예문): ‘/help’가 보이고 바로 질문을 입력할 수 있습니다.
  • 흔한 오류: 인증 만료 시 다시 로그인 안내가 뜹니다. 브라우저에서 재로그인하세요.
  • 명령: claude "package.json에 lint 스크립트 추가"
  • 이 명령은 무엇을 하는가: 따옴표 안 작업을 한 번 실행하고 종료합니다.
  • 예상 결과(예문): 변경 제안과 함께 수정 여부를 물으며, 승인이면 파일이 갱신됩니다.
  • 흔한 오류: 경로 권한 문제로 실패하면 관리자 권한 또는 쓰기 권한을 확인하세요.
  • 명령: claude -p "이 함수 설명"
  • 이 명령은 무엇을 하는가: 빠른 질의 모드로 결과만 받고 바로 종료합니다.
  • 예상 결과(예문): 함수의 동작 요약이 한두 문단으로 출력됩니다.
  • 흔한 오류: 폴더 맥락 필요 시 일반 ‘claude’로 전환해 대화형으로 진행하세요.
  • 명령: claude -c
  • 이 명령은 무엇을 하는가: 같은 폴더의 최근 대화를 이어갑니다.
  • 예상 결과(예문): 직전 세션의 문맥이 복원된 상태로 시작합니다.
  • 흔한 오류: 이전 대화가 없으면 새 세션이 시작됩니다.
  • 명령: claude -r
  • 이 명령은 무엇을 하는가: 이전 대화 목록에서 하나를 골라 재개합니다.
  • 예상 결과(예문): 선택한 세션의 기록을 불러와 이어서 작업합니다.
  • 흔한 오류: 목록이 길면 검색 키워드로 좁혀 선택하세요.

세션 안 슬래시 명령도 기억하세요. ‘/help’로 목록, ‘/clear’로 대화 비우기, ‘/login’으로 계정 전환을 할 수 있습니다.

권한 모드와 단축키

Claude Code는 파일 수정 전 항상 승인을 요청합니다. ‘Accept all’를 켜면 세션 동안 자동 승인되어 반복 확인을 줄일 수 있습니다.

Shift+Tab을 누르면 권한 모드가 순환됩니다. 기본 모드에서 계획 모드, 자동 승인 모드로 전환되며, 상황에 맞게 파일 변경 흐름을 제어할 수 있습니다.

입력 보조도 유용합니다. 슬래시(/)로 명령·스킬 자동완성을 열고, Tab으로 단어 자동완성을, 위쪽 화살표(↑)로 명령 히스토리를 불러와 편집하면 속도가 빨라집니다.

권한과 승인 흐름은 특히 대규모 리팩토링이나 안전이 중요한 저장소에서 도움이 됩니다. 처음에는 기본 모드로 시작해 동작을 익힌 뒤, 필요할 때 자동 승인을 사용하세요.

업데이트·제거·버전 고정 가이드

Native 설치는 백그라운드에서 자동 업데이트됩니다. 사용자가 따로 할 일 없이 최신 상태를 유지합니다. macOS 입문자에게 가장 편한 이유입니다.

Homebrew와 WinGet 설치는 자동 업그레이드가 아닙니다. macOS에서는 ‘brew upgrade claude-code’ 또는 ‘brew upgrade claude-code@latest’를, Windows에서는 ‘winget upgrade Anthropic.ClaudeCode’를 주기적으로 실행하세요.

조직 환경에서는 릴리스 채널 구성, 최소 버전 핀(특정 버전 이하 차단), 자동 업데이트 비활성, 수동 업데이트 같은 전략을 검토할 수 있습니다. 이런 구성은 공식 설정 문서의 지침을 따르는 것이 안전합니다.

제거가 필요하면 설치 방식에 맞춰 진행합니다. Homebrew는 ‘brew uninstall –cask claude-code’(또는 ‘claude-code@latest’), WinGet은 ‘winget uninstall Anthropic.ClaudeCode’를 사용합니다. Native 제거 및 설정·자격증명까지 완전 삭제는 공식 Setup 문서의 Remove configuration files 안내를 참고하세요.

자주 만나는 오류 해결

설치 직후 ‘command not found: claude’는 새 터미널 창을 열지 않아서 발생하는 경우가 많습니다. 창을 닫고 다시 열어 환경 변수를 갱신한 뒤 시도하세요.

PowerShell에서 ‘irm is not recognized’가 나오면 현재 CMD 셸에서 실행 중이라는 뜻입니다. 시작 메뉴에서 PowerShell을 검색해 실행하고 PowerShell용 명령으로 다시 시도하세요.

반대로 CMD에서 ‘The token '&&' is not a valid statement separator’가 보이면 PowerShell에서 CMD 전용 명령을 실행한 상황입니다. CMD용 창을 열어 다시 붙여넣으세요.

로그인 단계에서 ‘Sign in failed’가 연속된다면 회사 네트워크 보안 정책이 원인일 수 있습니다. 사내 정책 확인 또는 다른 네트워크로 전환한 뒤 다시 로그인하세요. ‘not supported in your region’ 메시지가 나타나면 Anthropic 지원 국가 여부를 확인해야 합니다.

자세한 트러블슈팅과 동작 방식은 공식 문서가 가장 정확합니다. code.claude.com/docs/en/quickstart와 code.claude.com/docs/en/setup를 참고하세요.

자주 묻는 질문

한국에서도 그냥 쓸 수 있나요?
사용 가능합니다. 한국은 Anthropic 지원 국가에 포함되어 정상 가입·결제·로그인이 됩니다. 설치와 로그인 절차는 본문을 따라 하면 되며, 네트워크 정책만 충족하면 바로 사용할 수 있습니다.
Pro 구독 없이 회사 API 키만으로도 되나요?
됩니다. Claude Console(선결제 크레딧) 계정으로 로그인하면 되고, 회사가 Bedrock·Vertex AI·Foundry를 쓴다면 그 경로로도 연결할 수 있습니다. 첫 로그인 시 워크스페이스가 생성되어 비용을 한곳에서 볼 수 있습니다.
Windows에서 Native와 WSL 중 무엇을 골라야 하나요?
주로 윈도우 도구만 쓴다면 Native가 편하고, 리눅스 명령이 익숙하거나 명령 격리(샌드박싱)가 필요하면 WSL 2를 권합니다. 회사 보안 정책에 따라 WSL 2가 제한되면 Native 또는 WinGet·데스크탑 앱을 고려하세요.
Git for Windows를 꼭 깔아야 하나요?
필수는 아닙니다. 설치하지 않으면 Claude Code가 PowerShell을 셸 도구로 사용합니다. 다만 Bash 기반 워크플로를 쓰거나 데스크탑 앱의 Code 탭에서 Git 연동을 원하면 설치가 편리합니다.
처음 어떤 명령부터 쳐 보면 좋나요?
프로젝트 폴더로 이동해 ‘claude’를 입력하고 “이 프로젝트는 뭐 하는 거야?”라고 물어보세요. 이어서 “메인 진입점은 어디야?”와 간단한 코드 변경 요청까지 해보면 흐름을 빠르게 익힐 수 있습니다.

참고 자료

  • Claude Code Quickstart
  • Claude Code Setup
  • Claude Desktop App Guide
본 글은 AI로 초안을 작성 후 편집자가 사실 검증·편집하였습니다.

관련 글

  • 클로드코드 프롬프트 엔지니어링 입문 가이드: 비유로 익히는 초보자 실전 예문
  • Claude가 좋다던데, 그게 Claude Code랑 같은 건가요? — AI 모델과 AI 코딩 도구의 차이 완벽 정리
  • Opus 4.8 공개 — 주목해야 할 신기능 3가지
AI 도구 Claude CodeHomebrewmacOSPowerShellWindowsWinGetWSL설치 가이드

글 탐색

Previous post
Next post

Related Posts

AI 업무 자동화 도구 선택 기준 2026년 가이드: 평가·보안·도입

2026-06-042026-06-04

요약 · AI 업무 자동화 도구 선택 기준은 2026년 기술·보안·비용 환경을 반영한 체크리스트다. 요구 정의부터…

Read More

클로드코드 프롬프트 엔지니어링 입문 가이드: 비유로 익히는 초보자 실전 예문

2026-05-312026-05-31

요약 · 클로드코드 프롬프트 엔지니어링은 Claude를 코딩 파트너로 활용하는 법과 좋은 질문 쓰기 기술의 결합입니다….

Read More

Claude가 좋다던데, 그게 Claude Code랑 같은 건가요? — AI 모델과 AI 코딩 도구의 차이 완벽 정리

2026-05-312026-05-31

요약 · 한 줄 답: Claude는 AI 모델(두뇌), Claude Code는 그 모델을 터미널에서 실행·작업하게 하는…

Read More

답글 남기기 응답 취소

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다

  • Privacy Policy
  • 개인정보처리방침
  • 문의하기
  • 운영자 소개
  • 콘텐츠 정책 및 면책
©2026 포켓인포 | WordPress Theme by SuperbThemes