클로드 코드(Claude Code) 설치 방법, 설정, 실행, 활용법

✨ 이제는 클로드 코드! 터미널 속 AI 개발 파트너를 소개합니다

개발자라면 누구나 한 번쯤 GitHub Copilot, ChatGPT, Cursor 같은 도구를 써보셨을 겁니다. 하지만 이 모든 도구들과는 전혀 다른 접근 방식으로 등장한 새로운 코딩 AI가 있습니다. 바로 **클로드 코드(Claude Code)**입니다.

이 글에서는 클로드 코드가 무엇인지, 어떻게 설치하고, 기본적으로 어떻게 사용하는지를 쉽고 친절하게 알려드리겠습니다.

 

---

🧠 클로드 코드란?

Claude Code는 Anthropic에서 개발한 터미널 기반 AI 코딩 에이전트입니다. 일반적인 AI 코딩 도우미가 "에디터 내부"에 존재하는 반면, 클로드 코드는 터미널 안에서 동작합니다. 그 자체로 독립적인 코딩 파트너이며, 기존에 사용하던 VS Code, Vim, Sublime, Xcode 등 어떤 에디터와도 충돌 없이 함께 사용할 수 있습니다.

✅ 주요 특징

• 전체 코드베이스를 분석하여 문맥을 이해하고 작업 수행
• 로컬에서 실행되어 프라이버시 보호
• 파일 수정, 명령 실행, 테스트 수행까지 가능
• 사용자 워크플로우를 자동화하는 커스텀 명령어 지원

---

⚙️ 설치 방법

1. Node.js 설치 (이미 설치되어 있다면 생략)

클로드 코드는 Node.js 환경에서 설치됩니다.

👉 Node.js 설치하기

2. 클로드 코드 설치 명령어

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

설치 후에는 다음 명령어로 실행합니다:

claude-code

---

🚀 첫 실행: 설정과 초기화

1. 터미널 입력 보조 설정

/terminal-setup

Enter 대신 Shift+Enter로 줄바꿈이 가능해져서 긴 명령어 입력이 쉬워집니다.

---

2. 프로젝트 초기화

/init

이 명령을 실행하면, claude.md 파일이 생성됩니다. 이 파일은 Claude에게 “이 프로젝트가 어떤 프로젝트인지” 알려주는 메모장 같은 역할을 합니다.

예시:

# claude.md

이 프로젝트는 Flask 기반 웹앱입니다.
- 주요 폴더: `src`, `templates`, `static`
- 코딩 스타일: snake_case
- 테스트는 pytest 사용

---

🛠️ 기본 사용법: Claude에게 질문하고 작업시키기

🔍 코드 질문하기

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

Claude는 Git 히스토리와 폴더 구조를 스스로 분석해서 대답해줍니다.

---

✍️ 코드 수정시키기

모든 함수에 docstring을 달아줘.

Claude가 코드 파일을 직접 열고 수정 제안을 합니다. 수정하려고 할 때는 항상 사용자에게 권한을 요청합니다:

• ✅ Yes – 한 번만 허용
• ✅ Yes, don't ask again – 세션 동안 계속 허용
• ❌ No – 거부하고 다른 작업을 지정

---

🧩 핵심 개념 정리

개념	설명
claude.md	Claude가 프로젝트에 대한 정보를 읽는 설명서
@파일명	Claude에게 특정 파일이나 폴더를 컨텍스트로 전달
/commands	자주 사용하는 작업을 슬래시 명령어로 자동화 가능
/permissions	명령 실행 권한을 미리 설정할 수 있음

---

🧪 실전 예시

/init

→ claude.md 생성됨
→ Claude에게 질문:

이 프로젝트 구조와 테스트 방식 설명해줘.

→ Claude가 코드 전체 분석 후 설명
→

src/app.py 파일에 로그 추가해줘.

→ Claude가 파일 수정 제안
→ 승인하면 자동으로 코드 편집 완료!

---