Claude Code 처음 시작하는 법 2026 — 설치부터 첫 명령어까지

설치가 어려울 것 같다는 걱정, 일단 접어두세요

Claude Code를 써보고 싶은데 막상 시작하려니 막막하다는 분들이 많습니다. 터미널이라는 단어부터 낯설게 느껴지고, 설치 과정에서 오류가 날까봐 걱정되기도 합니다.

결론부터 말하면 생각보다 훨씬 간단합니다. 명령어 한 줄로 설치가 끝나고, 설치 후 몇 가지 기본 명령어만 익히면 바로 실무에서 활용할 수 있습니다.

이 글에서는 Claude Code를 처음 시작하는 분을 위해 계정 준비부터 설치, 첫 명령어 실행까지 2026년 기준으로 단계별로 정리합니다.

시작 전 준비해야 할 것

설치를 시작하기 전에 두 가지를 먼저 확인해야 합니다.

첫 번째, Claude.ai 유료 계정

Claude Code는 무료 플랜에서 사용할 수 없습니다. Pro, Max, Teams, Enterprise 중 하나의 계정이 필요합니다. 아직 가입하지 않으셨다면 Claude.ai 공식 홈페이지에서 먼저 계정을 만들고 유료 플랜으로 업그레이드한 뒤 설치를 진행하세요.

두 번째, 운영체제 확인

Claude Code는 macOS, Linux, Windows를 공식 지원합니다. Windows 사용자는 WSL(Windows Subsystem for Linux) 환경이 필요합니다. macOS와 Linux 사용자는 별도의 사전 작업 없이 바로 설치할 수 있습니다.

macOS / Linux 설치 방법

macOS 또는 Linux 환경이라면 터미널을 열고 아래 명령어를 입력하면 설치가 완료됩니다.

curl -fsSL https://claude.ai/install.sh | bash

명령어를 입력하고 엔터를 누르면 설치가 자동으로 진행됩니다. 설치가 완료되면 터미널에 완료 메시지가 표시됩니다.

설치 후 아래 명령어로 정상적으로 설치되었는지 확인할 수 있습니다.

claude --version

버전 번호가 출력되면 설치가 정상적으로 완료된 것입니다.

Windows 설치 방법

Windows 사용자는 WSL을 먼저 설치해야 합니다. WSL은 Windows 안에서 Linux 환경을 사용할 수 있게 해주는 기능입니다.

PowerShell을 관리자 권한으로 실행한 뒤 아래 명령어를 입력합니다.

wsl --install

설치가 완료되면 컴퓨터를 재시작합니다. 재시작 후 WSL 터미널을 열고, macOS와 동일한 설치 명령어를 입력하면 됩니다.

curl -fsSL https://claude.ai/install.sh | bash

Windows 환경에서 처음 WSL을 설치하는 과정이 낯설 수 있지만, 한 번만 설정해두면 이후에는 불편함 없이 사용할 수 있습니다.

또는 PowerShell에서 직접 설치하는 방법도 있습니다.

irm https://claude.ai/install.ps1 | iex

로그인 설정

설치가 완료된 후 터미널에서 아래 명령어를 입력해 Claude Code를 실행합니다.

claude

처음 실행하면 브라우저가 자동으로 열리면서 로그인 화면이 나타납니다. Claude.ai 계정으로 로그인하면 터미널과 자동으로 연동됩니다. 로그인이 완료되면 터미널로 돌아와서 바로 사용할 수 있습니다.

브라우저가 자동으로 열리지 않는 경우에는 터미널에 표시된 URL을 복사해서 브라우저에 직접 붙여넣으면 됩니다.

첫 명령어 실행해보기

로그인이 완료되면 바로 명령어를 입력해볼 수 있습니다. 처음에는 간단한 명령어부터 시작하는 것이 좋습니다.

작업할 프로젝트 폴더로 이동한 뒤 Claude Code를 실행합니다.

cd 프로젝트폴더경로
claude

Claude Code가 실행되면 아래와 같이 간단한 명령어를 입력해보세요.

이 프로젝트의 전체 구조를 설명해줘

Claude Code가 프로젝트 폴더를 읽고 전체 구조와 주요 파일의 역할을 정리해서 보여줍니다. 처음 쓰는 분이라면 이 과정만으로도 Claude Code가 얼마나 강력한지 체감할 수 있습니다.

바로 써먹을 수 있는 기본 명령어 모음

처음 시작할 때 알아두면 유용한 기본 명령어들을 정리합니다.

프로젝트 분석

이 프로젝트의 전체 구조를 설명해줘
이 코드에서 버그가 있는 부분을 찾아줘
이 함수가 어떻게 작동하는지 설명해줘

코드 수정

이 함수에 에러 처리를 추가해줘
변수명을 더 명확하게 바꿔줘
이 코드를 리팩토링해줘

Git 작업

변경된 내용을 기반으로 커밋 메시지 작성하고 커밋해줘
현재 변경사항을 요약해줘

테스트 코드

이 함수에 대한 테스트 코드를 작성해줘
테스트를 실행하고 결과를 알려줘

문서화

이 코드에 주석을 달아줘
README 파일을 작성해줘

알아두면 유용한 슬래시 명령어

자연어 명령 외에도 슬래시(/)로 시작하는 전용 명령어를 사용할 수 있습니다.

/clear       # 대화 기록 초기화 (토큰 절약에 중요)
/help        # 사용 가능한 명령어 목록 확인
/status      # 현재 계정 상태와 사용량 확인
/exit        # Claude Code 종료

이 중에서 /clear는 특히 자주 쓰게 됩니다. 대화가 길어지면 컨텍스트가 누적되어 응답 속도가 느려지고 토큰 소비가 늘어납니다. 큰 작업을 마치거나 새로운 작업으로 넘어갈 때 /clear를 입력하는 습관을 들이면 비용을 절약하고 응답 품질을 유지할 수 있습니다.

처음 시작할 때 흔히 겪는 문제

claude 명령어를 입력했는데 찾을 수 없다고 나온다

설치 후 터미널을 재시작하지 않아서 생기는 문제입니다. 터미널을 완전히 닫고 다시 열어서 시도해보세요. 그래도 해결되지 않는다면 설치가 정상적으로 완료되지 않은 것이므로 설치 명령어를 다시 실행해보세요.

브라우저가 자동으로 열리지 않는다

터미널에 표시된 로그인 URL을 복사해서 브라우저에 직접 입력하면 됩니다.

로그인은 됐는데 응답이 없다

네트워크 연결 상태를 확인하고, /clear를 입력한 뒤 다시 시도해보세요. 그래도 해결되지 않는다면 claude 명령어로 Claude Code를 재시작해보세요.

마무리

Claude Code 설치와 첫 실행은 생각보다 훨씬 간단합니다. 명령어 한 줄로 설치하고, 로그인하고, 프로젝트 폴더에서 자연어로 명령을 입력하면 바로 시작할 수 있습니다.

처음에는 간단한 명령어부터 시작해서 점차 복잡한 작업으로 넓혀가는 것을 권장합니다. 사용하면 할수록 어떤 명령어가 효과적인지 감이 잡히고, 그때부터 생산성이 눈에 띄게 달라집니다.

다음 글에서는 Claude Code를 Windows 환경에서 설치하는 방법을 WSL 설정부터 첫 실행까지 더 자세하게 정리해드리겠습니다.

다음 글 예고: Claude Code Windows 설치 방법 2026 — WSL 없이도 되나? 완전 가이드

6번 글로 바로 이어서 작성할까요? “네”라고 답해주시면 진행하겠습니다.