Claude Code Reference View

2장. CLAUDE CODE

Claude Code CLI 워크플로우를 기준으로 설치, 업데이트 추적 기준, 핵심 기능 10가지를 정리합니다.

설치 단계

4

업데이트 소스

2

핵심 기능

10

권장 레벨

L1-L2

섹션CLI · 에이전트

1. 설치 및 시작하기

📦 1단계

CLI 설치

Node.js 환경 확인 후 Claude Code CLI 설치

  1. 1) Node.js LTS 설치 여부 확인 (`node -v`)
  2. 2) 터미널에서 Claude Code CLI 설치
  3. 3) `claude --version`으로 설치 완료 확인

초보자용 설치 요약

  • Node.js가 없으면 먼저 설치해야 CLI가 동작합니다.
  • 설치 후 버전 확인까지 해야 PATH 문제가 없는지 확인할 수 있습니다.
  • 오류가 나면 터미널 재시작 후 다시 버전 확인을 진행하세요.
공식 설치 가이드
🔑 2단계

로그인/인증

로그인/인증 완료 후 기본 모델 접근 확인

  1. 1) `claude login` 실행
  2. 2) 브라우저 인증 완료 후 터미널 복귀
  3. 3) 간단한 프롬프트 1회 실행으로 인증 상태 확인

초보자용 인증 요약

  • 로그인이 끝나도 터미널 세션이 오래되면 재인증이 필요할 수 있습니다.
  • 처음에는 짧은 질의로 응답이 오는지부터 확인하세요.
  • 회사/팀 계정은 권한 정책에 따라 일부 모델이 제한될 수 있습니다.
공식 계정/인증 안내
📂 3단계

프로젝트 규칙 점검

프로젝트 루트에서 CLAUDE.md 규칙 적용 점검

4단계

첫 작업 루프 실행

Cmd+K → 탐색, 수정, 검증 루프 실행

2. 최근 업데이트 내역

출처: Claude Code Release Notes검증일 2026-04-15자동 점검 통과 · 14일 기준자세히 보기

3. 핵심 기능 10가지

비개발자 학습 순서에 맞춰 기초 → 심화 → 사례 → 에이전트 구성으로 정리했습니다. 항목을 눌러 상세를 펼칠 수 있습니다.

라벨 체계 잠금기초 2심화 2사례 2에이전트 4

맥락

입문 영상·가이드에서 Setup→첫 명령 확인 순서가 공통

설치는 했지만 실제로 어디서부터 명령을 시작해야 할지 막막할 때

설명

설치→로그인→첫 명령까지 끊김 없는 시작 루틴

처음 Claude Code를 켰을 때 시작점을 못 잡을 때

실행 단계

  • 프로젝트 루트에서 `claude --help`로 실행 경로 확인
  • 짧은 질의 1회로 인증·응답 상태 검증
  • 첫 작업 목표를 1문장으로 고정해 루프 시작

결과

초기 진입 장벽이 낮아져 첫 작업 성공률 상승

주의

환경 점검 없이 큰 작업부터 시도하면 실패 원인 추적 어려움

바로 실행

현재 폴더 기준으로 첫 작업 루프(탐색→수정→검증) 체크리스트를 만들어줘

참조 링크

맥락

고급 사례에서 규칙 파일 우선 확인이 품질 차이의 핵심

도구는 잘 쓰지만 팀 규칙과 어긋나 재작업이 반복될 때

설명

프로젝트 규칙을 먼저 읽고 변경 범위를 좁혀 일관된 결과

팀 규칙을 지키면서 안전하게 수정해야 할 때

실행 단계

  • 작업 전 CLAUDE.md·규칙 파일 먼저 요약
  • 요청 범위를 파일·기능 단위로 제한
  • 수정 후 규칙 위반 가능 항목을 체크리스트로 검증

결과

리뷰 반려·재작업 감소, 팀 표준 준수율 상승

주의

규칙 요약 없이 바로 수정하면 형식·정책 충돌 빈번

바로 실행

이번 변경에 적용될 규칙 3개만 뽑고 체크포인트로 정리해줘

참조 링크

허브 버튼 링크 기준

허브 상단 4개 도구 버튼은 학습 흐름 고정을 위해 각각 m1~m4 내부 서브페이지로 이동합니다. 이 화면의 공식 링크는 참고 자료로 별도 제공합니다.

타임라인으로 돌아가기