Claude Code 사용법 — 터미널 속 AI 에이전트 설치부터 핵심 명령어까지

터미널 창에서 한 발짝도 나가지 않고 코딩, 테스트, 깃 커밋까지 전부 알아서 해주는 AI 에이전트가 있다면 어떨까요? 요즘 개발자들 사이에서 가장 뜨거운 도구인 클로드 코드 이야기입니다. 매번 웹브라우저에 코드를 복사해서 붙여넣는 번거로움 없이, 터미널 안에서 곧바로 강력한 AI 비서를 부리는 방법을 기초부터 깔끔하게 정리해 드립니다.

1단계: 구형 npm 대신 네이티브 설치 파일로 3초 만에 끝내기

클로드 코드를 시작하는 가장 빠르고 확실한 방법입니다. 혹시 예전 가이드를 보고 npm 명령어로 설치하려 하셨나요? 이제 자동 업데이트를 지원하는 네이티브 설치가 지원됩니다. 앤트로픽은 구형 npm 패키지 형태의 설치보다, 운영체제별로 최적화된 네이티브 설치 파일을 새롭게 공식 권장하고 있습니다.

네이티브 설치 방식은 까다로운 개발 환경 설정이나 노드 의존성 문제없이 터미널에서 명령어 한 줄만 실행하면 바로 끝납니다. 게다가 백그라운드에서 자동으로 업데이트까지 알아서 처리해 주니 항상 최신 버전을 유지할 수 있어 아주 편리합니다.

터미널을 열고 내 컴퓨터 운영체제에 맞는 명령어를 복사해서 실행해 보세요.

# macOS, 리눅스, WSL 사용자
curl -fsSL https://claude.ai/install.sh | bash

# 윈도우 파워셸 사용자
irm https://claude.ai/install.ps1 | iex

설치를 마친 뒤 터미널에 claude를 입력하면 안전하게 연동되는 웹 브라우저 창이 열립니다. 사용 중인 클로드 프로 멤버십이나 개발자 콘솔 계정으로 로그인을 완료하면 터미널 안에서 곧바로 똑똑한 에이전트를 부릴 수 있습니다.

작업 능률을 올려주는 핵심 슬래시(/) 명령어 활용법

클로드 코드를 터미널에서 실행하고 나면, 챗봇 웹사이트와는 다른 독특한 인터랙티브 환경을 만나게 됩니다. 이때 가장 유용한 비밀무기가 바로 슬래시로 시작하는 단축 명령어들입니다. 이 명령어들을 적재적소에 활용하면 AI가 사용하는 토큰 소비를 줄이고 터미널 작업 속도를 효율적으로 끌어올릴 수 있습니다.

가장 먼저 손에 익혀야 할 핵심 명령어는 대화가 길어질 때 발생하는 컨텍스트 누적과 비용 문제를 해결해 주는 도구들입니다.

여기에 더해, 세션 중간에 모델을 즉시 전환할 수 있는 /model 명령어까지 알아두면 좋습니다. 탐색이나 간단한 작업에는 비용이 저렴한 모델을 쓰고, 복잡한 로직 구현에는 고성능 모델로 유연하게 스위칭하면서 스마트하게 비용을 아낄 수 있습니다.

나의 프로젝트 규칙 정의서, CLAUDE.md 파일 만드는 법

클로드 코드의 진짜 매력은 새로운 대화를 시작할 때마다 "이 프로젝트는 리액트 기반이고, 코딩 규칙은 이렇고..."라며 구구절절 설명할 필요가 없다는 점입니다. 프로젝트 루트 디렉터리에 CLAUDE.md 파일 하나만 저장해 두면 됩니다. 클로드 코드가 세션을 시작하자마자 이 규칙을 먼저 읽고 내 코딩 스타일과 프로젝트 아키텍처 규칙을 준수할 수 있도록 합니다.

이 규칙 파일을 직접 처음부터 작성할 필요는 없습니다. 터미널 창에 단 한 줄의 명령어만 입력하면 바로 시작할 수 있습니다.

/init

이 명령어를 실행하면 클로드 코드가 내 작업 공간에 있는 기술 스택, 폴더 구조, 패키지 설정 등을 스스로 꼼꼼하게 분석합니다. 그리고 내 프로젝트에 가장 어울리는 맞춤형 CLAUDE.md 기본 규칙 파일을 자동으로 뚝딱 만들어 줍니다.

자동 생성된 규칙 파일은 개발자가 읽기에도 편하고 직관적인 마크다운 구조로 이루어져 있습니다.

# Project Rules

## Build & Test Commands
- Build: `npm run build`
- Run tests: `npm test`

## Code Style
- Use TypeScript for all new components.
- Follow camelCase for variables and PascalCase for components.
- Prefer functional components over class components.

여기서 유용한 활용 팁이 있습니다. 다른 설정 파일의 구체적인 내용을 학습시키고 싶다면 마크다운 안에서 @package.json처럼 @ 기호를 사용해 손쉽게 외부 문서를 불러올 수 있습니다. 만약 프로젝트 규모가 커져서 규칙이 너무 복잡해진다면 .claude/rules/ 폴더 아래에 개별 파일로 분할해 일관되게 관리할 수도 있습니다. 이렇게 잘 만든 규칙 파일 하나만 준비해 두면, 클로드 코드가 언제나 나와 오랫동안 손발을 맞춰온 단짝 파트너처럼 내 마음에 쏙 드는 코드를 작성해 줍니다.

권한 모드와 디렉터리 접근 차단으로 안전하게 사용하기

클로드 코드는 내 컴퓨터의 터미널 권한을 직접 제어하는 강력한 에이전트입니다. 편리한 만큼 보안 설정을 제대로 이해하고 안전하게 사용하는 습관이 무엇보다 중요합니다. 특히 인터넷에서 다운로드한 외부 깃 저장소를 열어서 작업할 때는 각별히 주의해야 합니다.

과거 구버전 클로드 코드에서는 CVE-2025-54794나 CVE-2026-55607 같은 보안 취약점이 발견된 적이 있습니다. 악의적으로 구성된 외부 프로젝트를 클론해 실행하면, 클로드 코드가 경로 조작에 속아 프로젝트 폴더를 벗어나 시스템 내부의 민감한 파일에 접근하거나 쉘 설정 파일에 위험한 코드를 심어 실행하도록 유도할 수 있는 보안 문제였습니다.

앤트로픽은 이러한 취약점을 발견하는 즉시 빠르게 패치 버전을 배포해 해결하고 있습니다. 우리가 구형 npm 방식 대신 자동 업데이트를 지원하는 최신 네이티브 설치 방식을 사용해야 하는 이유가 바로 여기에 있습니다. 네이티브 설치본은 백그라운드에서 실시간으로 보안 업데이트를 적용하므로 항상 안전한 최신 상태를 유지해 줍니다.

클로드 코드는 작업 방식에 따라 세부 권한을 조정할 수 있도록 여섯 단계의 권한 모드를 지원합니다. 내 프로젝트의 안전을 지키기 위해 꼭 알아두어야 할 핵심 모드들을 쉽게 정리해 드릴게요.

마지막으로 개인 비밀번호나 API 키가 담긴 .env 같은 비밀 환경 설정 파일의 유출을 막는 팁이 있습니다. 사용자 설정 파일에서 특정 중요 파일에 대한 접근을 제한하는 차단 규칙을 등록해 두면, 클로드 코드가 실수로 상위 디렉터리를 탐색해 민감한 데이터를 읽는 상황을 완벽하게 예방할 수 있습니다. 아무리 뛰어난 AI 비서라도 내 컴퓨터의 열쇠를 쥐어주는 만큼, 항상 신뢰할 수 있는 안전한 디렉터리 안에서만 실행하는 습관을 들여 보세요!

터미널에서 직접 부리는 든든한 AI 파트너

웹 브라우저를 오가며 코드를 복사하고 붙여넣던 번거로운 방식은 이제 안녕입니다. 터미널 창을 벗어나지 않고도 코딩부터 테스트, 커밋까지 물 흐르듯 이어지는 클로드 코드의 편리함을 직접 경험해 보세요. 오늘 바로 내 프로젝트 폴더에서 가볍게 시작해 보시는 건 어떨까요?