1. 클로드 코드(Claude Code) 기본 사용법 및 CLI 명령어 [0]

thumbnail 클로드 코드(Claude Code)를 효율적으로 사용하기 위한 기본적인 설치 방법, 실행 명령어, 그리고 다양한 CLI(Command Line Interface) 기능을 익혀야 한다.

1.1. 클로드 코드 설치 및 실행 [0]

  1. 설치 방법 [5]
    1. npm install -g @anthropic-ai/claude-code 명령어를 사용하여 클로드 코드를 설치한다. [6]
  2. 클로드 코드 시작 [8]
    1. claude 명령어를 입력하여 클로드 코드를 시작할 수 있다. [8]
    2. 동시에 프롬프트를 입력하려면 claude "프롬프트 내용" 형식으로 실행한다. [9]
  3. 데이터 파이핑 [11]
    1. 파이프(|)를 통해 클로드 코드에 데이터를 주입하여 정확한 데이터를 기반으로 작업을 수행할 수 있다. [12]
    2. 이는 헤드리스 모드와 함께 사용하면 매우 유용하다. [13]
  4. 세션 이어가기 [14]
    1. 최근 세션을 이어가려면 claude -c 또는 claude --continue를 사용한다. [14]
    2. 특정 세션을 선택하려면 claude -r 또는 claude --resume을 입력하여 세션 선택 창을 띄운다. [16]
  5. 업데이트 및 모델 선택 [18]
    1. claude update 명령어로 클로드 코드를 업데이트할 수 있다. [18]
    2. claude --model <모델명> 플래그를 사용하여 특정 모델(예: Sonnet)을 선택하여 실행할 수 있다. [20]
  6. 헤드리스 모드 [22]
    1. claude -p "프롬프트 내용"과 같이 -p 플래그를 사용하여 헤드리스 모드로 실행하면 인터랙티브 모드 없이 바로 응답을 받을 수 있다. [23]
    2. 이는 프로그래밍 방식 실행이나 멀티 에이전트 모드에 유용하다. [23]
    3. 응답 형식을 JSON으로 지정하여 데이터를 다루기 쉽게 만들 수 있다. [26]
  7. 상세 로그 확인 [29]
    1. claude --verbose 플래그를 사용하면 더 긴 로그를 받아볼 수 있어 디버깅에 유용하다. [29]

1.2. 인터랙티브 모드 슬래시(Slash) 명령어 [31]

  1. 기본 명령어 [31]
    1. /help: 사용 가능한 모든 기능과 명령어를 상세하게 확인할 수 있다. [32]
    2. /clear: 대화 이력을 비우고 컨텍스트 윈도우를 확보하여 새로운 내용을 다룰 때 할루시네이션(환각) 가능성을 낮춘다. [34]
    3. /compact: 대화를 요약하고 압축하여 컨텍스트 윈도우를 확보한다. [39]
      1. 자동 압축(Auto Compact)은 내용이 이상해질 수 있으므로, 적절한 시기에 직접 /compact를 사용하여 요약하는 것이 좋다. [41]
      2. 특정 내용을 유지하며 압축하려면 /compact "유지할 내용"과 같이 입력한다. [45]
  2. 설정 및 상태 확인 명령어 [46]
    1. /config: 자동 압축 설정, 할 일 목록(To-do list) 끄기 등 다양한 설정을 변경할 수 있다. [46]
    2. /model: 사용할 모델(Opus, Sonnet)을 선택하거나, 토큰 사용량에 따라 모델이 자동으로 전환되도록 설정할 수 있다. [48]
    3. /cost: API 모드 사용 시 토큰 사용량과 비용을 확인할 수 있다. [53]
    4. /status: 계정 및 시스템 상태를 확인할 수 있다. [55]
    5. /doctor: 설치 및 환경을 점검하여 체크리스트를 확인할 수 있다. [57]
  3. 프로젝트 관리 명령어 [59]
    1. /init: 프로젝트를 초기화하고, 클로드 코드가 프로젝트 전체를 분석하여 필수 요약 내용을 클로드.md 파일에 저장한다. [59]
    2. /memory: 클로드.md 파일을 수정할 수 있다. [61]
      1. 프로젝트 메모리(해당 프로젝트에만 적용) 또는 사용자 메모리(모든 프로젝트에 적용)를 수정할 수 있다. [63]
      2. #을 누르고 내용을 입력하면 클로드.md에 빠르게 추가된다. [64]
  4. 협업 및 디버깅 명령어 [65]
    1. /permissions: 도구 권한을 관리하여 어떤 툴을 사용할지 설정할 수 있다. [65]
    2. /bug: 엔트로픽에 클로드 코드 관련 버그 리포트를 제출할 수 있다. [68]
    3. /review: 연동된 GitHub 저장소에서 Pull Request를 가져와 클로드 코드의 리뷰를 받을 수 있다. [70]
    4. /pr_comment: 특정 Pull Request의 모든 댓글을 분석하여 개선 사항을 파악할 수 있다. [73]
    5. /login, /logout: 계정을 전환하거나 로그아웃할 수 있으며, 멀티 테넌시 환경에서 여러 계정을 운영할 때 유용하다. [75]
  5. 사용자 경험 개선 명령어 [78]
    1. /terminal_setup: Shift + Enter로 줄 바꿈을 설정할 수 있다. [78]
    2. /vim_mode: 대화창에서 Vim 명령어를 사용하여 텍스트를 편집할 수 있다. [81]
  6. 고급 기능 명령어 [83]
    1. /agents: 특정 작업에 특화된 서브 에이전트를 일괄적으로 관리하고 자동으로 사용되도록 설정할 수 있다. [83]
    2. /mcp: 현재 프로젝트와 연결된 MCP(Multi-Agent Collaboration Protocol)들의 상태를 확인할 수 있다. [87]
    3. /output_style: 클로드 코드의 출력 스타일을 변경할 수 있으며, 기본 설정 외에 사용자 정의 스타일도 가능하다. [89]
    4. /status_line: 하단 상태 표시줄에 원하는 정보를 표시할 수 있다. [95]

2. 클로드 코드(Claude Code) 활용 극대화 팁 [99]

thumbnail 클로드 코드의 효율을 극대화하기 위해서는 클로드.md 파일을 활용한 컨텍스트 최적화, IDE 연동, 그리고 엔트로픽이 직접 제공하는 고급 활용 팁들을 숙지해야 한다.

2.1. 클로드.md 파일 활용 및 IDE 연동 [101]

  1. 클로드.md 파일의 중요성 [101]
    1. 클로드.md 파일은 클로드 코드의 효율을 극대화하는 가장 쉬운 방법이다. [102]
    2. 프로젝트 구조, 폴더 구조, 핵심 기능 설명을 요약하여 클로드 코드가 전체 프로젝트를 스캔하지 않아도 되도록 하면 성능이 압도적으로 향상된다. [103]
  2. 클로드.md 파일의 종류 [104]
    1. 엔터프라이즈 파일: 회사 코딩 표준이나 기업 전반의 규칙을 저장한다. [106]
    2. 프로젝트 메모리 파일: 프로젝트 관련 규칙을 저장한다. [107]
    3. 사용자 메모리 파일: 사용자 개인의 규칙을 저장한다. [108]
    4. 프로젝트 로컬 메모리 파일: 프로젝트 관련 규칙 중 개인적으로 사용할 규칙을 저장한다. [109]
  3. 파일 태그 및 중첩 [110]
    1. @ 기호를 사용하여 특정 파일을 태그할 수 있으며, 절대 경로와 상대 경로 모두 사용 가능하다. [110]
    2. 클로드.md 파일을 중첩하여 특정 폴더에만 적용되도록 설정할 수 있다. [114]
      1. 이는 프로젝트 클로드.md 파일이 너무 커지는 것을 방지하고, 필요한 경우에만 하위 클로드.md 파일을 읽어 컨텍스트 사용을 최적화한다. [116]
  4. IDE 연동 [117]
    1. 플러그인 설치: 클로드 코드 플러그인을 설치하면 터미널과 연동되어 편리하게 사용할 수 있다. [118]
    2. 빠른 실행: Ctrl + Esc (Windows) 또는 Cmd + Esc (Mac)를 사용하여 클로드 코드를 빠르게 실행할 수 있다. [120]
    3. 코드 하이라이트: IDE에서 코드를 하이라이트하면 해당 영역이 클로드 코드의 문맥으로 자동 주입된다. [121]
    4. Diff 기능 연동: Visual Studio Code나 IntelliJ와 같은 IDE의 Diff 뷰와 연동하여 변경 사항을 확인할 수 있다. [122]
    5. 파일 참조: Cmd + Option + K (Mac) 또는 Alt + Ctrl + K (Windows)를 사용하여 파일을 참조할 수 있다. [123]
    6. 외부 IDE 연동: /id 명령어를 사용하여 현재 터미널이 아닌 다른 외부 IDE와 클로드 코드를 연동할 수 있다. [126]

2.2. 엔트로픽이 직접 알려주는 꿀팁 [127]

  1. Git CLI 설치 [127]
    1. Git CLI를 설치하면 클로드 코드가 Git 커밋 분석, 커밋 메시지 작성, 롤백, Pull Request 생성 등 복잡한 Git 관련 작업을 쉽게 처리할 수 있다. [128]
  2. MCP(Multi-Agent Collaboration Protocol) 사용 [131]
    1. 클로드 코드 자체도 훌륭하지만, Superbase나 Playwright와 같은 MCP를 함께 사용하면 LRM(Large Language Model)의 한계를 넘어 유용한 작업을 수행할 수 있다. [132]
    2. 사용자 레벨에서 정의하여 모든 프로젝트에 전반적으로 사용되도록 설정할 수 있다. [134]
  3. 커스텀 슬래시 명령어 사용 [135]
    1. 자주 사용하는 명령어(예: Git 관련, 테스트 관련)를 커스텀 슬래시 명령어로 미리 만들어 저장하고 반복적으로 사용할 수 있다. [136]
    2. 인자(argument)를 사용하여 프롬프트를 받을 수도 있다. [138]
    3. 사용자 스코프와 프로젝트 스코프에 정의하여 중복을 피하고 효율적으로 관리할 수 있다. [139]
  4. Explain-Plan-Commit 순서 따르기 [141]
    1. 클로드 코드와의 대화는 모두 컨텍스트에 포함되므로, 충분한 시간을 갖고 프로젝트를 분석하고, 작업을 계획하고, 실행한 후 커밋해야 한다. [141]
    2. 클로드 코드가 더 많은 문맥과 좋은 가이드라인을 가질수록 더욱 효율적이고 정확한 작업을 수행할 수 있다. [143]
  5. Thinking 토큰 활용 [145]
    1. think, think, think, ultrathink 순서대로 더 많은 토큰을 배정받을 수 있다. [145]
    2. 토큰 할당이 많을수록 처리 시간이 길어지므로, 항상 ultrathink를 사용하는 것이 좋은 것은 아니다. [147]
  6. TDD(Test-Driven Development) 적극 활용 [148]
    1. 클로드 코드에게 예상 입력과 출력 값을 기반으로 테스트 코드를 먼저 작성하도록 유도한다. [148]
    2. 테스트가 실패하는 것을 확인한 후 구현을 작성하고, 테스트를 통과할 때까지 반복하여 커밋한다. [150]
  7. 스크린샷 적극 활용 [151]
    1. Playwright나 Puppeteer 같은 MCP를 사용하여 자동으로 페이지 스크린샷을 찍고 클로드 코드에 주입하여 작업 효율을 높일 수 있다. [151]
  8. Raw 모드 사용 [153]
    1. 클로드 코드 숙련도가 높다면 Raw 모드를 사용해 볼 수 있다. [153]
    2. 특히 /permissions 플래그를 사용하면 사용자의 허락 없이도 클로드 코드가 자유롭게 코딩하도록 설정할 수 있다. [154]
    3. 직접 사용하기 어렵다면 Docker 컨테이너를 활용하는 것이 좋다. [155]
  9. 클로드 코드를 선생님으로 활용 [156]
    1. 새로운 코드베이스를 이해해야 할 때, 클로드 코드에게 프로젝트 전반적인 내용을 먼저 물어보고, 점차 세부적인 질문을 해나가며 학습할 수 있다. [157]
  10. 프롬프트 상세 작성 [159]
    1. "테스트를 작성해 줘"와 같이 모호하게 명령하기보다, "sample.file의 테스트 코드를 작성해 줘. 사용자가 로그인된 상태인 edge case를 꼭 포함해 주고, mock은 하지 말아 줘"와 같이 명확하게 명령할수록 정확한 결과를 얻을 수 있다. [160]
  11. 이미지 전달 [163]
    1. 스크린샷을 찍거나 이미지 파일을 복사한 후 드래그 앤 드롭 또는 Ctrl + V (Mac에서는 Cmd + C 후 Ctrl + V)로 클로드 코드에 이미지를 전달할 수 있다. [163]
  12. 파일 직접 태그 [166]
    1. @를 입력하면 파일 목록이 나타나며, Tab 키를 사용하여 원하는 파일을 쉽게 탐색하고 태그할 수 있다. [166]
  13. ESC를 두려워하지 않기 [168]
    1. 클로드 코드가 잘못된 방향으로 작업을 진행할 경우, 과감하게 Esc를 눌러 작업을 취소해야 컨텍스트 오염을 방지할 수 있다. [169]
  14. 롤백 명령어 활용 [172]
    1. 클로드 코드는 문맥에 있는 변경 사항이나 커밋된 사항을 훌륭하게 롤백할 수 있는 능력을 갖추고 있다. [172]
    2. 기존 커밋으로 롤백하거나 변경 사항을 롤백하는 등 원하는 형태를 설명만 해주면 쉽게 롤백할 수 있다. [174]
  15. 체크리스트 및 스크래치패드 활용 [175]
    1. 여러 단계에 걸친 작업을 할 경우, 클로드 코드에게 마크다운 체크리스트를 사용하여 작업을 수행하도록 명령하면 복잡한 장기 작업을 더 잘 수행할 수 있다. [175]
  16. 작업과 검증 분리 [177]
    1. 하나의 에이전트로 코딩 작업을 한 후, /clear로 대화 내역을 삭제하거나 다른 서브 에이전트를 생성하여 결과를 검증할 수 있다. [177]
    2. 독립된 작업을 분리하여 실행하면 서로 다른 관점을 얻을 수 있다. [179]
  17. 워크트리(Worktree) 사용 [180]
    1. 워크트리를 사용하면 여러 브랜치 환경을 쉽게 나누고 독립적으로 작업할 수 있다. [180]
    2. Git과 함께 사용하여 여러 작업을 동시에 실행하고 Pull Request로 병합하는 작업 흐름을 만들면 효율적이다. [182]