클로드 코드(Claude Code) 명령어 가이드

안녕하세요. 아가릿입니다. 클로드 코드 명령어에 대해서 정리한 내용 공유드립니다.

📖 개요

클로드 코드는 터미널에서 직접 사용할 수 있는 AI 기반 코딩 도구입니다. 자연어로 요청하면 코드를 작성하고, 버그를 수정하고, 프로젝트를 분석해줍니다.

🚀 설치 및 시작하기

설치 방법

# NPM을 통한 설치 (권장)
npm install -g @anthropic-ai/claude-code

# 네이티브 인스톨러 사용 (최신 방법)
curl -fsSL https://claude.ai/install.sh | bash

첫 실행

# 프로젝트 디렉토리에서 실행
cd your-project
claude

# 첫 실행 시 로그인 필요 (자동으로 안내)

반응형

클로드코드 단축키

 

🎯 기본 명령어

대화형 모드

명령어	설명	예시
claude	대화형 모드 시작	claude
claude "요청"	초기 프롬프트와 함께 시작	claude "이 프로젝트를 설명해줘"
/login	다시 로그인	/login
/help	도움말 보기	/help

비대화형 모드 (SDK 모드)

명령어	설명	예시
claude -p "요청"	한 번의 요청 후 종료	claude -p "이 함수를 설명해줘"
cat 파일 | claude -p "요청"	파이프로 내용 전달	cat logs.txt | claude -p "에러 분석해줘"

세션 관리

명령어	설명	예시
claude -c	가장 최근 대화 이어가기	claude -c
claude -c -p "요청"	비대화형으로 대화 이어가기	claude -c -p "타입 에러 확인해줘"
claude -r "세션ID" "요청"	특정 세션 재개	claude -r "abc123" "이 PR 완성해줘"

🛠️ 주요 플래그 옵션

권한 관리

플래그	설명	예시
--allowedTools	허용할 도구 지정	claude --allowedTools "Bash(git:*)" "Write"
--disallowedTools	금지할 도구 지정	claude --disallowedTools "Bash(rm:*)"
--dangerously-skip-permissions	권한 확인 건너뛰기 (위험)	claude --dangerously-skip-permissions

출력 형식

플래그	설명	예시
--output-format text	텍스트 형식 (기본값)	claude -p --output-format text
--output-format json	JSON 형식	claude -p --output-format json
--output-format stream-json	스트리밍 JSON	claude -p --output-format stream-json

기타 유용한 옵션

플래그	설명	예시
--add-dir	추가 작업 디렉토리 지정	claude --add-dir ../apps ../lib
--max-turns	최대 턴 수 제한	claude -p --max-turns 3
--model	모델 선택	claude --model opus
--verbose	상세 로그 출력	claude --verbose

 

 

💡 슬래시 명령어 (대화형 모드 내에서)

기본 슬래시 명령어

명령어	설명
/help	사용 가능한 명령어 목록
/login	로그인/재로그인
/logout	로그아웃
/clear	대화 기록 지우기
/allowed-tools	도구 권한 설정
/plan	계획 모드 활성화 (읽기 전용)

커스텀 슬래시 명령어

프로젝트별 또는 개인별로 커스텀 명령어를 만들 수 있습니다.

프로젝트 명령어 생성

# .claude/commands/ 폴더에 생성
mkdir -p .claude/commands
echo "이 코드의 성능을 분석하고 최적화 방안을 제안해줘:" > .claude/commands/optimize.md

# 사용법: /optimize

개인 명령어 생성

# ~/.claude/commands/ 폴더에 생성
mkdir -p ~/.claude/commands
echo "보안 취약점을 검토해줘:" > ~/.claude/commands/security-review.md

# 사용법: /security-review

 

🔧 설정 관리

설정 명령어

명령어	설명	예시
claude config	설정 보기	claude config
claude config set	설정 값 변경	claude config set key value
claude config set -g	전역 설정 변경	claude config set -g key value

환경 변수

주요 환경 변수들:

• ANTHROPIC_API_KEY: API 키 설정
• CLAUDE_CODE_ENABLE_TELEMETRY: 텔레메트리 활성화
• CLAUDE_CODE_USE_BEDROCK: AWS Bedrock 사용
• CLAUDE_CODE_USE_VERTEX: Google Vertex AI 사용

 

📁 파일 및 디렉토리 참조

@ 기호로 파일 포함

# 파일 내용 직접 포함
claude -p "@myfile.py 이 파일을 분석해줘"

# 디렉토리 목록 포함
claude -p "@./src/ 이 디렉토리 구조를 설명해줘"

# MCP 리소스 포함
claude -p "@server:resource MCP 데이터 분석해줘"

 

 

🤖 MCP (Model Context Protocol) 서버

MCP 서버 관리

명령어	설명	예시
claude mcp	MCP 서버 관리 메뉴	claude mcp
claude mcp add	MCP 서버 추가	claude mcp add my-server -- /path/to/server
claude mcp list	MCP 서버 목록	claude mcp list
claude mcp remove	MCP 서버 제거	claude mcp remove my-server

💼 실무 활용 예시

1. 코드베이스 이해하기

claude "이 프로젝트의 구조를 분석하고 주요 기능을 설명해줘"

2. 버그 수정하기

claude "Payment API에서 500 에러가 발생하고 있어. 원인을 찾아서 수정해줘"

3. 코드 리팩토링

claude -p "이 함수를 더 효율적으로 리팩토링해줘" --allowedTools "Write,Read"

4. 테스트 작성

claude "이 컴포넌트에 대한 유닛 테스트를 작성해줘"

5. 문서화

claude "이 API 엔드포인트에 대한 문서를 작성해줘"

 

 

🔄 업데이트 및 유지관리

업데이트

# 최신 버전으로 업데이트
claude update

# 설치 상태 확인
claude doctor

마이그레이션

# 네이티브 인스톨러로 마이그레이션
claude migrate-installer

⚠️ 주의사항

1. 권한 관리: 중요한 파일이나 명령어에 대해서는 항상 권한을 확인하세요
2. 비용 관리: API 사용량에 따라 비용이 발생할 수 있습니다
3. 보안: 민감한 정보가 포함된 파일은 .env 등을 통해 제외하세요
4. 백업: 중요한 변경사항은 Git으로 커밋하여 백업하세요

🆘 문제 해결

문제가 발생하면:

1. claude doctor 실행하여 설치 상태 확인
2. claude --verbose 옵션으로 상세 로그 확인
3. 공식 문서 참조
4. 지원 센터 문의

---

이 가이드를 통해 클로드 코드를 효과적으로 활용하시길 바랍니다.