클로드 코드 사용법｜설치부터 첫 실행·VS Code·명령어·비용까지 초보자 가이드

 

클로드 코드 사용법 설치부터 첫 실행까지 초보자 가이드

클로드 코드 사용법을 처음 찾아보면 터미널, CLI, API, 토큰 같은 낯선 용어부터 나와 어렵게 느껴질 수 있습니다.

하지만 처음부터 개발자처럼 모든 기능을 알아야 하는 것은 아닙니다.

Claude Code는 Claude를 터미널이나 지원되는 개발환경에서 사용하면서 코드 작성, 파일 수정, 오류 분석 같은 작업을 자연어로 요청할 수 있는 AI 코딩 도구입니다.

처음 사용하는 사람이라면 설치 → 로그인 → 프로젝트 폴더에서 실행 → 작업 요청 → 변경 내용 확인 순서만 먼저 이해하면 됩니다.

이 글에서는 Claude Code가 무엇인지부터 설치, 첫 실행, 기본 명령어, VS Code 사용, 비용과 사용량까지 초보자가 실제로 필요한 내용을 순서대로 정리합니다.

클로드 코드 사용법, 먼저 이것만 알아두세요.

클로드 코드 설치 로그인 프로젝트 실행 작업 요청 변경 확인 순서

Claude Code는 단순히 채팅창에서 코드를 물어보는 방식과 조금 다릅니다.

내가 작업하는 프로젝트 환경에서 Claude에게 코드를 설명하게 하거나 파일을 수정하고 오류를 찾아달라고 요청할 수 있습니다.

예를 들어 프로젝트 폴더에서 Claude Code를 실행한 뒤 이렇게 요청할 수 있습니다.

“이 프로젝트 구조를 설명해줘.”

“오류가 나는 파일을 찾아서 원인을 설명해줘.”

“이 함수가 무슨 역할을 하는지 초보자도 이해할 수 있게 설명해줘.”

“수정하기 전에 어떤 파일을 바꿀 것인지 먼저 알려줘.”

어려운 프로그래밍 명령어만 입력하는 것이 아니라 일반적인 문장으로 작업을 요청할 수 있다는 점이 Claude Code의 중요한 특징입니다.

Claude와 Claude Code는 무엇이 다를까.

웹에서 사용하는 Claude는 질문, 글쓰기, 자료 분석, 아이디어 정리처럼 다양한 작업에 사용할 수 있습니다.

Claude Code는 그중에서도 실제 코딩 작업에 훨씬 밀접하게 연결돼 있습니다.

일반적인 질문이나 글쓰기라면 Claude 웹서비스가 편할 수 있고, 실제 프로젝트 파일을 살펴보면서 코드를 분석하고 수정하려면 Claude Code가 더 적합할 수 있습니다.

클로드 코드 설치는 어떻게 하나.

Claude Code를 사용하려면 먼저 자신의 컴퓨터 환경에 맞게 설치해야 합니다.

Windows, macOS, Linux 등 사용환경에 따라 설치방법이 달라질 수 있으므로 실제 설치할 때는 최신 Anthropic 공식 안내를 확인하는 것이 좋습니다.

설치가 끝난 뒤 터미널에서 기본적으로 다음 명령으로 시작합니다.

claude

처음 실행하면 로그인과 인증 과정이 나타날 수 있습니다.

Claude Code는 업데이트가 빠른 서비스이므로 오래된 블로그의 설치 명령을 그대로 따라 하기보다 최신 공식 문서를 기준으로 확인하는 것이 안전합니다.

클로드 코드는 어디에서 실행할까.

Claude Code는 일반적인 웹사이트처럼 브라우저 주소창에 접속해서 사용하는 방식만 있는 것이 아닙니다.

터미널에서 사용할 수 있고 지원되는 IDE와 연결해서 사용할 수도 있습니다.

예를 들어 작업하려는 프로젝트 폴더로 이동한 뒤 Claude Code를 실행하면 해당 프로젝트를 기준으로 작업을 요청할 수 있습니다.

처음에는 중요한 업무 프로젝트보다 작은 연습용 프로젝트에서 사용해보는 것이 좋습니다.

Claude가 파일을 어떻게 읽고 변경을 제안하는지를 먼저 익힌 뒤 작업 범위를 넓히는 편이 안전합니다.

처음 실행했다면 무엇을 시켜볼까.

클로드 코드 초보자 프로젝트 설명 파일 분석 오류 찾기 활용방법

첫 작업부터 “프로그램 하나 전부 만들어줘”라고 요청할 필요는 없습니다.

작은 작업부터 시작하는 것이 Claude Code의 작동방식을 익히기 쉽습니다.

예를 들어 다음과 같이 요청할 수 있습니다.

“이 폴더 구조를 설명해줘.”

프로젝트가 어떻게 구성돼 있는지 파악할 때 사용할 수 있습니다.

“이 파일을 읽고 어떤 역할을 하는지 설명해줘.”

기존 코드를 이해할 때 유용합니다.

“수정하지 말고 오류 원인만 먼저 찾아줘.”

바로 파일을 변경하는 것이 부담스럽다면 분석만 요청할 수 있습니다.

“변경하기 전에 수정할 파일과 이유를 먼저 알려줘.”

AI가 바로 작업하도록 하기보다 계획부터 확인할 수도 있습니다.

초보자에게 중요한 것은 많은 일을 한 번에 맡기는 것이 아니라 내가 확인할 수 있는 크기로 작업을 나누는 것입니다.

클로드 코드에서 자주 사용하는 명령어는.

Claude Code help model status compact clear 기본 명령어

처음부터 모든 명령어를 외울 필요는 없습니다.

몇 가지 기본 명령부터 알아두면 됩니다.

/help

사용할 수 있는 도움말을 확인할 때 이용합니다.

/model

사용할 모델을 확인하거나 변경할 때 활용할 수 있습니다.

/status

현재 계정과 사용 상태 등을 확인할 때 유용합니다.

/clear

기존 대화를 정리하고 새로운 작업을 시작할 때 사용할 수 있습니다.

/compact

대화가 길어졌을 때 기존 내용을 압축하면서 작업을 이어갈 때 사용할 수 있습니다.

API 방식으로 Claude Code를 사용하는 경우에는 /cost를 통해 현재 세션의 비용과 토큰 사용 정보를 확인할 수도 있습니다.

명령어와 기능은 업데이트될 수 있으므로 실제 사용 시점에는 공식 문서를 다시 확인하는 것이 좋습니다.

VS Code에서도 클로드 코드를 사용할 수 있을까.

가능합니다.

Claude Code는 VS Code를 비롯한 지원 개발환경과 함께 사용할 수 있습니다.

터미널 사용이 낯선 사람에게는 IDE 안에서 Claude Code를 사용하는 방식이 더 편하게 느껴질 수도 있습니다.

다만 터미널 방식과 IDE 방식은 화면과 작업 흐름이 조금 다릅니다.

자신이 평소 사용하는 개발환경에 맞춰 선택하는 것이 좋습니다.

VS Code 설치와 연결 과정은 후속 글에서 화면 흐름 중심으로 자세히 정리하겠습니다.

클로드 코드는 무료일까.

Claude Code의 이용 가능 여부와 사용량은 계정과 요금제, 인증방식에 따라 달라질 수 있습니다.

현재 Anthropic의 개인용 Pro와 Max 플랜에서는 Claude Code를 사용할 수 있습니다.

하지만 Pro와 Max는 사용량 한도가 다르기 때문에 월 구독료만 보고 선택하기보다 Claude와 Claude Code를 얼마나 자주 사용할지도 함께 보는 것이 좋습니다.

또한 Claude 구독을 이용하는 방식과 API 키를 이용해 사용량에 따라 비용을 지불하는 방식은 비용 구조가 다릅니다.

가격과 무료 사용 가능 범위는 후속 글에서 최신 공식 요금제를 기준으로 별도로 비교하겠습니다.

Claude와 Claude Code 사용량은 따로일까.

구독 플랜을 이용한다면 Claude 웹서비스와 Claude Code 사용량이 완전히 별개라고 생각하면 안 됩니다.

Claude에서 많은 작업을 한 뒤 Claude Code를 사용하거나 반대로 Claude Code에서 많은 작업을 하면 남은 사용량에 영향을 줄 수 있습니다.

또 사용량은 단순히 질문 횟수만으로 결정되지 않습니다.

대화 길이, 작업 복잡성, 사용하는 모델과 기능 등에 따라 달라질 수 있습니다.

클로드 코드 토큰 사용량은 어떻게 확인할까.

이 부분은 구독 방식과 API 방식으로 나누어 보는 것이 좋습니다.

API 키를 이용하는 사용자는 /cost 명령을 통해 현재 세션의 비용과 토큰 사용 정보를 확인할 수 있습니다.

반면 구독 플랜 사용자에게는 남아 있는 플랜 사용량을 확인하는 것이 중요합니다.

/status 명령을 사용하면 현재 계정과 사용 상태를 확인하는 데 도움이 됩니다.

즉, 사람들이 흔히 말하는 ‘토큰 확인’과 ‘내 구독 사용량 확인’은 비슷해 보여도 실제로는 다른 문제입니다.

이 부분은 후속 글에서 실제 확인 순서를 따로 정리하겠습니다.

대화가 너무 길어졌다면 어떻게 할까.

Claude Code를 오래 사용하다 보면 대화에 많은 정보가 쌓일 수 있습니다.

이때 사용할 수 있는 대표적인 명령이 /compact와 /clear입니다.

/compact는 지금까지의 내용을 압축하면서 작업을 계속할 때 활용할 수 있습니다.

/clear는 이전 대화가 더 이상 필요하지 않을 때 새로운 작업을 시작하는 데 사용할 수 있습니다.

큰 프로젝트에서는 하나의 대화에 모든 작업을 계속 쌓기보다 작업 목적이 달라졌을 때 컨텍스트를 정리하는 습관이 도움이 됩니다.

Claude Code와 Codex는 무엇이 다를까.

Claude Code를 알아보다 보면 자연스럽게 Codex나 Cursor 같은 다른 AI 코딩 도구와 비교하게 됩니다.

하지만 어느 도구가 무조건 더 좋다고 단정하기는 어렵습니다.

어떤 개발환경을 사용하는지, 기존에 어떤 AI 서비스를 구독하고 있는지, 터미널 중심으로 작업하는지 또는 IDE 중심으로 작업하는지에 따라 선택이 달라질 수 있기 때문입니다.

비교할 때는 다음 항목을 함께 보는 것이 좋습니다.

설치와 시작 난이도

지원하는 개발환경

모델과 작업방식

비용과 사용량

파일 수정과 검토 흐름

초보자 편의성

Claude Code와 Codex의 차이는 후속 비교글에서 같은 조건을 놓고 자세히 살펴보겠습니다.

클로드 코드 초보자가 주의할 점.

첫째, 중요한 프로젝트부터 바로 수정시키지 않는 것이 좋습니다.

작은 프로젝트에서 Claude가 파일을 어떻게 분석하고 변경하는지 먼저 익혀보세요.

둘째, 수정 전에 계획을 요청하는 것이 좋습니다.

“바꾸기 전에 어떤 파일을 수정할 것인지 먼저 설명해줘”라고 요청하면 작업을 검토하기 쉬워집니다.

셋째, AI가 만든 코드라고 무조건 맞다고 생각해서는 안 됩니다.

실행 결과와 변경 내용을 직접 확인해야 합니다.

넷째, 비용 구조를 확인해야 합니다.

구독 플랜으로 사용하는 것인지 API 사용량으로 과금되는 것인지 확인해야 예상하지 못한 비용을 줄일 수 있습니다.

다섯째, 긴 작업은 적절하게 나누는 것이 좋습니다.

하나의 대화에서 너무 많은 일을 계속 시키기보다 작업 목적이 달라졌다면 컨텍스트를 정리하는 것이 좋습니다.

클로드 코드 사용법 FAQ.

Q. 코딩을 잘 몰라도 Claude Code를 사용할 수 있나요?

기본적인 자연어 요청은 가능합니다.

하지만 실제 파일을 변경하거나 프로그램을 실행하는 작업에서는 코드와 개발환경에 대한 기본적인 이해가 있으면 훨씬 안전합니다.

완전 초보자라면 처음에는 코드 수정부터 시작하기보다 설명과 오류 분석부터 사용해보는 것이 좋습니다.

Q. Claude 웹사이트와 Claude Code를 동시에 사용할 수 있나요?

사용할 수 있습니다.

다만 구독 플랜에서는 Claude와 Claude Code 사용이 플랜의 사용량 한도에 함께 영향을 줄 수 있으므로 사용량을 확인하는 것이 좋습니다.

Q. VS Code에서도 사용할 수 있나요?

가능합니다.

Claude Code는 VS Code 등 지원되는 개발환경과 함께 사용할 수 있습니다.

Q. Claude Code 사용량은 어디서 확인하나요?

사용 방식에 따라 다릅니다.

구독 플랜 사용자는 /status, API 기반 사용자는 /cost를 확인하는 방식으로 접근할 수 있습니다.

Q. Claude Code와 Codex 중 무엇이 더 좋은가요?

사용 목적과 개발환경에 따라 다릅니다.

모델 성능 하나만 비교하기보다 IDE 지원, 작업방식, 비용, 사용량, 기존 구독 등을 함께 비교하는 것이 좋습니다.

처음이라면 이 순서대로 해보세요.

Claude Code를 처음 사용한다면 복잡하게 시작할 필요가 없습니다.

1. 자신의 운영체제에 맞게 Claude Code를 설치합니다.

2. Claude 계정으로 로그인합니다.

3. 작은 프로젝트 폴더에서 Claude Code를 실행합니다.

4. “이 프로젝트 구조를 설명해줘”라고 먼저 요청합니다.

5. 작은 코드 분석이나 수정 작업을 요청합니다.

6. 변경 내용을 직접 확인합니다.

7. 익숙해진 뒤 VS Code 연결이나 더 큰 프로젝트로 확장합니다.

Claude Code의 장점은 단순히 코드를 대신 만들어주는 데만 있지 않습니다.

기존 코드를 이해하고, 오류 원인을 찾고, 작업계획을 세우고, 여러 파일에 걸친 변경을 도와주는 방식으로도 활용할 수 있습니다.

처음부터 모든 기능을 배우려고 하기보다 작은 작업 하나를 직접 완료해보는 것이 가장 빠른 시작 방법입니다.

함께 보면 좋은 글.

클로드 코드 설치 방법｜Windows·Mac 설치부터 첫 실행까지

클로드 코드 가격·무료·요금제｜Pro·Max·API 비용 차이

클로드 코드 VS Code 사용법｜설치·연결·첫 작업 순서

클로드 코드 토큰 사용량 확인｜/status·/cost 차이

클로드 코드 vs Codex 비교｜초보자는 어떤 AI 코딩 도구가 맞을까

※ Claude Code의 설치방법, 지원환경, 모델, 명령어, 요금제와 사용량 정책은 업데이트될 수 있습니다. 실제 설치·결제 전 Anthropic 공식 문서에서 최신 정보를 확인하세요.