Claude Code(클로드 코드) 사용법 정리

 

Claude Code(클로드 코드) 사용법 정리

CLI 기반 AI 코딩 도구, 이렇게 쓰면 진짜 편하다

오늘은 요즘 제가 자주 쓰고 있는 **Claude Code(클로드 코드)**에 대해 정리해보려고 합니다.

AI 코딩 도구가 워낙 많아진 요즘이지만,
Claude Code는 단순한 코드 자동완성 도구라기보다는
**“개발자를 대신해 실제 작업을 수행하는 에이전트”**에 더 가깝다고 느꼈습니다.

이번 글에서는

• Claude Code가 어떤 도구인지
• 기본적인 사용법
• 그리고 실제로 쓰면서 도움이 됐던 고급 활용 팁까지
  한 번에 정리해보겠습니다.

---

Claude Code란?

Claude Code는 Anthropic에서 만든 터미널 기반 AI 개발 도구입니다.
IDE에 플러그인으로 얹혀서 쓰는 방식이 아니라,
**CLI(명령줄 인터페이스)**에서 직접 실행하는 형태입니다.

이 방식의 장점은 명확합니다.

• git, bash, 테스트 도구에 제약 없이 접근 가능
• 프로젝트 전체를 탐색하면서 작업 수행
• 로컬 환경에서만 실행되어 보안적으로도 안정적

단순히 “코드 한 줄 추천”이 아니라,
👉 코드 수정 → 테스트 → 커밋 → 리뷰까지
하나의 작업 흐름을 통째로 맡길 수 있습니다.

---

Claude Code로 이런 요청이 가능합니다

Claude Code는 자연어 명령을 이해합니다.
예를 들면 다음과 같은 요청들이 가능합니다.

• 프로젝트 구조 설명해줘
• 메인 파일에 hello world 함수 추가해줘
• 변경 사항을 의미 있는 커밋 메시지로 커밋해줘
• 내가 수정한 코드 리뷰하고 개선점 알려줘

이 모든 요청을 프로젝트 전체 컨텍스트를 이해한 상태에서 처리합니다.

---

Claude Code 설치 & 실행하기

1️⃣ 설치

npm install -g @anthropic-ai/claude-code

2️⃣ 프로젝트 디렉토리로 이동

cd your-project

3️⃣ Claude Code 실행

claude

Claude Code는 터미널이 있는 모든 IDE에서 문제없이 동작합니다.
IntelliJ, WebStorm 같은 JetBrains 계열 IDE를 사용 중이라면
전용 플러그인을 함께 사용하면 Diff 확인이나 컨텍스트 공유가 훨씬 편해집니다.

---

처음이라면 반드시 /init

프로젝트에서 Claude Code를 처음 사용하는 경우,
가장 먼저 /init을 실행하는 것을 추천합니다.

/init

이 명령을 실행하면 Claude Code가:

• 프로젝트 구조 분석
• 기술 스택 파악
• 주요 명령어 정리
• CLAUDE.md 파일 생성

까지 자동으로 진행합니다.

---

CLAUDE.md는 왜 중요한가?

CLAUDE.md는 Claude Code에게

“이 프로젝트에서는 이렇게 일해라”

라고 알려주는 최상위 규칙 파일입니다.

• 프로젝트 구조
• 코드 스타일
• 금지 사항(main 브랜치 직접 커밋 금지 등)

같은 내용을 여기에 적어두면,
Claude Code는 프롬프트보다 이 규칙을 우선적으로 따릅니다.

📌 참고로
~/.claude/CLAUDE.md에 작성하면
모든 프로젝트에 공통 규칙으로 적용할 수도 있습니다.

---

권한 요청이 번거롭다면?

Claude Code는 기본적으로
파일 수정이나 커밋 시마다 권한을 물어봅니다.

이 과정이 번거롭다면 다음 옵션으로 실행할 수 있습니다.

claude --dangerously-skip-permissions

⚠️ 이름 그대로 위험할 수 있으니
개인 프로젝트나 신뢰 가능한 환경에서만 사용하는 것을 권장합니다.

---

Claude Code 실사용 팁

✔ 새로운 작업 전에는 /clear

/clear

이전 대화 컨텍스트를 정리해서
Claude Code가 현재 작업에만 집중하도록 도와줍니다.

---

✔ 특정 파일을 명확히 지정할 때는 @

@src/components/Button.tsx 이 파일을 리팩토링해줘

이렇게 하면 엉뚱한 파일을 수정하는 일이 줄어듭니다.

---

✔ 여러 작업은 한 번에 쌓아두기

analyze current project
optimize performance by refactoring
run and fix failed tests

Claude Code는 요청을 순차적으로 처리합니다.

---

✔ 개행 입력

• Shift + Enter
• 안 될 경우 /terminal-setup
• 또는 Ctrl + J

---

✔ 작업 내용을 기억시키고 싶을 땐 #

# 이 프로젝트에서는 테스트 없는 PR을 만들지 말 것

→ CLAUDE.md에 기록되어 이후 작업에 반영됩니다.

---

고급 활용 ① 커스텀 명령어 만들기

반복 작업이 많다면
커스텀 Slash 명령어를 만들어두면 정말 편합니다.

프로젝트 전용 명령어

mkdir -p .claude/commands

전역 명령어

mkdir -p ~/.claude/commands

예시

echo "Review this code for security issues" \
> ~/.claude/commands/security-review.md

이제 Claude Code에서

/security-review

만 입력해도 실행됩니다.

---

고급 활용 ② 서브 에이전트(Subagents)

Claude Code는 특정 작업을
전문화된 서브 에이전트에게 위임할 수 있습니다.

예를 들어:

• 코드 리뷰 전문 에이전트
• 리팩토링 전문 에이전트
• 보안 점검 전문 에이전트

생성은 /agents 명령어를 통해 가능합니다.

Use the code-reviewer subagent to review my changes

---

고급 활용 ③ 작업 완료 알림 (macOS)

Claude Code는 비동기적으로 작업을 진행하기 때문에
작업 완료 시 알림을 받으면 편합니다.

pip install claude-notify

.claude/settings.json에 Hook을 추가하면
작업이 끝났을 때 macOS 시스템 알림을 받을 수 있습니다.

---

SuperClaude: 고급 사용자용

SuperClaude는 Claude Code를
프레임워크처럼 확장해주는 도구입니다.

• 코드 분석
• 기능 구현
• 테스트
• 문서화
• 커밋 자동화

등을 명령어 하나로 처리할 수 있습니다.

다만 토큰 사용량이 많아지기 때문에
큰 작업이나 반복 작업 위주로 사용하는 걸 추천합니다.

---

정리

Claude Code를 사용하면서 느낀 점을 정리해보면 이렇습니다.

• 단순한 AI 코딩 도구가 아니다
• “코드를 대신 치는 도구”가 아니라
  “개발 작업을 대신 수행하는 파트너”에 가깝다
• CLAUDE.md와 커스텀 명령어를 잘 쓰면 생산성이 크게 올라간다

앞으로 개발자의 역할은
코드를 직접 많이 치는 사람보다는,
AI가 만든 결과를 검토하고 방향을 잡는 사람으로
점점 바뀌어 갈 것 같다는 생각도 들었습니다.

Claude Code는 그 변화를 가장 잘 보여주는 도구 중 하나라고 느꼈습니다.

---