Claude Code 사용법: 설치, 로그인, 첫 코딩 작업

공식 설치, 브라우저 로그인, 내 저장소의 검토 가능한 첫 변경. 무료 플랜으로는 쓸 수 없다.

Claude Code 첫 한 시간이 막히는 지점은 프롬프트 문장이 아니라 설치 명령, 계정 등급, 검토할 수 있는 첫 diff다. 공식 문서대로 설치하고 로그인한 뒤, 내 저장소에서 작은 한 가지를 끝낸다.

검색어는 Claude Code 설치와 사용법이다. 근거는 공식 설치·인증 페이지와 code.claude.com/docs/en/quickstart다. 무료 Claude.ai에는 Claude Code가 없다. diff를 짧은 허들에서 보려면 wbmeet에서 방을 만들고 방 만들기와 참가를 본다.

설치로그인저장소의 한 일

실행 조건을 먼저 고정한다

공식: macOS 13.0+, Windows 10 1809+ 또는 Windows Server 2019+, Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+, RAM 4 GB, x64 또는 ARM64, 인터넷, Anthropic 지원 국가. 데스크톱 앱도 있으나 이 페이지는 터미널 CLI만 쓴다.

4 GB
공식 RAM 하한
0
무료 플랜 접근
1
브라우저 로그인

첫 한 시간: 설치, 로그인, 검토 가능한 변경

  1. 1

    공식 네이티브 설치

    macOS, Linux, WSL: curl -fsSL https://claude.ai/install.sh | bash. Windows PowerShell: irm https://claude.ai/install.ps1 | iex. 프롬프트에 PS가 있으면 PowerShell, 없으면 CMD이므로 install.cmd. brew install --cask claude-code 또는 winget install Anthropic.ClaudeCode도 있다. 네이티브는 백그라운드 업데이트. Homebrew와 WinGet은 수동.

  2. 2

    버전을 확인한 뒤 세션

    새 터미널에서 claude --version. 예: 2.1.211 (Claude Code). 실패하면 claude doctor. macOS/Linux 런처는 ~/.local/bin/claude. command not found는 먼저 PATH, 다음 공식 Troubleshoot installation.

  3. 3

    프로젝트 디렉터리에서 로그인

    내 저장소로 cd하고 claude. 첫 실행은 브라우저. ANTHROPIC_API_KEY가 있으면 키 승인만 한 번. 브라우저가 안 열리면 표시된 URL을 복사. 성공 시 Login successful. 세션의 /login으로 전환, /logout으로 로그아웃.

  4. 4

    검토 가능한 첫 코딩 작업

    「이 프로젝트는 무엇을 하나? 진입점은 어디인가?」 이어서 「테스트 없는 헬퍼에 단위 테스트를 추가하거나 공개 함수에 입력 검증을 추가하라. diff를 먼저 보여라.」 공식 quickstart와 같은 두 박자. Shift+Tab으로 권한 모드. 비밀을 프롬프트에 쓰지 말 것.

# Official native install · as of 2026-09
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
claude --version
cd /path/to/your/project
claude
# first task (inside the session)
# 1) what does this project do and where is the entry point?
# 2) add a unit test for one untested helper; show the diff first

계정, 설치 경로, 함정

경로공식 서술첫 주의
무료 Claude.aiClaude Code 없음상위 플랜 또는 Console
Pro / Max / Team / Enterprise브라우저 로그인권장 구독 경로
Console API선불. Claude Code workspace 생성사용량을 본다. 무제한 아님
네이티브 install.sh / .ps1권장. 백그라운드 업데이트새 터미널에서 claude
Homebrew / WinGet기본 자동 업데이트 없음brew upgrade / winget upgrade
01

설치했는데 command not found

대개 PATH다. 옛 창을 닫고 새 터미널을 연다. 그래도 안 되면 claude doctor와 공식 Troubleshoot installation and login.

02

PowerShell과 CMD를 섞음

&&는 PowerShell에서 문장 구분자가 아니다. irm은 CMD에 없다. 프롬프트가 PS일 때만 irm.

03

첫 작업이 잡담으로 끝남

「이 저장소는 무엇인가」는 준비일 뿐이다. 단위 테스트, 검증, 지명한 작은 버그 중 하나를 diff와 함께 끝낸다.

공식 quickstart: 코드베이스를 이해한 뒤 실제 편집을 맡긴다. 명령과 계정 등급은 code.claude.com/docs가 원본이다.

네이티브 ≠ Homebrew 자동 업데이트
네이티브는 백그라운드에서 갱신한다. Homebrew claude-code는 안정 채널로 대략 일주일 늦다. brew upgrade claude-code가 필요하다.
Windows 네이티브 ≠ WSL 필수
PowerShell 또는 CMD에서 설치할 수 있다. Bash 도구에는 Git for Windows가 권장된다. 없으면 PowerShell 도구. Linux 툴체인이나 샌드박스가 필요할 때만 WSL 2.
이 페이지는 회의 설명서가 아니다
Claude Code 첫 한 시간만 다룬다. 짧은 허들과 보드는 wbmeet. 무거운 회의 앱을 열지 않는 판단은 이 메모.

더 확인할 질문

무료 Claude.ai로 Claude Code를 쓸 수 있나?

없다. 공식 설치 페이지는 무료 플랜에 포함되지 않는다고 쓴다. Pro, Max, Team, Enterprise 또는 Console이 필요하다.

설치 후 command not found가 뜨면?

새 터미널에서 claude --version. 실패하면 claude doctor. PATH에 공식 런처(macOS/Linux는 흔히 ~/.local/bin)가 있는지 본다.

Windows에서는 어떤 설치 명령인가?

PS C:\이면 PowerShell irm … | iex. PS 없는 C:\이면 install.cmd. 섞지 말 것.

첫 작업이 반드시 프로덕션 코드를 고쳐야 하나?

아니다. 공식은 먼저 프로젝트가 무엇을 하는지 물어도 된다고 한다. 이어서 되돌릴 수 있는 한 가지(테스트나 검증)를 부탁하고 diff를 먼저 읽는다. 비밀을 붙이지 말 것.

무료로 회의 시작