Claude Code의 강점

CLI가 모든 걸 바꾸는 이유

웹 기반 AI 채팅은 시공업체에게 문자를 보내는 것과 비슷해요. 원하는 걸 설명하면 상대방이 무엇을 할지 설명하고, 이 과정을 반복하다가 결국 코드를 복사해서 실제 프로젝트에 붙여넣게 돼요.

Claude Code는 그 시공업체가 여러분의 작업실에 직접 와서, 도구를 살펴보고, 재료를 점검하고, 실제로 만들어주는 거예요.

차이는 단순한 편의성이 아니에요. 가능한 것 자체가 근본적으로 달라져요.

이 코스에서 기대할 수 있는 것

이 코스는 실습 중심의 집중 레슨으로 구성되어 있어요. 각 레슨이 이전 레슨 위에 쌓이며, 실습과 퀴즈로 학습을 확실히 다져요. 한 번에 쭉 들어도 되고 하루에 한 레슨씩 진행해도 좋아요.

이 레슨에서 배울 내용

이 코스를 마치면 다음을 할 수 있어요:

• Claude Code 인터페이스와 핵심 명령어를 능숙하게 활용하기
• 정확한 응답을 위한 컨텍스트 전략적 관리법 익히기
• 복잡한 개발 작업을 단계별로 분해하고 오케스트레이션하기
• 파일 작업을 안전하고 효율적으로 수행하기
• Bash 명령어를 활용한 자동화 워크플로우 구축하기
• 다양한 기법을 결합한 고급 개발 워크플로우 설계하기

Claude Code가 할 수 있는 것

웹 채팅에서 복사-붙여넣기 체조가 필요했던 작업이 자동으로 이루어져요:

코드를 직접 읽기

/add src/auth/*
> 이 코드베이스에서 인증이 어떻게 작동하는지 설명해줘

실제 파일을 읽어요. 500줄을 채팅창에 붙여넣을 필요가 없어요.

명령어를 실행하고 결과를 확인하기

> 테스트를 실행하고 실패하는 것이 있으면 고쳐줘

npm test를 실행하고, 무엇이 실패했는지 확인하고, 코드를 수정해요.

여러 파일에 걸쳐 수정하기

> User 클래스를 의존성 주입 방식으로 리팩토링해줘

한 번에 하나의 스니펫이 아니라 여러 파일을 일관되게 수정해요.

세션 동안 컨텍스트 유지하기

> 방금 만든 것에 에러 처리를 추가해줘

세션의 맥락을 기억하고 점진적으로 작업을 쌓아가요.

마인드 전환

“Claude에게 물어보고 답변을 구현해야지"라는 생각을 멈추세요.

“Claude에게 이걸 구현하도록 지시해야지"라고 바꿔 생각하세요.

Claude Code를 검색 엔진이나 문서처럼 쓰는 게 아니에요. 코드베이스 위에서 동작하는 지능적인 도구로 활용하는 거예요.

이는 다음을 의미해요:

• 설명이 아니라 관련 파일에 직접 접근하게 하세요
• 명령어를 제안만 하게 하지 말고 직접 실행하게 하세요
• 무엇을 바꿀지 설명하게 하지 말고 직접 수정하게 하세요
• 모든 걸 수동으로 하지 말고 Claude가 한 것을 리뷰하세요

핵심 개념

컨텍스트 윈도우

Claude Code는 컨텍스트를 유지해요 — 본 파일, 대화 기록, 명령어 출력. 컨텍스트에 있는 모든 것이 응답에 영향을 미쳐요.

컨텍스트는 제한적이에요. 전체 코드베이스를 로드할 수 없어요. 무엇을 보여줄지 선택적이어야 해요.

컨텍스트 관리는 여러분의 몫이에요. /add, /clear, /compact 같은 명령어로 Claude가 보는 것을 제어해요.

스크래치패드

Claude Code에는 임시 작업을 위한 스크래치패드 디렉토리가 있어요. 다음 용도로 사용하세요:

• 반복 작업 중 초안 파일
• 테스트 출력
• 중간 결과

프로젝트 디렉토리를 실험 코드로 어지럽히지 마세요.

슬래시 명령어

/로 시작하는 명령어가 Claude Code를 제어해요:

이 코스 전반에 걸쳐 더 많은 명령어를 다룰 거예요.

첫 번째 워크플로우

Claude Code의 위력을 보여주는 간단한 워크플로우를 해볼게요.

시나리오: 기존 함수에 입력값 검증을 추가하고 싶어요.

기존 방식 (웹 채팅):

1. 파일 찾기
2. 함수를 채팅에 복사
3. 검증 요청
4. 응답 복사
5. 파일에 붙여넣기
6. 컨텍스트를 빠뜨린 걸 발견
7. 더 많은 코드 복사
8. 다시 질문
9. 드디어 쓸 만한 결과

Claude Code 방식:

/add src/utils/parser.js

> parseConfig 함수에 입력값 검증을 추가해줘.
> config가 필수 필드를 가진 객체인지 확인해:
> name (문자열), version (semver), entries (배열).
> 유효하지 않은 입력에 대해 설명적인 에러를 던져줘.

Claude가 파일을 읽고, 컨텍스트를 이해하고, 직접 수정해요.

리뷰. 커밋. 끝.

코스 전체 구성

이 코스에서는 Claude Code를 효과적으로 사용하는 법을 배워요:

실습

Claude Code가 설치되어 있다면 다음을 시도해 보세요:

1. 아무 프로젝트 디렉토리로 이동
2. claude 실행
3. /add로 소스 파일 추가
4. 질문: “이 파일이 무슨 일을 하는지 설명해줘”
5. 질문: “어떤 점을 개선할 수 있을까?”

채팅창에 복사-붙여넣기하는 것과 얼마나 다른지 느껴보세요.

핵심 정리

• Claude Code는 AI에게 코드베이스와 도구에 대한 직접 접근을 제공해요
• “Claude에게 물어보고 직접 구현"이 아니라 “Claude에게 구현을 지시"하는 사고로 전환하세요
• 컨텍스트 관리가 핵심 — Claude가 무엇을 보는지 여러분이 제어해요
• 슬래시 명령어가 Claude Code 환경을 제어해요
• 워크플로우 전환: 설명 → Claude가 실행 → 여러분이 리뷰

다음에는 매 세션마다 사용할 핵심 명령어를 배워요.

다음 레슨: 핵심 명령어를 심층적으로 다뤄요.