강의 소개

학습목표

• 이 수업을 마치면 다음을 할 수 있습니다.

  • 코딩 어시스턴트가 무엇인지 정의하고, 기본 동작 흐름(입력 → 컨텍스트 수집 → 계획 → 실행)을 설명하기

  • 언어 모델의 한계(텍스트 입출력만 가능)와 이를 보완하는 도구 사용(tool use) 시스템의 역할을 설명하기

  • Claude Code가 어떤 방식으로 실제 개발 작업(성능 개선, 데이터 분석, UI 수정, PR 리뷰 등)에 적용되는지 사례로 이해하기

  • 컨텍스트를 추가/제어하는 주요 기능(/init, @ 멘션, Memory, Compact, Clear)을 구분해 활용하기

  • 커스텀 명령어, MCP 서버, GitHub 통합, Hooks, SDK가 무엇이며 언제 유용한지 개요를 정리하기

(아래는 코스 전체 노트를 볼 수 있는 버튼입니다)

코딩 어시스턴트란 무엇인가요?

코딩 어시스턴트는 대규모 언어 모델(LLM) 을 활용해 코드를 작성하고, 버그를 수정하고, 개발 작업을 완료하도록 돕는 도구입니다. 예를 들어 "에러 메시지가 뜨는데 원인을 찾아 수정해줘" 같은 요청을 받아 코드베이스를 이해하고 해결책을 제시하거나, 실제 변경까지 수행하는 형태로 동작합니다.

코딩 어시스턴트의 기본 동작 흐름

코딩 어시스턴트는 보통 다음 과정을 반복합니다.

1. 작업 요청을 받음 (예: 에러 메시지 기반 버그 수정)

2. 컨텍스트를 수집함 (관련 파일을 읽고, 코드베이스 구조를 파악)

3. 해결 계획을 세움 (수정 방향과 단계 정의)

4. 행동을 수행함 (코드 수정, 테스트 실행, 결과 확인)

핵심 한계: 언어 모델은 텍스트만 처리한다

언어 모델 자체는 텍스트 입력/출력만 할 수 있습니다. 즉, 모델이 "파일을 직접 열어보기", "명령어 실행", "브라우저 조작", "외부 시스템 접근"을 스스로는 할 수 없습니다.

그래서 실제 개발 작업을 하려면, 언어 모델이 도구(tool) 를 통해 행동할 수 있도록 연결해주는 "도구 사용 시스템(tool use)"이 필수입니다.

도구 사용(Tool Use) 시스템이란?

도구 사용 시스템은 언어 모델이 "행동 요청"을 할 수 있게 만드는 실행 메커니즘입니다.

• 사용자가 작업을 요청하면, 어시스턴트가 도구 호출 형식을 모델에 알려줍니다.

• 모델은 그 형식에 맞춰 "파일 읽기", "명령어 실행" 같은 행동 요청을 생성합니다.

• 어시스턴트(실행기)가 실제로 도구를 실행한 뒤 결과를 다시 모델에 전달합니다.

• 모델은 결과를 바탕으로 다음 행동을 반복하거나 최종 답변을 제공합니다.

Claude Code는 무엇이 다른가요?

Claude Code는 도구 기반으로 실제 개발 작업을 수행하는 AI 코딩 어시스턴트입니다.

• 기본 도구로 파일 읽기/쓰기, 명령 실행, 개발 작업 보조 기능을 제공합니다.

• 팀의 필요에 따라 새로운 도구 세트를 쉽게 추가할 수 있어 확장성이 높습니다.

• 코드 검색/분석을 "외부로 전체 색인 전송" 방식이 아니라, 직접 필요한 코드만 찾아보는 방식으로 운영할 수 있어 보안 측면에서 유리한 접근이 가능합니다.

Claude Code in Action에서 소개하는 Claude Code 대표 활용 사례

• 성능 최적화: 인기 라이브러리(예: Chalk)를 벤치마킹/프로파일링하고 병목을 찾아 수정해 처리량을 크게 개선한 사례

• 데이터 분석: Jupyter 노트북에서 CSV 기반 이탈(churn) 분석을 반복 실행하며 결과에 맞춰 분석을 확장한 사례

• UI 개선 자동화: Playwright 같은 브라우저 자동화 도구(MCP)를 붙여, 스크린샷 기반으로 스타일을 수정하며 반복 개선한 사례

• GitHub PR 리뷰: GitHub Actions에서 PR/이슈 트리거로 실행되어 자동 리뷰, 코멘트, PR 생성 등을 수행하는 사례

• 보안/컴플라이언스 탐지: 인프라 흐름을 분석해 외부 파트너 공유 경로에서 PII 노출 위험을 PR 리뷰 단계에서 발견한 사례

컨텍스트 추가하기: "적당한 정보"가 가장 중요

컨텍스트는 Claude Code의 성능을 좌우합니다. 불필요한 정보가 많을수록 품질이 떨어질 수 있으므로, "충분하지만 과하지 않은" 정보를 주는 것이 목표입니다.

/init 와 CLAUDE.md

처음 실행 시 /init를 통해 전체 코드베이스를 개략적으로 분석하고, 프로젝트 요약/구조/핵심 파일을 정리한 CLAUDE.md를 만들 수 있습니다. 이 파일은 이후 요청마다 기본 컨텍스트로 포함됩니다.

CLAUDE.md는 보통 3가지 레벨로 운영할 수 있습니다.

• 프로젝트 레벨: 팀과 공유(버전 관리에 커밋)

• 로컬 레벨: 개인용(커밋하지 않음)

• 머신 레벨: 모든 프로젝트에 적용되는 전역 규칙

@ 멘션과 Memory

• @로 특정 파일을 직접 지정해 포함하면, 검색에 의존하지 않고 정확한 컨텍스트를 빠르게 제공할 수 있습니다.

• #(Memory)를 통해 CLAUDE.md를 자연어로 업데이트해, 반복되는 규칙/실수를 "기억"시키는 방식으로 품질을 안정화할 수 있습니다.

변경 작업을 더 잘하게 만드는 모드와 입력

스크린샷 입력

UI 변경이 필요할 때는 스크린샷이 매우 유용합니다. (macOS에서는 Command-V가 아니라 Control-V로 붙여넣는 방식이 핵심입니다. Windows에서는 Alt-V로 클립보드에 있는 이미지를 붙여넣습니다.)

Plan Mode vs Thinking Mode

• Plan Mode: 더 넓은 범위를 조사해 구현 계획을 먼저 세우는 데 유리

• Thinking Mode: 복잡한 논리/디버깅처럼 깊은 추론이 필요한 문제에 유리

• 두 모드는 함께 사용할 수 있지만, 더 많은 토큰을 사용하므로 비용/시간을 고려해야 합니다.

컨텍스트 제어(긴 대화 정리)

긴 대화에서 컨텍스트가 흐려질 때 활용하는 대표 기능들입니다.

• Escape: 생성 중단 후 방향 전환

• Escape + Memory: 중단 + 반복 실수 방지 규칙을 기억시키기

• Double Escape: 대화 타임라인에서 이전 지점으로 되감기(불필요한 디버깅 구간 건너뛰기)

• Compact: 대화 전체를 요약해 "학습된 핵심 지식"은 유지하면서 컨텍스트를 압축

• Clear: 대화 기록을 초기화(완전히 다른 작업으로 전환할 때)

커스텀 명령어, MCP, GitHub, Hooks, SDK 개요

커스텀 명령어(Custom Commands)

반복 작업을 슬래시 명령어로 자동화하는 방법입니다.

• 위치: 프로젝트의 .claude/commands/

• 파일명 = 명령어 이름 (예: audit.md → /audit)

• $arguments로 실행 시 인자를 받을 수 있습니다.

MCP 서버(MCP Servers)

Claude Code에 외부 도구를 붙여 능력을 확장하는 서버(로컬/원격)입니다.

• 예: Playwright MCP 서버로 브라우저 자동화, 스크린샷 기반 UI 점검/수정

• 설치 예시: claude mcp add [name] [start-command]

• 초기 실행 시 권한 승인 필요, 자동 승인 설정도 가능

GitHub 통합(GitHub Integration)

GitHub Actions에서 Claude Code가 실행되도록 연결해 PR/이슈 기반 자동화를 만드는 방식입니다.

• @claude 멘션으로 작업 할당

• PR 생성/리뷰 자동화

• .github/workflows에서 워크플로와 권한을 명시적으로 설정

• MCP 도구를 쓰려면 해당 권한도 별도로 선언해야 합니다.

Hooks

Claude가 도구를 실행하기 전/후에 사용자 정의 명령을 실행하는 메커니즘입니다.

• PreToolUse: 실행 전 검사/차단 가능(예: .env 읽기 방지)

• PostToolUse: 실행 후 검사/피드백(예: tsc --no-emit로 타입 에러 즉시 검출)

Agent SDK

CLI/TypeScript/Python에서 Claude Code를 프로그래밍적으로 호출하는 인터페이스입니다.

• 기본 권한은 읽기 전용인 경우가 많아, 쓰기 도구는 명시적으로 허용해야 합니다.

• 파이프라인, Hook, 헬퍼 스크립트에 "지능"을 추가하는 용도로 적합합니다.

핵심 요약

• 코딩 어시스턴트는 LLM을 활용해 개발 작업을 돕지만, 도구 사용 시스템이 있어야 실제 행동(파일/명령/브라우저)을 수행할 수 있습니다.

• Claude Code는 기본 도구 + 확장 가능한 도구(MCP) + GitHub 연동 + Hooks/SDK로 팀의 작업 방식에 맞게 성장할 수 있는 구조를 제공합니다.

• 컨텍스트는 "많을수록 좋은 것"이 아니라, 정확하고 필요한 만큼 주는 것이 중요합니다.

다음 내용

• 실제 설치/프로젝트 초기화(/init)와 CLAUDE.md 구성

• 도구 사용과 컨텍스트 제어를 실습하며, 커스텀 명령어·MCP·Hooks로 자동화 확장하기