클로드코드 사용법 2026: 설치, 로그인, 첫 명령 실행까지 처음 쓰는 분을 위한 단계별 안내
퀀텀점프클럽 정상록6 min read1 views클로드코드 사용법 2026: 설치, 로그인, 첫 명령 실행까지 처음 쓰는 분을 위한 단계별 안내
클로드코드: Anthropic(앤트로픽, 클로드를 만든 회사)이 만든 터미널용 AI 코딩 도구예요. 설치하고
claude라고 치면 대화창이 열리고, 하고 싶은 일을 한국어로 말하면 파일을 직접 읽고 고쳐 줍니다.
시작 전에 무엇이 필요한가요?
Claude Code(클로드코드, 터미널에서 대화하듯 지시하면 코드를 읽고 고쳐 주는 AI 도구)는 컴퓨터 사양을 크게 따지지 않아요. 공식 고급 설정 문서에 따르면 macOS 13.0 이상, Windows 10 1809 이상(또는 Windows Server 2019 이상), Ubuntu 20.04 이상, Debian 10 이상, Alpine Linux 3.19 이상에서 돌아갑니다. 메모리는 4GB 이상, 프로세서는 x64 또는 ARM64여야 하고 인터넷 연결도 필요해요. 공식 문제 해결 문서는 32비트 윈도우를 지원하지 않는다고 적어 두었습니다.
계정도 하나 필요해요. 개인이 쓰는 경로는 Pro, Max, Team, Enterprise, Console 5개 중 하나입니다. 공식 고급 설정 문서는 "무료 claude.ai 플랜에는 Claude Code 액세스가 포함되지 않습니다"라고 적어 두었어요. 회사에서 Amazon Bedrock이나 Google Cloud의 Agent Platform, Microsoft Foundry를 쓴다면 별도 경로가 있어요. 요금은 공식 요금제 페이지에서 확인해 보세요.
클로드코드 설치, 어떻게 하나요?
먼저 터미널을 엽니다. 공식 터미널 가이드는 맥에서 Cmd + Space로 Spotlight를 열어 Terminal을 입력하고, 윈도우에서는 Win + X를 눌러 Windows PowerShell(또는 Terminal)을 고르라고 안내해요. 윈도우에는 PowerShell과 CMD가 따로 있는데, 줄 앞에 PS가 보이면 PowerShell입니다. 터미널을 아예 쓰고 싶지 않다면 같은 가이드가 데스크톱 앱도 안내합니다.
설치 방법은 기본 설치, Homebrew, WinGet 세 갈래가 표준이에요. 권장은 기본 설치이고, 운영체제별 명령 3개 중 하나를 고르면 됩니다. macOS, Linux, WSL(윈도우 안에서 리눅스를 쓰는 기능)에서는 이 한 줄이에요.
curl -fsSL https://claude.ai/install.sh | bash
윈도우에서 PowerShell을 열었다면 아래 한 줄이에요.
irm https://claude.ai/install.ps1 | iex
PowerShell 대신 명령 프롬프트(CMD)를 열었다면 다음 줄을 씁니다.
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Homebrew는 brew install --cask claude-code, WinGet은 winget install Anthropic.ClaudeCode예요. 단 공식 빠른 시작 문서는 이 두 방법이 자동 업데이트되지 않는다고 적어 두었어요. 가끔 brew upgrade claude-code나 winget upgrade Anthropic.ClaudeCode를 직접 실행해 주세요.
설치가 끝나면 새 터미널 창을 열고 버전을 확인해요.
claude --version
공식 빠른 시작 문서는 "설치 프로그램이 완료되면 새 터미널 창을 열고 claude --version 을 실행하십시오. 설치가 제대로 되었으면 버전 번호가 출력됩니다"라고 안내해요. 기본 설치는 백그라운드에서 자동 업데이트돼요.
로그인은 어떻게 하나요?
작업할 프로젝트 폴더로 이동한 뒤 claude를 실행해요. 처음 쓸 때는 로그인 안내가 나오고 브라우저가 열려요.
cd /path/to/your/project
claude
/path/to/your/project는 작업하려는 폴더의 실제 경로로 바꿔야 해요. 폴더가 없으면 mkdir my-project로 하나 만들어 그 경로를 넣습니다.
개인이 쓰는 로그인 경로는 앞에서 말한 5개예요. 한 번 로그인하면 자격 증명이 저장돼 다시 로그인할 필요가 없고, 계정을 바꾸려면 창에서 /login을 칩니다.
첫 명령으로 무엇을 시켜 볼까요?
클로드코드는 에이전트(사람이 일일이 지시하지 않아도 스스로 파일을 읽고 명령을 실행하는 프로그램)예요. 그래서 "이 폴더가 무슨 프로젝트인지 설명해 줘"처럼 통째로 맡기는 요청이 잘 맞아요.
공식 빠른 시작 문서는 단계 8개로 시작을 안내하고, "도움이 되는 동료처럼 Claude와 대화하십시오. 달성하고 싶은 것을 설명하면 도움을 드릴 것입니다"라고 적었습니다. 처음에는 아래 3개 중 아무거나 골라 말해 보세요.
- 이 폴더 구조를 설명해 줘
- README에 설치 방법을 추가해 줘
- 이 파일에서 안 쓰는 코드를 찾아 줘
클로드코드가 파일을 고칠 때마다 허락을 받지는 않아요. 공식 빠른 시작 문서에 따르면 v2.1.283 이상의 대화형 터미널 세션은 자동 모드가 기본이라 대부분의 파일 편집과 명령을 묻지 않고 실행합니다. 물어보는 경우에는 "예"를 선택해 승인하고, 하나하나 확인받고 싶으면 Shift+Tab으로 권한 모드를 바꾸세요.
공식 문서도 요청을 구체적으로 쓰라고 조언해요. "버그 수정" 대신 사용자가 잘못된 자격 증명을 입력한 뒤 빈 화면을 보는 로그인 버그를 고쳐 달라는 식으로, 어떤 상황에서 생기는 문제인지까지 적어 주면 결과가 정확해집니다.
외워야 할 명령은 몇 개인가요?
터미널에서 쓰는 셸 명령 5개와, 클로드코드 창 안에서 쓰는 세션 명령 3개면 시작할 수 있어요. 먼저 터미널에서 치는 셸 명령이에요.
| 명령 | 하는 일 |
|---|---|
claude | 대화형으로 시작해요 |
claude "할 일" | 첫 요청과 함께 시작해요 |
claude -p "질문" | 한 번만 물어보고 종료해요 |
claude -c | 이 폴더의 가장 최근 대화를 이어가요 |
claude -r | 이전 대화를 다시 열어요 |
다음은 창 안에서 쓰는 세션 명령이에요.
| 명령 | 하는 일 |
|---|---|
/clear | 대화 기록을 지워요 |
/help | 쓸 수 있는 명령 목록을 띄워요 |
/exit | 종료해요 (Ctrl+D 두 번도 같아요) |
단축키는 4개만 알면 돼요. /를 입력하면 명령 목록이 뜨고, Tab으로 명령을 완성하고, ↑로 이전에 친 명령을 불러오고, Shift+Tab으로 권한 모드를 순환시켜요. 앞의 셸 명령 5개와 세션 명령 3개가 전체 목록은 아니고, 공식 문서에 전체 목록이 따로 있어요. 대화가 길어지면 /compact로 요약하고, /resume으로 이전 대화로 돌아갈 수 있어요.
처음 하면 여기서 막힙니다
처음 설치할 때 자주 걸리는 4가지를 정리했어요.
1. claude 명령을 못 찾는 경우
설치 직후 자주 나오는 질문이에요. 공식 빠른 시작 문서는 "셸에서 claude 를 찾을 수 없거나 인식되지 않는다고 표시되면 설치 디렉토리가 아직 PATH에 없는 것입니다"라고 설명해요. 설치 위치는 macOS와 Linux가 ~/.local/bin/claude, Windows가 %USERPROFILE%\.local\bin\claude.exe입니다. 먼저 새 터미널 창을 열어 보고, 그래도 안 되면 아래 두 줄을 실행해요.
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
첫 줄은 설치 위치를 PATH에 추가하고, 둘째 줄은 바뀐 설정을 지금 창에 적용해요. 리눅스에서 Bash를 쓴다면 ~/.zshrc 대신 ~/.bashrc에, 맥에서 Bash를 쓴다면 ~/.bash_profile에 넣습니다. 윈도우는 셸 설정 파일 대신 사용자 PATH 환경 변수에 %USERPROFILE%\.local\bin을 추가하고 터미널을 다시 엽니다. PATH를 고쳐도 그대로면 VS Code 확장만 설치했거나 예전 사본이 남아 충돌하는 경우일 수 있습니다.
2. 권한 오류가 나는 경우
sudo npm install -g는 쓰지 말라고 공식 고급 설정 문서가 경고해요. 권한 문제와 보안 위험이 생기기 때문이에요. 기본 설치 방법을 쓰는 게 낫습니다.
3. npm으로 설치할 때
npm 패키지는 Node.js 22 이상을 기준으로 해요. 더 낮은 버전이면 설치가 실패하는 대신 EBADENGINE 경고가 뜨고 실행은 됩니다. 기본 설치를 쓰면 Node.js가 필요 없어요.
4. 설치가 멈추거나 실패하는 경우
먼저 내가 어느 창에 있는지 봅니다. The token '&&' is not a valid statement separator가 보이면 CMD가 아니라 PowerShell에 있다는 뜻이고, 'irm' is not recognized는 그 반대예요. Claude Code does not support 32-bit Windows라는 메시지는 64비트 PC에서도 뜹니다. 시작 메뉴의 Windows PowerShell (x86) 항목이 32비트로 돌기 때문이에요. 오류가 난 창에서 [Environment]::Is64BitOperatingSystem을 실행해 True가 나오면 (x86) 없는 항목으로 다시 열고, False면 32비트 윈도우라 64비트 운영체제가 필요해요. 리눅스 서버에서 설치가 Killed로 끊기면 메모리 부족입니다. 공식 문제 해결 문서는 설치에 대략 512MB의 여유 메모리가 필요하고, 이 현상은 저용량 가상 서버에서 주로 생긴다고 적어 두었어요. 설치는 끝났는데 동작이 이상하면 터미널에서 claude doctor로 설정 문제를 점검합니다.
마무리
여기까지 따라 했다면 클로드코드 사용법의 첫 관문은 지난 거예요. 다음에는 /init(프로젝트 폴더에 CLAUDE.md라는 안내 파일을 만들어 주는 명령)을 한번 써 보세요. 클로드코드가 내 프로젝트를 이해하는 속도가 달라져요.
자주 묻는 질문
설치는 됐는데 claude 명령을 못 찾는다고 나오면 어떻게 하나요?
설치 폴더가 PATH에 없을 때 생기는 문제예요. 새 터미널 창을 먼저 열어 보고, 맥이라면 export PATH="$HOME/.local/bin:$PATH" 한 줄을 ~/.zshrc에 추가한 뒤 source ~/.zshrc를 실행하세요. 리눅스에서 Bash를 쓰면 같은 줄을 ~/.bashrc에 넣습니다. 그래도 안 되면 예전 사본이 남은 경우라, 공식 문제 해결 문서를 보세요.
무료 계정으로도 클로드코드를 쓸 수 있나요?
아니요. 공식 고급 설정 문서가 무료 claude.ai 플랜에는 Claude Code 액세스가 포함되지 않는다고 명시했어요. 개인이라면 Pro, Max, Team, Enterprise, Console 5개 중 하나가 필요하고, 회사에서 클라우드 제공자를 통해 쓰는 경로는 따로 있습니다.
npm으로 설치하려면 Node.js가 필요한가요?
npm 패키지는 Node.js 22 이상을 기준으로 하고, 더 낮으면 EBADENGINE 경고가 뜹니다. 기본 설치를 쓰면 Node.js가 필요 없으니 처음이라면 그쪽을 권해요.
설치가 중간에 멈추거나 실패하면 어떻게 하나요?
윈도우라면 PowerShell용 명령과 CMD용 명령을 바꿔 입력한 건 아닌지 먼저 보세요. 리눅스 서버에서 Killed로 끊겼다면 여유 메모리가 대략 512MB는 되는지 확인하세요. 설치가 끝난 뒤에도 이상하면 claude doctor로 점검합니다.
