Claude Code 사용법

요즘 핫한 Claude Code를 프로젝트에 적용해 보자 🧐

 

Claude Code는 터미널 레벨에서 작동하기 때문에 IDE가 무엇이든지 상관없다. IntelliJ나 WebStome과 같은 Jetbrains 툴들로도 사용이 가능하다.

 

Claude Code를 사용하고 싶다면 최소한 Pro 플랜이어야 한다.

 

https://www.anthropic.com/pricing

위 경로에서 결제를 진행해 주도록 하자. 😎

1. NodeJS 설치

Claude Code를 사용하기 위해선 NodeJS가 설치되어야 한다.

https://nodejs.org/ko/download

Node.js — Node.js® 다운로드

위 경로에 방문해서 다음과 같이 설치해 주도록 하자.

# nvm 다운로드 및 설치:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# Node.js 다운로드 및 설치:
nvm install 22

# Node.js 버전 확인:
node -v # "v22.19.0"가 출력되어야 합니다.
nvm current # "v22.19.0"가 출력되어야 합니다.

npm 버전 확인:
npm -v # 10.9.3가 출력되어야 합니다.

 

2. Claude Code 설치

NodeJS가 설치되었다면 Claude Code를 설치해 주도록 하자.

// sudo 를 이용해서 설치하면 보안 위험 및 권한 문제가 발생할 수 있으므로 sudo 사용하지말고 해야함!!
npm install -g @anthropic-ai/claude-code

 

주의할 점은 sudo 명령어를 사용하지말고 설치를 진행해야 한다는 점이다.

sudo를 통해 설치하게 되면 보안 위험 및 권한 문제가 발생할 수 있다.

 

설치가 되었다면 아래의 명령어를 통해 정상적으로 설치가 되었는지 확인한다.

claude doctor

정상적으로 설치가 된 모습

"Enter"를 눌러 진행하도록 한다.

 

3. Claude Code 사용하기

정상적으로 Claude Code가 설치되었다면 Claude Code를 사용해 보자.

Claude Code를 사용하고 싶은 프로젝트 경로로 이동해 아래 명령어를 실행하자. (만약 새로운 프로젝트에 Claude Code를 적용하고 싶다면 새롭게 경로를 만들어 주자)

claude

정상적으로 실행됐다면 터미널에서 사용할 테마를 골라준다. 본인은 Dark Mode (colorblind-friendly)로 골랐음.

테마를 고르고 난 후엔 간단하게 폴더 경로 권한 관련 허용 여부 등 간단한 절차가 진행된다.

 

클로드 코드가 프로젝트에 정상적으로 적용된 모습

 

정상적으로 Claude Code가 프로젝트에 적용되었다면 아래 명령어를 통해 프로젝트에 적용하도록 하자.

/init

 

위 명령어를 실행하면 CLAUDE.md 파일을 어떤 식으로 생성하겠다고 안내해 준다.

CLAUDE.md는 Claude가 프로젝트를 이해하고 작업할 때 참조하는 프로젝트 컨텍스트 파일로, 프로젝트의 목적, 구조, 주요 기능에 대한 설명을 제공한다. 또한 Claud가 코드베이스를 빠르게 파악할 수 있도록 돕는 가이드 역할을 하게 된다.

 

CLAUDE.md에는

- 사용 중인 기술 스택, 프레임워크, 라이브러리 정보

- 프로젝트의 아키텍처와 디자인 패턴

- 중요한 설정이나 환경 변수에 대한 설명

- 코딩 스타일이나 컨벤션 등등

을 포함하고 있다.

 

결국 CLAUDE.md 파일을 잘 작성해 두면 Claude가 프로젝트의 맥락을 더 잘 이해하고, 더 적절한 코드 제안과 수정을 할 수 있다고 한다.

추후 CLAUDE.md 파일을 잘 작성할 수 있는 요령에 대한 글도 다뤄보겠습니다. 😊

 

생성할 CLAUDE.md 파일을 확인했다면 "Yes"를 선택하고 진행해 준다.

 

위의 과정들이 진행이 됐다면 그대로 Claude Code에 원하는 내용을 입력하고 이용하면 된다!

4. IDE와의 연동

앞서 말했듯 Claude Code는 터미널 레벨에서 사용할 수 있다. 다만 터미널 레벨에서 사용할 경우, 몇 가지 불편한 점이 있다.

Cursor, Windsurf와 같은 VSCode 기반의 IDE를 사용하게 되면 Claude Code와 간편하게 연동을 할 수 있는데, Claude Code와 연동을 하게 되면 Claude에게 원하는 부분을 드래그해서 알려준다거나, Claude Code로부터 수정할 파일을 포커싱해서 제공받는다거나 하는 편리함을 얻을 수 있다.

 

본 글에선 Cursor와 연동해 본다.

 

Extension에서 Claude Code for VSCode를 검색 후 install 해주자.

 

설치가 되었다면 프로젝트 경로에서 아래 명령어를 실행해 준다.

/ide

 

위의 명령어를 실행하면 Claude Code Extension이 설치된 Cursor가 선택지로 노출이 되게 되는데, 선택 후 "Enter"를 눌러 진행해 준다.

 

Claude Code와 IDE가 정상적으로 연동된 모습

Claude Code와 Cursor가 정상적으로 연동되었다면 IDE 우측 상단에 Claude의 아이콘이 노출되게 된다.

해당 아이콘을 눌러 사용할 수 있다.

5. Claude Code의 모델 선택하기

Claude에는 현시점 기준으로 Sonnet 4와 Opus 4.1을 제공한다.

Sonnet 4의 경우 일상적인 사용에 적합하고 Opus 4.1의 경우 복잡한 작업을 위한 대형 모델을 제공한다고 한다.

 

다만 Claude Pro Plan의 경우 Sonnet 4의 모델밖에 제공하지 않으니 Opus 모델을 사용하고 싶은 경우 Max Plan을 결제해야 한다. 😭

 

아래 명령어를 통해 제공하는 모델을 확인하자

/model

Pro Plan은 Sonnet만 제공하는 모습

6. 다양한 옵션들

클로드 코드는 아래 공식 문서를 통해 다양한 명령어를 확인할 수 있다.

https://docs.anthropic.com/en/docs/claude-code/slash-commands

Slash commands - Anthropic

 

 

또한 Claude Code의 커맨드를 확인하고 싶다면 여느 라이브러리들과 마찬가지로 아래 명령어를 통해 확인할 수 있다.

/help

7. Permissons 사용하기

Claude Code에선 4가지의 Permission mode를 제공하는데 default, acceptEdits, plan, bypassPermissions가 있다.

 

1. default 모드

Claude Code에서 기본적으로 적용되는 모드로, 각 도구를 처음 사용할 때마다 사용자에게 권한 승인을 요청한다. 안전한 기본 모드로, 모든 작업에 대해 명시적인 사용자 동의를 필요로 한다.

새로운 프로젝트나 민감한 코드베이스에서 작업할 때 권장한다고 한다.

 

2. accpetEdits(비추)

세션동안 파일 편집 권한을 자동으로 승인한다.

파일 수정/생성 작업은 자동 허용하지만, 다른 시스템 도구는 여전히 승인을 필요로 한다. 주로 빠른 개발을 할 때 사용하지만 나도 모르게 파일이 수정, 생성될 수 있으니 권장하지 않는다.

 

3. plan(추천)

Claude가 분석은 할 수 있지만 파일을 실제로 수정하거나 명령어를 실행하지 않는다.

일기 전용 모드로, Claude에게 명령을 하면 어떤 절차로 명령을 수행할 것인지 먼저 보여준 후 승인을 요청한다. 마치 미리보기와 같은 기능을 제공한다고 볼 수 있다.

 

4. bypassPermissions

모든 권한을 건너뛰고 자동으로 모든 작업을 허용한다. 가장 자유로운 모드지만 안전한 환경에서만 사용할 것을 권장한다.

빠른 프로토타이핑이 가능하지만, 높은 리스크가 동반되기 때문에 프로덕션 환경에선 권장하지 않는다.

 

Claude Code의 Permissions는 shift + tab을 통해 변경할 수 있으니 변경해 사용해 보길 바란다.