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만 쓴다.
첫 한 시간: 설치, 로그인, 검토 가능한 변경
- 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
버전을 확인한 뒤 세션
새 터미널에서
claude --version. 예:2.1.211 (Claude Code). 실패하면claude doctor. macOS/Linux 런처는~/.local/bin/claude.command not found는 먼저 PATH, 다음 공식 Troubleshoot installation. - 3
프로젝트 디렉터리에서 로그인
내 저장소로
cd하고claude. 첫 실행은 브라우저.ANTHROPIC_API_KEY가 있으면 키 승인만 한 번. 브라우저가 안 열리면 표시된 URL을 복사. 성공 시 Login successful. 세션의/login으로 전환,/logout으로 로그아웃. - 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.ai | Claude Code 없음 | 상위 플랜 또는 Console |
| Pro / Max / Team / Enterprise | 브라우저 로그인 | 권장 구독 경로 |
| Console API | 선불. Claude Code workspace 생성 | 사용량을 본다. 무제한 아님 |
| 네이티브 install.sh / .ps1 | 권장. 백그라운드 업데이트 | 새 터미널에서 claude |
| Homebrew / WinGet | 기본 자동 업데이트 없음 | brew upgrade / winget upgrade |
설치했는데 command not found
대개 PATH다. 옛 창을 닫고 새 터미널을 연다. 그래도 안 되면 claude doctor와 공식 Troubleshoot installation and login.
PowerShell과 CMD를 섞음
&&는 PowerShell에서 문장 구분자가 아니다. irm은 CMD에 없다. 프롬프트가 PS일 때만 irm.
첫 작업이 잡담으로 끝남
「이 저장소는 무엇인가」는 준비일 뿐이다. 단위 테스트, 검증, 지명한 작은 버그 중 하나를 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를 먼저 읽는다. 비밀을 붙이지 말 것.