ClOr

ClOr

백엔드 실무 트러블슈팅과 AI 에이전트 구조 분석을 기록합니다.

Claude Code 해부학 (완결)

51만 줄 소스코드를 19편에 걸쳐 분석한 완결 시리즈

전체 시리즈 보기 →

백엔드 트러블슈팅

실무에서 겪은 장애와 해결 과정 기록

전체 시리즈 보기 →

최신 글

클로드 AI를 "질문하면 답하는 챗봇" 정도로 쓰고 있다면, 기능의 20%도 못 쓰고 있는 거다.

나도 처음엔 그랬다. ChatGPT 대안 정도로 생각하고, 간단한 질문이나 번역에만 썼다. 그런데 6개월간 매일, 업무에 실전으로 쓰면서 발견한 게 있다. Claude에는 대부분의 사용자가 모르는 기능이 꽤 많다. 공식 문서에 있지만 찾아보지 않으면 영원히 모르는 것들, UI에 있는데 뭔지 몰라서 안 누르는 것들이다.

이 글은 그중에서 실제로 효과가 있는 10가지만 추려서 정리한 것이다. 각 기능마다 "이렇게 쓰면 된다"를 구체적으로 적었다. 북마크 걸어두고 하나씩 써보면 된다.

목차

    1. Projects — 프로젝트별 맞춤 AI 만들기
    • 실전 사용법
    • 내가 실제로 쓰는 프로젝트 구성
    1. 시스템 프롬프트 커스텀 — 제대로 쓰면 다른 AI가 된다
    • 나쁜 예시
    • 좋은 예시
    1. Artifacts — 코드와 문서를 별도 패널에서 다루기
    • 핵심 기능들
    • 이렇게 활용한다
    1. 대화 중 모델 전환 — 비용과 품질 동시에 잡기
    • 언제 전환하나
    1. 이미지 분석 — 스크린샷 하나로 문제 해결
    • 개발자 킬러 기능
    • 그 외 활용
    1. 마크다운 렌더링 + LaTeX 수식
    • 이렇게 쓴다
    1. 긴 대화에서의 "요약" 활용법
    • 실전 팁
    1. CSV/엑셀 데이터 분석
    • 이게 왜 강력하냐면
    • 시각화까지 한 번에
    • 실제 활용 사례
    1. 다국어 동시 처리 — 언어 장벽이 사라진다
    • 실전 시나리오
    1. Claude Code — AI가 내 컴퓨터에서 직접 코딩
    • 뭐가 다르냐면
    • 간단한 예시
  • 보너스: 잘 안 알려진 팁 3가지
      1. 빈 대화에서 시작하라
      1. "다시 해줘" 대신 구체적 피드백
      1. 영어 → 한국어 하이브리드 전략
  • 요약

1. Projects — 프로젝트별 맞춤 AI 만들기

이건 모르면 손해가 큰 기능이다.

Claude Pro 이상 구독하면 좌측 사이드바에 "Projects"가 생긴다. 프로젝트마다 별도의 대화 공간을 만들고, 거기에 시스템 프롬프트참고 파일을 고정할 수 있다.

무슨 뜻이냐면, "블로그 작성용 Claude"와 "코드 리뷰용 Claude"를 완전히 분리해서 운영할 수 있다는 거다.

실전 사용법

  1. Claude 웹에서 좌측 사이드바 → Projects → "Create project" 클릭
  2. 프로젝트 이름을 짓고 (예: "블로그 글 작성")
  3. "Add content" 버튼으로 참고 파일을 업로드 (글쓰기 가이드, 이전 글 샘플 등)
  4. "Instructions" 필드에 시스템 프롬프트를 작성
  5. 이제 이 프로젝트 안에서 대화를 시작하면, 매번 파일을 올리거나 맥락을 설명할 필요가 없다

내가 실제로 쓰는 프로젝트 구성

프로젝트 고정 파일 시스템 프롬프트 핵심
블로그 작성 글쓰기 가이드, 이전 글 3편 "반말 직설체, 구체적 사례 필수"
코드 리뷰 코딩 컨벤션 문서 "Kotlin + Spring Boot. 문제점만 지적"
영문 기술 번역 용어집, 스타일 가이드 "기술 번역. 의역 우선. 자연스러운 한국어"

매번 "나는 이런 스타일로 글을 쓰는데..."를 설명하던 시간이 사라진다. 프로젝트 열고 바로 본론으로 들어가면 된다.

2. 시스템 프롬프트 커스텀 — 제대로 쓰면 다른 AI가 된다

Projects의 "Instructions" 필드가 시스템 프롬프트다. 여기에 뭘 쓰느냐에 따라 Claude의 응답 품질이 완전히 달라진다. 같은 모델인데 결과물이 다른 이유가 대부분 여기에 있다.

나쁜 예시

당신은 10년차 백엔드 개발자입니다. 친절하게 답변해 주세요.

이건 효과가 거의 없다. 너무 모호하다.

좋은 예시

Kotlin + Spring Boot 전문.
코드 제시 시 불필요한 설명 생략. 코드만.
변수명은 camelCase. DTO는 data class.
테스트는 Kotest + MockK 사용.
응답은 한국어. 코드 주석은 영어.

차이가 보이나? 좋은 시스템 프롬프트의 공통점은 구체적이라는 것이다. "잘 해주세요"가 아니라 "이 규칙을 따라라"다.

  • 한 줄에 하나의 규칙을 적어라. 문장형보다 명령형이 효과적이다.
  • 자주 수정하지 않아도 되는 내용만 넣어라. 매번 바뀌는 건 대화에서 지시하는 게 낫다.
  • "하지 마" 보다 "이것만 해"가 더 잘 먹힌다. 금지 조건보다 양성 조건이 강력하다.

3. Artifacts — 코드와 문서를 별도 패널에서 다루기

Claude에게 긴 코드를 달라고 하면, 대화창 옆에 별도 패널이 열리면서 거기에 코드가 뜬다. 이게 Artifacts다.

단순히 보기 좋으라고 있는 게 아니다. Artifacts에는 진짜 유용한 기능이 숨어있다.

핵심 기능들

미리보기: HTML 코드를 Artifacts에 생성하면 실제로 렌더링된 결과를 바로 볼 수 있다. 랜딩 페이지 프로토타입을 Claude에게 만들게 하고, 바로 눈으로 확인하는 게 가능하다.

React 렌더링: React 컴포넌트를 만들면 Artifacts 안에서 실제로 동작하는 모습을 보여준다. 버튼 클릭, 상태 변경까지 된다. 프론트엔드 프로토타이핑에 미친 효율이다.

버전 관리: Artifacts는 수정할 때마다 이전 버전을 저장한다. "아까 버전이 더 나았는데" 할 때 화살표 버튼으로 이전 버전으로 돌아갈 수 있다. 이걸 모르면 "아까 코드 다시 줘"를 반복하게 된다.

복사/다운로드: 코드 전체를 한 번에 복사하거나 파일로 다운로드할 수 있다. 대화창에서 드래그해서 복사하던 시절은 끝났다.

이렇게 활용한다

  • "이 데이터로 대시보드 HTML을 만들어줘" → Artifacts에서 바로 미리보기
  • "이 컴포넌트를 수정해서 다크모드를 추가해줘" → 이전 버전과 비교 가능
  • "이 SVG 아이콘을 만들어줘" → Artifacts에서 바로 렌더링 확인

4. 대화 중 모델 전환 — 비용과 품질 동시에 잡기

대화 도중에 모델을 바꿀 수 있다는 걸 아는 사람이 의외로 적다.

Claude 웹에서 대화 입력창 근처에 모델 선택 드롭다운이 있다. 여기서 Opus ↔ Sonnet을 자유롭게 전환할 수 있다. 대화를 새로 시작할 필요가 없다. 같은 대화 안에서 모델만 바꾸면 된다.

언제 전환하나

상황 추천 모델 이유
복잡한 설계 질문 Opus 깊은 추론 필요
간단한 후속 질문 Sonnet 빠르고 사용량 절약
긴 코드 생성 Sonnet 충분히 잘 함, 빠름
미묘한 뉘앙스 판단 Opus Sonnet이 놓치는 걸 잡음
번역, 포맷 변환 Sonnet Opus를 쓸 필요 없음

Pro 구독의 사용량 제한이 있기 때문에, 이 전략을 쓰면 Opus를 정말 필요한 곳에만 아껴서 쓸 수 있다. 간단한 질문에도 Opus를 쓰는 건 고급 식당에서 물만 마시는 것과 같다 — 낭비다.

5. 이미지 분석 — 스크린샷 하나로 문제 해결

Claude는 이미지를 읽는다. 그것도 꽤 잘 읽는다.

스크린샷, 다이어그램, 와이어프레임, 심지어 손글씨까지. 클립보드에서 바로 붙여넣기(Ctrl+V)하면 된다. 파일로 저장할 필요도 없다.

개발자 킬러 기능

에러 스크린샷을 찍어서 Claude에게 던지면, 텍스트를 읽고 에러의 원인과 해결법을 알려준다. 에러 메시지를 일일이 타이핑하거나 복사하기 어려운 상황 — IDE 팝업, 브라우저 콘솔, 터미널 출력 등 — 에서 진짜 편하다.

"이 에러 스크린샷 보고 원인 찾아줘"

이 한 줄이면 된다.

그 외 활용

  • 차트/그래프 분석: "이 그래프에서 가장 급격한 변화가 일어난 시점은?" → 이미지를 읽고 데이터를 추출해서 답해준다
  • 다이어그램 해석: 아키텍처 다이어그램을 올리고 "이 구조의 문제점은?" → 구조를 이해하고 개선점을 제안
  • UI 리뷰: 디자인 스크린샷을 올리고 "UX 관점에서 개선할 점은?" → 구체적인 피드백

텍스트로 설명하면 3분 걸리는 걸, 스크린샷 하나로 3초에 끝낸다.

6. 마크다운 렌더링 + LaTeX 수식

이건 학생이나 연구자에게 특히 중요하다.

Claude는 마크다운을 완벽하게 지원한다. 표, 코드 블록, 리스트, 헤더, 볼드, 이탤릭 — 모든 마크다운 문법이 렌더링된다. 여기까지는 다른 AI도 비슷하다.

차별점은 LaTeX 수식 지원이다.

$$E = mc^2$$

$$\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2}$$

이런 수식을 Claude에게 물어보면, 깨진 텍스트가 아니라 예쁘게 렌더링된 수식으로 보여준다.

이렇게 쓴다

  • "이 미분방정식을 풀어줘" → 풀이 과정을 수식으로 단계별 표시
  • "이 논문의 수식을 설명해줘" → 각 기호의 의미를 수식과 함께 해설
  • "이 데이터를 표로 정리해줘" → 마크다운 테이블로 깔끔하게 정리

수학, 물리, 통계를 다루는 사람이라면 이 기능 하나만으로도 Claude를 쓸 이유가 된다.

7. 긴 대화에서의 "요약" 활용법

Claude와 대화가 길어지면 문제가 생긴다. 컨텍스트 윈도우가 유한하기 때문이다. 아무리 크다 해도 한계가 있다.

Claude는 대화가 길어지면 이전 내용을 자동으로 요약해서 기억한다. 하지만 수동으로 관리하면 훨씬 정확하다.

실전 팁

중간 요약 요청하기: 대화가 20~30턴 넘어가면, 이렇게 한 번 끊어줘라.

지금까지 대화 내용을 핵심만 정리해줘. 결정된 사항, 미결 사항, 다음 할 일.

Claude가 요약한 걸 확인하고, 틀린 부분이 있으면 바로 교정해줘라. 이게 이후 대화의 정확도를 크게 올린다.

중요한 내용은 반복해라: 대화 초반에 했던 중요한 결정이 나중에 무시되는 느낌이 들면, 다시 한 번 언급해줘라. "아까 정한 거지만 다시 확인하면, X는 Y 방식으로 한다." 이 한 줄이 결과물의 일관성을 지켜준다.

새 대화 시작도 전략이다: 대화가 너무 길어져서 Claude가 맥락을 놓치는 것 같으면, 요약본을 복사해서 새 대화에 붙여넣고 시작하는 게 더 나을 때가 있다. 깔끔한 컨텍스트에서 다시 시작하면 응답 품질이 눈에 띄게 올라간다.

8. CSV/엑셀 데이터 분석

Claude에게 CSV 파일을 업로드하면, 자동으로 구조를 파악하고 분석해준다. 엑셀 파일도 된다.

이게 왜 강력하냐면

전문 데이터 분석 도구 없이도, 자연어로 데이터를 탐색할 수 있기 때문이다.

"이 CSV의 월별 매출 트렌드를 분석해줘"
"가장 매출이 높은 상위 10개 상품을 뽑아줘"
"이 데이터에서 이상치가 있는지 확인해줘"

이렇게 말하면 Claude가 데이터를 읽고, 분석하고, 결과를 표로 정리해준다.

시각화까지 한 번에

"이 데이터의 월별 트렌드를 시각화하는 Python 코드를 만들어줘"

이러면 matplotlib이나 plotly를 사용한 시각화 코드를 Artifacts에 생성해준다. 그 코드를 복사해서 Jupyter Notebook이나 로컬에서 실행하면 바로 차트가 나온다.

실제 활용 사례

  • 마케팅 데이터: 캠페인별 전환율 비교 → 표 + 차트 코드
  • 매출 데이터: 월별/분기별 트렌드 분석 → 인사이트 요약 + 시각화
  • 서베이 결과: 응답 분포 분석 → 크로스탭 + 통계 요약
  • 서버 로그: 에러 빈도 분석 → 패턴 감지 + 알람 기준 제안

Excel이나 Google Sheets로 피벗 테이블을 돌리는 것보다 빠를 때가 많다. 특히 "이 데이터에서 뭘 봐야 하는지 모르겠을 때" Claude에게 던지면 탐색적 분석을 해준다.

9. 다국어 동시 처리 — 언어 장벽이 사라진다

이건 한국 사용자에게 특히 유용한 기능이다.

영어 문서를 업로드하고 한국어로 질문하면, 한국어로 답변한다. 당연한 것 같지만, 실제로 해보면 놀라울 정도로 자연스럽다.

실전 시나리오

영어 API 문서 → 한국어 사용법 정리

이 영어 API 문서를 읽고, 자주 쓰는 엔드포인트 5개의 사용법을 한국어로 정리해줘.
요청/응답 예시 포함.

영어 문서를 하나하나 읽으며 번역하는 것보다 10배 빠르다.

다국어 혼합 문서 처리

영어, 일본어, 한국어가 섞인 기술 문서? Claude는 각 언어를 이해하고, 지정한 언어로 통합 정리해준다.

기술 질문은 영어로, 설명은 한국어로

이건 고급 팁인데, 기술적 질문을 영어로 하면 Claude의 응답 품질이 올라가는 경우가 있다. 영어 학습 데이터가 더 많기 때문이다. 그래서 이런 하이브리드 전략이 통한다:

Explain the difference between HTTP/2 server push and WebSocket in terms of use cases and performance tradeoffs. 한국어로 답변해줘.

영어로 질문해서 정확도를 높이고, 한국어 답변으로 이해하기 쉽게. 기술 블로그를 쓰거나 공부할 때 이 패턴을 자주 쓴다.

10. Claude Code — AI가 내 컴퓨터에서 직접 코딩

이건 위의 9가지와는 차원이 다른 기능이다. 웹의 Claude가 "대화하는 AI"라면, Claude Code는 내 컴퓨터에서 직접 일하는 AI다.

터미널에서 claude를 실행하면 대화형 인터페이스가 뜨고, Claude가 실제로 파일을 읽고, 수정하고, 명령어를 실행한다.

뭐가 다르냐면

  • 웹의 Claude: "이 코드를 이렇게 수정해" → 수정된 코드를 보여줌 → 내가 직접 복사해서 붙여넣기
  • Claude Code: "이 파일의 버그를 고쳐줘" → 파일을 직접 열어서 수정함 → 끝

파일을 읽고, 쓰고, 터미널 명령어를 실행하고, git 커밋까지 한다. 코드 리뷰, 리팩토링, 테스트 작성, 버그 수정 — 개발 워크플로우의 상당 부분을 Claude Code가 처리할 수 있다.

간단한 예시

# 터미널에서
claude

# Claude Code 안에서
> 이 프로젝트의 구조를 파악하고, README를 작성해줘
> 테스트 커버리지가 낮은 파일을 찾아서 테스트를 추가해줘
> 이 함수의 성능을 개선해줘

Claude Code에 대해서는 할 말이 훨씬 많다. 이건 별도 글에서 자세히 다뤘으니, 관심 있으면 아래 관련글 링크를 참고해라.

보너스: 잘 안 알려진 팁 3가지

위 10가지 외에 추가로 알아두면 좋은 것들이다.

1. 빈 대화에서 시작하라

이전 대화의 맥락이 오히려 방해가 되는 경우가 생각보다 많다. "아까 말한 그 방식으로..."라고 하면 Claude가 이전 맥락을 끌고 오는데, 새로운 주제라면 이게 독이 된다. 주제가 바뀌면 새 대화를 여는 게 거의 항상 정답이다.

2. "다시 해줘" 대신 구체적 피드백

Claude의 답변이 마음에 안 들 때 "다시 해줘"는 최악의 프롬프트다. Claude는 뭐가 마음에 안 들었는지 모르기 때문에, 비슷한 결과를 약간만 바꿔서 내놓는다.

이렇게 바꿔라:

나쁜 피드백 좋은 피드백
"다시 해줘" "더 짧게, 핵심만 3줄로"
"좀 더 잘 써줘" "예시를 2개 추가하고 결론을 명확하게"
"코드가 별로야" "에러 처리를 추가하고 변수명을 명확하게 바꿔줘"

구체적 피드백 한 번이 모호한 재생성 다섯 번보다 낫다.

3. 영어 → 한국어 하이브리드 전략

9번에서도 언급했지만 다시 강조한다. 기술적으로 정확한 답이 필요할 때:

What are the tradeoffs between microservices and modular monolith? 
실제 경험 기반으로 한국어로 답변해줘.

이 패턴은 특히 최신 기술 토픽에서 효과가 크다. 영어 자료가 훨씬 많기 때문에, 영어로 질문하면 Claude가 더 풍부한 지식을 활용한다. 한국어 답변을 지정하면 이해하기도 편하다. 양쪽의 장점을 다 가져가는 전략이다.

요약

기능 핵심 포인트 난이도
Projects 프로젝트별 맞춤 AI 환경 쉬움
시스템 프롬프트 구체적일수록 좋다 중간
Artifacts 코드 미리보기 + 버전 관리 쉬움
모델 전환 상황에 맞게 Opus/Sonnet 전환 쉬움
이미지 분석 스크린샷으로 에러 해결 쉬움
LaTeX 수식 학생/연구자 필수 쉬움
대화 요약 중간중간 수동 요약 요청 중간
CSV 분석 자연어로 데이터 탐색 쉬움
다국어 처리 영어 질문 + 한국어 답변 쉬움
Claude Code 터미널에서 직접 코딩 높음

10가지 중에서 당장 쓸 수 있는 건 Projects와 Artifacts다. 이 두 개만 제대로 써도 Claude 활용도가 확 달라진다. 나머지는 필요할 때 하나씩 시도해보면 된다.

Claude는 대화형 AI가 아니라 작업 도구다. 도구는 기능을 알아야 제대로 쓸 수 있다.


관련글:

profile

ClOr

@ClOr

포스팅이 좋았다면 "좋아요❤️" 또는 "구독👍🏻" 해주세요!

ClOr · 백엔드 트러블슈팅과 AI 에이전트 구조 분석을 기록합니다.