# Claude Code 설치
npm install -g @anthropic-ai/claude-code

# 버전 확인
claude --version

# Windows 사용자
wsl  # WSL 진입
npm install -g @anthropic-ai/claude-code

curl -sL https://install.anthropic.com | sh

# 대화형 REPL 시작
claude

# 초기 실행 시 API 키 입력 요구
# 또는 환경 변수 설정
export ANTHROPIC_API_KEY="your-api-key"

# 기본 실행
claude

# 초기 프롬프트와 함께 시작
claude "이 프로젝트를 요약해줘"

# 프린트 모드 (실행 후 종료)
claude -p "이 함수를 설명해줘"

# 가장 최근 대화 계속하기
claude -c

# Claude Code 설치
npm install -g @anthropic-ai/claude-code

# 대화형 REPL 시작
claude

# 초기 프롬프트와 함께 시작
claude "summarize this project"

# 버전 확인
claude --version

# 업데이트
claude update

/help          # 도움말 및 사용 가능한 명령어 표시
/exit          # REPL 종료
/clear         # 대화 기록 초기화
/config        # 설정 패널 열기
/doctor        # Claude Code 설치 상태 확인

# 프린트 모드 - 실행 후 종료
claude -p "explain this function"

# 파이프를 통한 입력 처리
cat logs.txt | claude -p "explain"

# 최근 대화 계속하기
claude -c

# SDK를 통한 계속
claude -c -p "Check for type errors"

# ID로 세션 재개
claude -r "abc123" "Finish this PR"

# 플래그를 통한 재개
claude --resume abc123 "query"

# 대화 계속
claude --continue

# 모델 전환
claude --model sonnet                    # Sonnet 모델 사용
claude --model opus                      # Opus 모델 사용
claude --model claude-sonnet-4-5-20250929  # 특정 버전 사용

# 대화 중 모델 전환
/model                                   # 모델 선택기 열기

# 추가 작업 디렉토리 지정
claude --add-dir ../apps ../lib

# 경로 검증
claude --add-dir /path/to/project

# 다양한 출력 형식
claude -p "query" --output-format json
claude -p "query" --output-format text
claude -p "query" --output-format stream-json

# 입력 형식
claude -p --input-format stream-json

# 대화 턴 수 제한
claude -p --max-turns 3 "query"

# 상세 로깅
claude --verbose

# 세션 비용 및 시간
/cos                      # 총 비용 및 시간 표시

# 프롬프트 없이 특정 도구 허용
claude --allowedTools "Bash(git log:*)" "Bash(git diff:*)" "Write"

# 특정 도구 차단
claude --disallowedTools "Bash(rm:*)" "Bash(sudo:*)"

# 특정 도구에 대한 권한 프롬프트
claude -p --permission-prompt-tool mcp_auth_tool "query"

# 모든 권한 프롬프트 건너뛰기 (위험)
claude --dangerously-skip-permissions

/compact [instructions]   # 선택적 지침으로 대화 요약
/clear                    # 대화 기록 및 컨텍스트 재설정
/exit                     # REPL 종료
/help                     # 사용 가능한 명령어 표시
/config                   # 설정 패널 열기

/doctor                   # 설치 상태 확인
/cos                      # 현재 세션의 비용 및 시간 표시
/ide                      # IDE 통합 관리
/context                  # 컨텍스트 윈도우 정보 확인
/stats                    # 세션 통계 확인

# MCP 서버 설정
claude --mcp

# MCP 관리 (slash 명령어를 통해)
/mcp                      # MCP 기능 접근

# 복잡한 파이핑 작업
git log --oneline | claude -p "summarize these commits"
cat error.log | claude -p "find the root cause"
ls -la | claude -p "explain this directory structure"

# 스크립팅을 위한 JSON 출력
claude -p "analyze code" --output-format json

# 실시간 처리를 위한 스트림 JSON
claude -p "large task" --output-format stream-json

# 배치 처리
claude -p --max-turns 1 "quick query"

# .claude/commands/에 사용자 정의 명령어 생성
# 예: .claude/commands/debug.md
/debug                    # 사용자 정의 debug 명령어 실행
/test                     # 사용자 정의 test 명령어 실행
/deploy                   # 사용자 정의 deploy 명령어 실행

# 고급 도구 권한
claude --allowedTools "Bash(git:*)" "Write" "Read" \
       --disallowedTools "Bash(rm:*)" "Bash(sudo:*)"

# 다중 디렉토리 접근
claude --add-dir ../frontend ../backend ../shared

# 성능을 위한 컨텍스트 제한
claude -p --max-turns 5 "focused query"

# 컨텍스트 정기적 초기화
/clear                    # 작업 간 더 나은 성능을 위해 사용

# 대화 압축
/compact "keep only important parts"

# 복잡한 모델 및 도구 설정
claude --model claude-sonnet-4-5-20250929 \
       --add-dir ../apps ../lib ../tools \
       --allowedTools "Bash(git:*)" "Write" "Read" \
       --verbose \
       --output-format json

#!/bin/bash
# 스크립트화된 Claude 상호작용
claude -p "analyze codebase" --output-format json > analysis.json
claude -p "generate tests" --max-turns 3 --output-format text > tests.txt

# 세션 ID 관리
SESSION_ID=$(claude -p "start analysis" --output-format json | jq -r '.session_id')
claude -r "$SESSION_ID" "continue analysis"

# 다단계 자동화
claude -p "analyze project structure" | \
claude -p "suggest improvements" | \
claude -p "create implementation plan"

#!/bin/bash
# 자동화된 PR 리뷰 프로세스
git diff HEAD~1 | claude -p "review this PR for security issues" > security_review.md
git diff HEAD~1 | claude -p "check for performance issues" > performance_review.md
git diff HEAD~1 | claude -p "suggest improvements" > improvements.md

# CI/CD 파이프라인 통합
claude -p "analyze test coverage" --output-format json | jq '.coverage_percentage'
claude -p "generate release notes from commits" --max-turns 2 > RELEASE_NOTES.md

# 다중 파일 처리
find . -name "*.js" -exec claude -p "analyze this file for bugs: {}" \; > bug_report.txt

# 자동화된 문서 생성
for file in src/*.py; do
    claude -p "generate docstring for $file" --output-format text >> docs.md
done

# VS Code 통합
/ide vscode                # VS Code 통합 설정
/ide configure             # IDE 설정

# 사용자 정의 IDE 명령어
claude --ide-mode "explain selected code"
claude --ide-mode "refactor this function"

# Git hooks 통합
claude -p "create pre-commit hook for code quality" > .git/hooks/pre-commit

# 고급 Git 작업
git log --oneline -10 | claude -p "create changelog from these commits"
git diff --name-only | claude -p "explain what changed in this commit"

# 데이터베이스 통합
mysql -e "SHOW TABLES" | claude -p "analyze database structure"

# Docker 통합
docker ps | claude -p "analyze running containers"
docker logs container_name | claude -p "find errors in logs"

# 메모리 사용 최적화
claude -p --max-turns 1 "quick analysis"      # 효율성을 위한 단일 턴
claude -p --compact-mode "analyze with minimal context"

# 리소스 모니터링
/cos                       # 현재 세션 비용 확인
/doctor --performance      # 성능 진단
/stats                     # 세션 통계

# 효율적인 세션 재사용
claude -c "continue previous analysis"         # 기존 컨텍스트 재사용
claude --cache-results "repetitive task"      # 일반 작업 캐싱

# 병렬 처리
claude -p "task 1" & claude -p "task 2" & wait  # 병렬 실행

# 대규모 코드베이스를 효율적으로 처리
claude --add-dir . --max-context 50000 "analyze entire project"
claude --stream-output "process large dataset" | head -100

# 공유 팀 설정
claude --config-file team-config.json "standardized analysis"

# 팀 세션 공유
claude -r "team-session-id" "continue team discussion"

# 프로덕션 준비 설정
claude --production-mode \
       --security-enabled \
       --audit-logging \
       --max-turns 10 \
       "production analysis"

# 보안 중심 작업
claude --disallowedTools "Bash(rm:*)" "Bash(sudo:*)" "Bash(chmod:*)" \
       --audit-mode \
       --no-external-calls \
       "secure code review"

# 감사 및 컴플라이언스
claude --audit-log /var/log/claude-audit.log "compliance check"
claude --compliance-mode "analyze for security compliance"

# 사용 예시
"파일 구조를 분석해줘"
"이 프로젝트에서 인증 로직을 찾아줘"

# Plan 모드 진입
Shift+Tab (2번)

# 사용 예시
"이 기능을 구현하기 위한 계획을 세워줘"

# 사용 예시
"API를 리팩토링하고 테스트를 업데이트해줘"
"데이터베이스 스키마를 변경하고 마이그레이션을 작성해줘"

# Subagent 메뉴 열기
/agents

# [Create New Agent] 선택
# 프로젝트 레벨 또는 사용자 레벨 선택

# 위치: .claude/agents/<agent-name>.md

# 위치: ~/.claude/agents/<agent-name>.md

# Claude가 description을 분석하여 자동 선택
"이 코드를 리뷰해줘"  # code-reviewer 자동 호출

# description에 트리거 키워드 포함 권장
# "PROACTIVELY use", "MUST use"

# @ 기호로 명시적 호출
@code-reviewer "최근 변경사항 검토"
@debugger "이 에러 조사: [에러메시지]"
@test-runner "테스트 실패 분석"

# 명시적 호출의 장점
# - 예측 가능
# - 디버깅 용이
# - 프로덕션 환경에 적합

@debugger "이 에러를 조사해줘"
# 디버거가 작업을 완료할 때까지 대기

@test-runner "테스트 실행"
# 백그라운드에서 실행되는 동안 다른 작업 계속

# CLI 플래그 사용
claude --disallowedTools "Task(code-reviewer)"

# 여러 Subagent를 병렬로 실행하고 결과 수집
"@code-reviewer와 @security-auditor를 동시에 실행하여 
이 PR을 검토하고 결과를 통합해줘"

# 오케스트레이터가 작업을 할당하고 결과 검토
"계획을 세우고, 각 단계를 적절한 에이전트에게 위임한 후,
결과를 검토하여 최종 보고서를 작성해줘"

# Subagent를 순차적으로 체인
@code-reviewer "코드 검토" 
# 결과를 받은 후
@optimizer "발견된 성능 문제 최적화"

❌ 나쁜 예:
"코드 리뷰해줘"  # 자동 위임, 예측 불가

✅ 좋은 예:
"@code-reviewer 최근 변경사항 검토"  # 명시적, 예측 가능

# .claude/plugins/team-agents/plugin.json
{
  "name": "team-agents",
  "version": "1.0.0",
  "agents": [
    "agents/code-reviewer.md",
    "agents/test-runner.md"
  ]
}

# GitHub Actions 워크플로우
# .github/workflows/claude-review.yml

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
        with:
          fetch-depth: 0
      
      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'
      
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      
      - name: Run Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          git diff origin/main...HEAD | \
          claude -p "이 PR을 검토하고 다음 JSON 형식으로 결과를 반환하세요:
          {
            \"summary\": \"전체 요약\",
            \"security_issues\": [],
            \"performance_issues\": [],
            \"suggestions\": []
          }" \
          --output-format json > review.json
      
      - name: Post Review Comment
        uses: actions/github-script@v6
        with:
          script: |
            const review = require('./review.json');
            const comment = `## 🤖 Claude Code Review\n\n${review.summary}`;
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: comment
            });

# test-generator.sh
#!/bin/bash

# 테스트가 없는 파일 찾기
files_without_tests=$(find src -name "*.js" -type f | while read file; do
  test_file="${file/src/tests}"
  test_file="${test_file/.js/.test.js}"
  if [ ! -f "$test_file" ]; then
    echo "$file"
  fi
done)

# 각 파일에 대한 테스트 생성
echo "$files_without_tests" | while read file; do
  claude -p "이 파일에 대한 포괄적인 유닛 테스트를 생성하세요:
  
  $(cat $file)
  
  다음을 포함하세요:
  1. 정상 케이스
  2. 엣지 케이스
  3. 에러 케이스
  4. 목(mock) 필요시 Jest 사용
  
  파일명: ${file/src/tests/.test}" \
  --max-turns 2
done

# modernize-codebase.sh
#!/bin/bash

# Subagent 정의
cat > .claude/agents/modernizer.md << 'EOF'
---
name: modernizer
description: "레거시 코드를 현대적 패턴으로 리팩토링"
model: sonnet
tools:
  - Read
  - Write
  - Bash(git:*)
---

# Code Modernizer

레거시 코드를 다음과 같이 현대화합니다:
1. ES6+ 문법 사용
2. 비동기 처리 개선 (async/await)
3. 모듈 시스템 현대화
4. 타입 안정성 추가
5. 베스트 프랙티스 적용

## 프로세스
1. 파일 분석
2. 문제점 식별
3. 리팩토링 수행
4. 테스트 확인
5. 변경사항 커밋
EOF

# 실행
claude "@modernizer 이 디렉토리의 모든 .js 파일을 현대화해주세요"

# generate-api-docs.sh
#!/bin/bash

# 모든 API 라우트 파일 찾기
api_files=$(find src/routes -name "*.js")

# 각 파일에 대한 문서 생성
for file in $api_files; do
  claude -p "이 API 라우트 파일을 분석하여 OpenAPI 3.0 스펙 문서를 생성하세요:
  
  $(cat $file)
  
  다음을 포함하세요:
  1. 엔드포인트 경로
  2. HTTP 메서드
  3. 요청 파라미터
  4. 응답 스키마
  5. 에러 코드
  6. 예제
  
  YAML 형식으로 출력하세요." \
  --output-format text >> docs/api.yaml
done

echo "API 문서가 docs/api.yaml에 생성되었습니다."

# Subagent 정의
cat > .claude/agents/db-migrator.md << 'EOF'
---
name: db-migrator
description: "데이터베이스 스키마 변경 및 마이그레이션 생성"
model: sonnet
tools:
  - Read
  - Write
  - Bash(npx prisma:*)
  - Bash(npm run migrate:*)
---

# Database Migrator

데이터베이스 마이그레이션을 안전하게 처리합니다.

## 프로세스
1. 스키마 변경 분석
2. 마이그레이션 SQL 생성
3. 롤백 스크립트 생성
4. 데이터 무결성 검증
5. 테스트 실행
EOF

# 실행
claude "@db-migrator User 모델에 email_verified 필드를 추가하고 
마이그레이션을 생성해주세요. 기본값은 false입니다."

# security-audit.sh
#!/bin/bash

cat > .claude/agents/security-auditor.md << 'EOF'
---
name: security-auditor
description: "종합 보안 감사 수행"
model: opus
tools:
  - Read
  - Bash(npm audit)
  - Bash(snyk test)
---

# Security Auditor

## 검사 항목
1. OWASP Top 10
2. 의존성 취약점
3. 하드코딩된 시크릿
4. SQL 인젝션 위험
5. XSS 취약점
6. CSRF 보호
7. 인증/인가 문제

## 출력
JSON 형식으로 심각도별 이슈 보고
EOF

# 주간 감사 실행
claude "@security-auditor 전체 코드베이스에 대한 보안 감사를 수행하고 
보고서를 security-report-$(date +%Y%m%d).json에 저장하세요" \
--output-format json

# Subagent 정의
cat > .claude/agents/performance-optimizer.md << 'EOF'
---
name: performance-optimizer
description: "성능 병목 분석 및 최적화"
model: sonnet
tools:
  - Read
  - Write
  - Bash(npm run benchmark:*)
  - Bash(node --prof:*)
---

# Performance Optimizer

## 분석 영역
1. 알고리즘 복잡도
2. 데이터베이스 쿼리 (N+1 문제)
3. 메모리 사용
4. 네트워크 호출
5. 캐싱 기회
6. 번들 크기

## 프로세스
1. 프로파일링 실행
2. 병목 식별
3. 최적화 제안
4. 구현 및 벤치마크
5. 개선 효과 측정
EOF

# 실행
claude "@performance-optimizer API 응답 시간이 느립니다. 
분석하고 최적화해주세요."

# feature-development.sh
#!/bin/bash

# 여러 Subagent가 협업하여 기능 개발
claude "새로운 결제 기능을 구현하려고 합니다. 다음 단계로 진행하세요:

1. @architect: 아키텍처 설계 및 기술 스택 제안
   - 결과를 docs/payment-architecture.md에 저장

2. @backend-dev: API 엔드포인트 구현
   - RESTful API 설계
   - 데이터베이스 스키마 생성
   - 트랜잭션 로직 구현

3. @frontend-dev: UI 컴포넌트 구현
   - 결제 폼
   - 결제 상태 표시
   - 에러 핸들링

4. @test-engineer: 테스트 작성
   - 유닛 테스트
   - 통합 테스트
   - E2E 테스트

5. @security-auditor: 보안 검토
   - PCI DSS 컴플라이언스 검증
   - 취약점 스캔

각 단계가 완료되면 다음 단계로 진행하고,
최종적으로 전체 구현 보고서를 생성하세요."

# auto-bug-fix.sh
#!/bin/bash

# 최근 에러 로그 분석
tail -n 1000 /var/log/app.log | claude -p "
이 로그에서 반복되는 에러를 식별하고,
각 에러에 대해:
1. 근본 원인 분석
2. 영향 범위 평가
3. 수정 제안
4. 우선순위 설정

결과를 JSON 형식으로 반환하세요.
" --output-format json > error-analysis.json

# 높은 우선순위 버그 자동 수정
jq -r '.high_priority_bugs[] | .id' error-analysis.json | while read bug_id; do
  claude "@debugger bug $bug_id를 조사하고 가능하면 자동으로 수정하세요.
  수정이 불가능하면 상세한 수정 가이드를 제공하세요."
done

# 버전 확인 (2.0.55 이상 필요)
claude --version

# LSP 서버 자동 시작
claude

# Claude가 자동으로 LSP 정보 활용
"이 함수의 모든 참조를 찾아서 리팩토링해주세요"
"타입 오류를 수정해주세요"
"사용하지 않는 import를 제거해주세요"

#!/bin/bash
# scripts/check-file-access.sh

# stdin으로 전달된 JSON 파싱
input=$(cat)
file_path=$(echo "$input" | jq -r '.path')

# 위험한 파일 접근 차단
if [[ "$file_path" =~ ^/etc/|^/root/|\.env$ ]]; then
  echo "ERROR: 접근이 제한된 파일입니다: $file_path"
  exit 1
fi

# 프로젝트 외부 접근 차단
if [[ ! "$file_path" =~ ^$(pwd) ]]; then
  echo "ERROR: 프로젝트 디렉토리 외부 접근이 차단되었습니다"
  exit 1
fi

exit 0

claude --skills security-checklist,performance-patterns

# 플러그인 설치
claude plugins install ./team-skills

# 또는 Git 저장소에서
claude plugins install github:yourteam/claude-skills

# 사용
claude --skills security-checklist,git-workflow

project/
├── CLAUDE.md              # 프로젝트 메모리
├── CLAUDE.local.md        # 사용자 메모리 (.gitignore)
├── src/
│   └── utils/
│       └── CLAUDE.md      # 하위 디렉토리 메모리
└── .gitignore

# claude 실행 위치: ./project/src/utils/
# 로드되는 메모리:
# 1. ./project/CLAUDE.md
# 2. ./project/src/CLAUDE.md (있는 경우)
# 3. ./project/src/utils/CLAUDE.md

# 메모리 보기/편집
/memory

# 메모리 파일 직접 편집
vim CLAUDE.md
vim CLAUDE.local.md

# 증상
npm install -g @anthropic-ai/claude-code
# 권한 오류

# 해결
sudo npm install -g @anthropic-ai/claude-code
# 또는 nvm 사용
nvm use 18
npm install -g @anthropic-ai/claude-code

# Node.js 버전 확인
node --version  # 18 이상 필요

# Node.js 업데이트
nvm install 18
nvm use 18

# 환경 변수 확인
echo $ANTHROPIC_API_KEY

# 환경 변수 설정
export ANTHROPIC_API_KEY="sk-ant-..."

# 영구 설정 (.bashrc 또는 .zshrc)
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

# 1. 컨텍스트 오버플로우
/clear                    # 컨텍스트 초기화
/compact                  # 대화 압축

# 2. 무거운 모델 사용
claude --model haiku     # 더 빠른 모델 사용

# 3. 너무 많은 파일 접근
claude --add-dir ./src   # 필요한 디렉토리만 지정

# 최대 턴 수 제한
claude -p --max-turns 3 "query"

# 출력 형식 최적화
claude -p --output-format json "query"

# 권한 확인
/allowed-tools

# 도구 허용
claude --allowedTools "Bash(git:*)" "Write" "Read"

# 설정 파일에 추가
# .claude/settings.json
{
  "permissions": {
    "allow": [
      "Bash(git:*)",
      "Write",
      "Read"
    ]
  }
}

# 명시적 호출 사용
@subagent-name "작업"

# description 개선
# BEFORE:
description: "코드 작업"

# AFTER:
description: "코드 변경 후 PROACTIVELY 사용하여 리뷰 수행"

# MCP 설정 확인
claude mcp list

# MCP 재설정
claude mcp reset-project-choices

# 로그 확인
tail -f ~/.claude/logs/mcp.log

# 해결책
/clear                    # 컨텍스트 초기화
/compact "keep essentials"  # 압축

# 예방
claude -p --max-turns 5   # 턴 수 제한

# 대기 후 재시도
sleep 60

# 또는 다른 모델 사용
claude --model haiku     # 더 저렴한 모델

# 상세 로깅 활성화
claude --verbose

# 통계 확인
/stats

# 비용 확인
/cos

# 설치 상태 확인
/doctor

# Opus 4.5에서 자동 활성화
claude --model opus

# 복잡한 문제 해결에 최적
"이 아키텍처의 성능 문제를 심층 분석하고
최적화 전략을 제시해주세요"

# 여러 Subagent 동시 실행
"@code-reviewer, @security-auditor, @test-runner를 
병렬로 실행하여 이 PR을 검증해주세요"

# 브라우저 기반 작업 관리
# https://autocloud.anthropic.com

# Slack에서 Claude Code 사용
/claude "코드 리뷰해줘"

# 실시간 진행 표시줄
# 컨텍스트 윈도우 사용량 시각화

/stats                    # 상세 통계 확인

# Haiku 4.5의 스마트 모델 전환
# Plan 모드: Sonnet 자동 사용
# 실행: Haiku 사용 (비용 절감)

/chrome                   # Chrome에서 테스트/디버그

# 조직 전체 설정 관리
# Anthropic 팀에 문의

claude --version
claude update