클로드 코드

클로드 코드 시작 가이드, 설치부터 실전까지 순서대로

처음이라면 도구를 고르고, 실행한 뒤 작은 체크리스트 하나를 만들어 보세요. 클로드 코드(Claude Code)는 요청을 받아 프로젝트 파일을 만들고 수정하는 도구입니다. 이 페이지에서 지금 필요한 안내만 골라 시작할 수 있습니다.

시작 전에 개인 Pro·Max 구독 또는 Console의 사용량 과금 등 이용 조건을 확인하세요. Skills·MCP 같은 확장 기능은 첫 실습을 마친 뒤 필요할 때 배워도 됩니다.

지금 어디에서 막혔나요?

실습 결과가 궁금하면 이미 완성된 체크리스트를 먼저 눌러 볼 수 있습니다. 실제 도구 확인과 공식 자료 조사 범위는 각 글에 표시했습니다.

설치하기

설치 뒤 Claude Code가 실행되고 첫 요청을 보낼 수 있는지 확인합니다. 걸리는 시간은 운영체제·계정·설치 오류 여부에 따라 달라집니다.

  • 맥 사용자는 클로드 코드 맥 설치부터 시작한다. 터미널을 처음 여는 사람 기준으로 명령어 입력부터 로그인까지 순서대로 정리했다.
  • 설치하다 막혔다면 설치 파일·PATH·중복 설치·인증 확인 순서에서 내 증상을 찾으면 됩니다. 다른 오류는 공식 문제 해결 문서와 함께 확인합니다.
  • 윈도우 설치 가이드는 준비 중이다. 먼저 공식 윈도우 설치 안내에서 내 환경에 맞는 방법을 확인한다.
  • 개인은 Pro·Max 구독이나 사용량에 따라 비용을 내는 Console 계정으로 시작할 수 있다. 회사 계정은 Team·Enterprise의 이용 권한을 확인한다. 관리자 비밀번호를 묻는 화면이 나올 수 있으니 내 컴퓨터 비밀번호는 알고 시작하자.

이 단계에서 가장 흔한 함정은 오류 메시지를 보고 멈추는 것이다. 빨간 글씨가 나오면 겁먹지 말고 그 메시지를 그대로 복사해 두자. 오류 해결 글에서 같은 메시지를 찾으면 대부분 해결되고, 없으면 그 메시지를 AI에게 그대로 붙여 넣고 물어보는 게 다음 수다. 설치 완료 기준은 하나다. 터미널에 claude를 입력했을 때 대화 화면이 뜨면 끝난 것이다.

도구 고르기

같은 클로드 코드라도 쓰는 창이 3가지다. 터미널(명령어 창), 데스크톱 앱(일반 프로그램처럼 생긴 창), 코딩 도구 확장. 어느 쪽이 맞는지부터 정하면 헤매지 않는다.

도구는 나중에 바꿔도 된다. 계정과 사용량은 공유되니, 데스크톱 앱으로 시작했다가 익숙해지면 터미널로 넘어가는 경로가 자연스럽다. 여기서 고르는 건 첫 도구지 평생 도구가 아니다. 판단이 어려우면 기준 하나만 기억하자. 검은 화면에 거부감이 없으면 터미널, 있으면 데스크톱 앱이다.

이미 Cursor를 구독하다가 도구를 옮기면서 기존 결제도 정리하려면 커서 AI 구독 취소와 Hobby 전환에서 구독을 정리하는 순서와 환불 확인 범위를 살펴본다.

기본 설정과 사용법

강의나 책을 고르는 중이라면 클로드 코드 강의·책 3단계 학습 순서에서 공식 무료 과정의 차이와 한국어 책을 볼 시점을 확인한다.

설치 직후에 한국인 사용자가 거의 반드시 만나는 벽이 2개 있다. 답변이 영어로 나오는 것과, 한글 입력이 어색한 것이다. 이 단계에서 잡고 가면 이후가 편하다.

이 단계의 함정은 명령어를 외우려고 하는 것이다. 외울 필요 없다. 기본 사용법 글에서 소개하는 몇 개만 알면 나머지는 AI에게 물어보면 되고, 물어보는 것 자체가 이 도구의 사용법이다.

이 단계가 끝나면 한국어로 요청하고 한국어로 답을 받는 나만의 작업 환경이 갖춰진다. CLAUDE.md는 뒤의 실전 단계에서 진가가 나오니 지금은 이름만 기억해 둬도 충분하다.

비용 알아보기

남은 한도나 날짜별 토큰이 궁금하다면 클로드 코드 사용량 확인에서 /usage 화면과 ccusage 조회 순서를 확인한다. 예상 비용과 추가 청구를 구분하는 방법도 다룬다.

개인은 Pro·Max 구독 또는 사용량에 따라 비용을 내는 Console 계정으로 클로드 코드를 쓸 수 있다. 구독으로 사용하면 대화형 클로드와 사용량 한도를 공유한다. API 결제는 구독과 별도다.

  • 결제 전 무료 사용 범위부터 궁금하다면 클로드 코드 무료 여부와 결제 전 확인할 4가지에서 설치 가능 여부와 실제 계정 권한을 구분한다.
  • 클로드 코드 요금제 해부: 개인용 Pro부터 회사 도입까지, 하루 사용 시간과 작업 성격 기준으로 어느 요금제가 맞는지 정리했다. 구독료 말고 따로 붙을 수 있는 비용도 다뤘으니 결제 전에 한 번 읽어두면 예상 밖 청구를 피할 수 있다.

감을 먼저 잡고 싶다면 기준은 사용 시간이다. 가볍게 배우는 단계라면 Pro로 충분하고, 매일 몇 시간씩 만들기 시작하면 한도가 아쉬워진다. 그 시점이 오기 전까지는 상위 요금제를 미리 결제할 이유가 없다. 이 가이드 기준으로는 일단 Pro로 시작해서 첫 실습을 한 번 마친 뒤에 판단해도 충분하다.

첫 실습 후 필요할 때 확장하기

기본기가 잡히면 확장 기능으로 쓰임새가 넓어진다. 서두를 필요는 없고, “이런 것도 됐으면 좋겠는데”라는 순간이 올 때 돌아오면 된다.

MCP를 붙이면 달라지는 걸 하나만 예로 들면, 브라우저 조작 서버를 연결한 뒤에는 “이 페이지 열어서 확인해 줘” 같은 요청이 통한다. 확장은 이렇게 “AI가 닿는 범위”를 넓히는 일이라, 필요한 순간이 오기 전에 미리 다 붙여둘 이유는 없다. MCP 추천 글에서 3개만 고른 이유도 같다. 처음부터 여러 개를 붙이면 문제가 생겼을 때 어디서 났는지 찾기 어려워진다.

실전 프로젝트

블로그를 운영하는 작업까지 이어가고 싶다면 클로드 코드 블로그 자동화에서 실제로 연결한 단계와 사람이 확인하는 지점을 볼 수 있다.

배운 걸로 실제 결과물을 만들 차례다. 실전을 한 번 거치면 앞 단계의 지식이 전부 연결된다.

  • 바이브코딩으로 워드프레스 블로그 만들기: 클로드 코드로 블로그를 서버 준비부터 발행까지 만든 7편 시리즈다. 지금 보고 있는 이 블로그가 그 결과물이라, 구축 순서와 운영 중 확인할 일을 함께 볼 수 있다.
  • 코딩이라는 개념 자체부터 잡고 싶다면 바이브코딩 시작 가이드가 더 넓은 출발점이다. 첫 프로젝트로 체크리스트 앱을 만들고 배포하는 과정까지 이어진다.

프로젝트를 고르는 기준은 “내가 매주 쓰게 될 것”이다. 남에게 보여주기 좋은 것보다 내가 계속 쓰는 걸 만들어야 고치게 되고, 고치는 과정에서 실력이 는다. 실전에서 막히는 건 정상이고, 막힌 화면을 캡처해서 AI에게 보여주는 게 해결의 기본기다. 대부분의 막힘은 앞 단계 글(설치 오류·한글·사용법) 중 하나로 돌아가면 풀린다.

클로드 구독과 문서 작업

자주 묻는 질문

코딩을 전혀 몰라도 시작할 수 있나?

시작할 수 있다. 이 가이드의 글은 전부 비개발자 기준으로 쓰였다. 처음에는 작은 작업을 요청하고 결과를 확인하는 데서 출발한다. 파일 변경·명령 실행·비용이 생기는 단계는 무엇을 허용하는지 확인하며 진행한다.

무료로 써볼 수 있나?

무료 Claude 계정에는 Claude Code가 포함되지 않는다. 유료 구독과 별도로, Console 계정에 API 사용 요금을 결제하는 방법도 있다. 결제 전에 감을 잡고 싶다면 무료 범위의 클로드 대화창에서 아티팩트 기능으로 간단한 결과물을 만들어 보는 게 가장 가깝다. 비용 구조는 요금제 해부에서 판단 기준과 함께 정리했다.

뭐부터 읽어야 할지 모르겠다.

처음이면 위의 도구 비교와 설치 안내를, 실행이 되면 첫 체크리스트 실습을 고르면 된다. 문제가 생겨서 검색으로 들어왔다면 설치 오류 글과 한글 문제 글이 증상별 해결을 담당한다.

글 순서대로만 하면 되나?

모든 글을 읽고 시작할 필요는 없다. 위에서 막힌 지점에 해당하는 글을 고르면 된다. 회사 도입을 검토한다면 비용과 계정 권한을 먼저 확인하고, 확장 기능은 필요한 작업이 생겼을 때 읽으면 된다.