클로드 코드(Claude Code) 비개발자 입문서 — 설치, 영어 해석, 자주 쓰는 명령어

"설치라니 어려워 보이는데……"

그렇게 생각하고 미뤄 두고 있는 사람을 위해 정리한 내용이다. Claude Code 셋업은 생각보다 전혀 어렵지 않다. 할 일은 3단계뿐이고, 걸리는 시간은 10분도 안 된다.

이 장에서는 macOS을 기준으로 설명한다. Windows에서도 기본 흐름은 똑같다.

미리 준비할 것

Anthropic 계정 (Claude.ai에서 쓰던 계정이 있으면 그대로 사용한다)
API 키 (뒤에서 설명한다)

2025년 10월부터는 Node.js 없이 바로 설치되는 네이티브 설치 방식이 공식 권장 방법이다.

macOS/Linux 설치

터미널에서 아래를 실행한다.

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

Windows 설치

PowerShell을 열어서 이거 실행한다. 관리자 권한이 없어도 된다.

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

예전엔 윈도우에서 WSL이 거의 필수였는데, 지금은 네티이브로 그냥 돌아간다. 다만, Git for Windows는 깔아두는 걸 권한다. 없어도 PowerShell로 동작은 한다.

설치 확인

설치가 끝나면 터미널을 새로 열고 아래 명령어로 확인한다.

claude --version
claude doctor      # PATH나 설정 문제 진단

예전엔 윈도우에서 WSL이 거의 필수였는데, 지금은 네티이브로 그냥 돌아간다. 다만, Git for Windows는 깔아두는 걸 권한다. 없어도 PowerShell로 동작은 한다.

API키로 사용하기

Claude Code를 쓰려면 Subscription 인증 또는 Anthropic의 API 키가 필요하다.

API 키란 "이 사용자가 Claude Code를 쓸 권한을 갖고 있습니다"라는 인증용 문자열을 말한다.

발급 방법:

console.anthropic.com 접속
계정 생성·로그인
"API Keys" 메뉴에서 "Create Key"
표시된 sk-ant-...로 시작하는 문자열을 복사해 둔다

⚠️ 이 API 키는 절대 남에게 보여서는 안 된다. 비밀번호와 똑같이 취급한다. GitHub 등에 업로드하는 코드 안에 적어서도 안 된다.

API 키 설정:

터미널에서 아래를 실행한다(your-key-here 부분을 자신의 키로 바꾼다).

export ANTHROPIC_API_KEY=your-key-here

매번 터미널을 열 때마다 설정하기 번거롭다면 .zshrc(macOS 설정 파일)에 추가해 두면 계속 유지된다. 이런 건 Claude Code에 "API 키를 계속 유지하고 싶어"라고 물어보면 방법을 알려 준다.

요금 안내: Claude Code는 쓴 만큼 과금되는 종량제다. 한 달 $5~20 정도가 일반적인 사용량의 기준이다. 처음에는 $5어치 크레딧부터 시작해 보는 걸 추천한다. API로 처음에 사용하는 것을 추천하는 이유는 비용적인 부분 때문이다.

그외에도 Claude.ai 유료 구독(Pro, Max)계정으로 로그인해서 쓰는 것도 가능하다. 유료 구독으로 사용중인 독자라면 API크리딧을 따로 충전하지 않아도 구독 범위에서 쓸 수 있다.

실행해서 첫 대화 나누기

터미널에서 아래를 실행한다.

claude

이게 전부다. 화면이 바뀌고 대화할 수 있는 상태가 된다.

시험 삼아 한국어로 말 걸어 보자.

오늘 날짜 알려줘

날짜가 돌아오면 Claude Code가 돌아가고 있는 것이다.

다음으로 실제 파일 조작을 시험해 보자. 바탕화면에 테스트 파일을 만들어 달라고 해 본다.

바탕화면에 test.txt라는 파일을 만들고, "Claude Code 잘 돌아갑니다"라고 써 줘.

바탕화면을 확인해 보자. test.txt가 생겼고 그 안에 "Claude Code 잘 돌아갑니다"라고 적혀 있으면 성공이다.

이게 Claude Code의 기본 동작이다. "파일을 실제로 만들 수 있다." — 이게 보통의 AI 채팅과의 결정적 차이다.

잘 안될 때 체크리스트

command not found: claude라고 나온다 → Node.js 설치가 안 끝났거나 터미널을 재시작하지 않은 경우다. 터미널을 닫았다 다시 열고 재시도.

Invalid API key라고 나온다 → API 키 복사 실수가 많다. 공백이나 줄바꿈이 섞이지 않았는지 확인한다.

아무 반응이 없다 → Enter 키를 눌렀는지 확인. Ctrl+C로 한 번 취소하고 재시도한다.

정리

셋업 흐름은 이게 전부다.

네이티브 설치
클로드 사용이 처음인 경우, API 키 발급받아 설정 또는 유료 구독
claude로 실행
한국어로 말 걸기

"생각보다 쉬웠네"라는 느낌이 들었다면, 그게 맞는 감상이다.

다음 장에서는 Claude Code에게 말 거는 요령을 설명한다. 한국어로 어떻게 부탁하면 잘 움직이는지 알면, 쓸 수 있는 범위가 단숨에 넓어진다.

이메일문의: jaewoo@claudecode.to

Koding 프로필: https://koding.kr/u/jaewoo.kim2019

Jaewoo Kim by AI-fluent liberal arts Engineer

#AI기업교육 #AI에이전트개발교육 #클로드코드기업교육 #클로드코드교육 #AX전환 #ClaudeCode교육 #AI #LLM #엔지니어 #개발자 #Claude #ClaudeCode

2.Claude Code 입문 — 2. 5분 만에 끝내는 초보 셋업 가이드 (macOS·Windows)