Mastering Claude Code in 30 minutes
개요
이 세션은 Anthropic의 기술 스태프 Boris가 진행한 Claude Code의 실전 활용법에 관한 기술 강연이다. 이론이나 역사보다는 실무에서 즉시 적용 가능한 팁과 트릭에 집중하며, Claude Code를 처음 접하는 사용자부터 고급 사용자까지 단계별로 활용법을 제시한다. 강연은 기본 설정부터 시작하여 코드베이스 탐색, 편집, 도구 통합, 컨텍스트 관리, SDK 활용까지 포괄하며, Anthropic 내부에서 실제로 사용하는 워크플로우와 베스트 프랙티스를 공유한다.
Claude Code의 본질: 차세대 AI 코딩 어시스턴트
Claude Code는 기존의 AI 코딩 도구들과 근본적으로 다른 접근을 취한다. 대부분의 AI 코딩 어시스턴트가 한 줄 또는 몇 줄의 코드 자동완성에 집중했다면, Claude Code는 완전히 에이전틱(agentic)한 방식으로 작동한다. 이는 단순한 코드 조각 생성이 아니라 전체 기능 구현, 완전한 함수 작성, 여러 파일에 걸친 버그 수정 등 훨씬 더 큰 단위의 작업을 수행할 수 있다는 의미다.
Claude Code의 핵심 강점은 사용자의 기존 워크플로우를 침해하지 않는다는 점이다. VS Code, Xcode, JetBrains IDE 등 어떤 IDE를 사용하든, 심지어 Vim이나 Emacs 같은 텍스트 에디터를 사용하든 상관없이 동작한다. 로컬 환경, 원격 SSH, TMUX 등 어떤 개발 환경에서도 실행 가능하다. 이러한 범용성은 터미널 기반 도구라는 설계 선택에서 비롯된다.
제품의 자유도가 높은 만큼, 처음 사용자는 빈 프롬프트 바를 보고 막막함을 느낄 수 있다. 하지만 이는 의도된 설계다. Claude Code는 특정 워크플로우를 강요하지 않으며, 엔지니어가 원하는 방식대로 사용할 수 있도록 파워 툴로 설계되었다.
초기 설정: 개발 환경 최적화
Claude Code를 처음 설치한 후 권장되는 초기 설정 단계들이 있다.
터미널 설정 개선
run terminal setup 명령을 실행하면 Shift+Enter로 새 줄을 입력할 수 있게 된다. 이는 백슬래시 없이도 여러 줄의 프롬프트를 작성할 수 있게 해주어 사용성을 크게 향상시킨다.
테마 커스터마이징
/theme 명령으로 라이트 모드, 다크 모드, 또는 색맹 지원 테마를 설정할 수 있다.
GitHub 앱 통합
/install GitHub app 명령으로 GitHub 앱을 설치하면, GitHub 이슈나 풀 리퀘스트에서 Claude를 멘션할 수 있다. 이는 강연 당일 발표된 새 기능이다.
허용 도구 커스터마이징
자주 사용하는 도구들을 미리 허용 목록에 추가해두면 매번 승인을 요청받지 않아도 된다. 반복적으로 프롬프트되는 작업에 대해서는 이 설정이 워크플로우를 크게 개선한다.
음성 입력 활용
macOS 사용자의 경우, 시스템 설정의 접근성 메뉴에서 받아쓰기를 활성화할 수 있다. 받아쓰기 키를 두 번 누르면 음성으로 프롬프트를 입력할 수 있으며, 이는 타이핑보다 훨씬 자연스럽게 엔지니어와 대화하듯 작업할 수 있게 해준다. Boris는 이 방법을 자주 사용한다고 강조했다.
Level 1: 코드베이스 Q&A - 가장 효과적인 시작점
Claude Code를 처음 시작하는 사람들에게 Boris가 가장 강력히 추천하는 활용법은 **코드베이스에 대한 질문하기(Code-based Q&A)**다. 이는 Anthropic의 신입 엔지니어 온보딩 과정에서 첫날 기술 교육에 포함될 정도로 중요하게 다뤄진다.
전통적인 온보딩 과정에서는 팀원들에게 질문하고, 코드베이스를 탐색하고, 도구 사용법을 익히는 데 상당한 시간이 소요되었다. Anthropic에서는 기술 인력 온보딩이 2~3주 걸렸지만, Claude Code 도입 후 2~3일로 단축되었다.
Claude Code의 Q&A 기능이 특별한 이유는 별도의 인덱싱이 필요 없다는 점이다. 원격 데이터베이스에 코드를 업로드하지 않으며, 코드는 로컬에 유지되고, 생성 모델 학습에도 사용되지 않는다. 인덱스 구축 과정이 없으므로 설치 후 즉시 사용할 수 있다.
효과적인 질문 예시들:
-
사용법 탐색: “이 특정 코드 조각은 어떻게 사용되나요?” 또는 “이 클래스를 어떻게 인스턴스화하나요?”
Claude Code는 단순 텍스트 검색을 넘어 실제 사용 예시를 찾아내고 더 깊이 있는 답변을 제공한다. 문서나 위키에서 얻을 수 있는 수준의 정보를 제공하며, 단순한 Ctrl+F 검색과는 차원이 다르다. -
Git 히스토리 분석: “왜 이 함수는 15개의 인자를 가지고 있나요? 왜 인자 이름이 이렇게 이상하게 지어졌나요?”
Boris는 이 방법을 Anthropic의 모든 코드베이스에서 사용한다고 밝혔다. Claude Code는 Git 히스토리를 탐색하여 각 인자가 언제, 누구에 의해, 어떤 상황에서 추가되었는지, 연결된 이슈는 무엇인지 등을 종합하여 요약한다. 사용자가 세부적인 지시를 할 필요 없이 “look through git history”라고만 하면 된다. 이것이 가능한 이유는 시스템 프롬프트에 특별히 명시되어 있기 때문이 아니라, 모델 자체가 뛰어나기 때문이다. -
GitHub 이슈 조회: Web fetch 기능을 사용하여 GitHub 이슈를 가져오고 컨텍스트를 파악할 수 있다.
-
주간 업무 요약: Boris는 매주 월요일 스탠드업 미팅에서 “What did I ship this week?”라고 질문한다. Claude Code가 Git 로그를 확인하고 사용자명을 파악하여 그 주에 배포한 모든 것을 정리해준다. 이를 그대로 복사하여 문서에 붙여넣으면 된다.
온보딩 전략:
팀에 Claude Code를 처음 소개할 때는 화려한 도구 사용이나 코드 편집부터 시작하지 말고, 코드베이스에 대한 질문으로 시작하는 것이 좋다. 이를 통해 사람들은 프롬프팅 방법을 배우고, Claude Code가 무엇을 할 수 있는지, 어떤 작업은 한 번에 가능하고 어떤 작업은 여러 단계가 필요한지, 또는 대화형 모드가 필요한지를 이해하게 된다.
Level 2: 코드 편집 - 에이전틱 도구 활용의 마법
코드베이스 Q&A에 익숙해지면 다음 단계는 코드 편집이다. LLM을 에이전틱 방식으로 사용할 때의 핵심은 도구를 제공하면 모델이 마법처럼 도구 사용 방법을 스스로 파악한다는 것이다.
Claude Code는 비교적 작은 도구 세트를 제공한다:
- 파일 편집 도구
- Bash 명령 실행 도구
- 파일 검색 도구
모델은 이 도구들을 조합하여 코드를 탐색하고, 브레인스토밍하고, 최종적으로 편집을 수행한다. 사용자가 “이 도구를 사용하고 저 도구를 사용하라”고 구체적으로 지시할 필요가 없다. 그냥 “이 작업을 해줘”라고 하면 알아서 적절한 방식으로 도구들을 조합한다.
계획 수립의 중요성
Claude가 코드 작성에 뛰어들기 전에 브레인스토밍이나 계획을 세우도록 요청하는 것이 매우 효과적이다. Boris는 이를 강력히 추천한다.
때때로 사람들은 Claude Code에게 3,000줄짜리 거대한 기능을 구현하라고 요청한다. 가끔은 첫 시도에서 성공하기도 하지만, 때로는 구축된 결과물이 전혀 원하는 것과 다를 수 있다. 원하는 결과를 얻는 가장 쉬운 방법은 먼저 생각하도록 요청하는 것이다.
아이디어를 브레인스토밍하고, 계획을 세우고, 코드를 작성하기 전에 승인을 받아줘.
특별한 플랜 모드나 도구를 사용할 필요 없다. Claude에게 요청만 하면 된다. “코드를 작성하기 전에 계획을 세워줘.” 그게 전부다.
자주 사용하는 명령어 패턴
Commit, Push, PR 생성:
commit push pr
이것은 Boris가 자주 사용하는 주문(incantation)이다. 특별한 것은 없지만 Claude가 충분히 똑똑해서 이를 해석한다. 커밋을 만들고, 브랜치에 푸시하고, 브랜치를 생성하고, GitHub에 풀 리퀘스트를 만든다. 아무것도 설명할 필요 없다. Claude가 코드와 히스토리와 Git 로그를 스스로 확인하여 커밋 포맷과 모든 세부사항을 파악하고 올바른 방식으로 커밋하고 푸시한다. 이것 역시 시스템 프롬프트에 명시되어 있지 않고, 모델이 그냥 좋기 때문에 가능하다.
Level 3: 팀 도구 통합 - Claude Code의 진정한 힘
조금 더 고급 단계로 넘어가면 팀의 도구들을 연결하기 시작하게 되고, 이것이 바로 Claude Code가 진정으로 빛을 발하는 지점이다.
일반적으로 두 가지 유형의 도구가 있다:
배치 도구(Batch Tools)
예시로 “Barley CLI”라는 가상의 CLI 도구를 들었다. 사용법은 다음과 같다:
이 CLI를 사용해서 [작업]을 해줘. --help 플래그를 사용해서 사용법을 알아봐.
Claude Code에게 이 도구에 대해 알려주면 --help를 사용하여 사용법을 파악하도록 할 수 있다. 이것이 효율적이며, 자주 사용한다면 Claude.md 파일에 넣어서 세션 간에 기억하도록 할 수 있다.
이것은 Anthropic 내부에서 사용하는 일반적인 패턴이며, 외부 고객들도 마찬가지로 사용한다.
MCP 도구
MCP(Model Context Protocol) 도구도 동일하게 작동한다. 도구에 대해 알려주고 사용법을 설명하면 Claude가 사용하기 시작한다. 이것은 극도로 강력하다. 새로운 코드베이스에서 Claude Code를 사용하기 시작할 때, 팀이 이미 사용하는 모든 도구를 Claude에게 제공하면 Claude가 대신 사용할 수 있다.
피드백 루프가 있는 워크플로우의 위력
일반적으로 세 가지 워크플로우가 있다:
-
탐색 → 계획 → 확인 요청 → 코드 작성
앞서 설명한 패턴 -
피드백 기반 반복 워크플로우
이것이 특히 강력하다. Claude가 자신의 작업을 확인할 수 있는 방법이 있을 때(예: 유닛 테스트 작성, Puppeteer로 스크린샷 찍기, iOS 시뮬레이터 스크린샷 등), Claude는 반복(iterate)할 수 있다.예를 들어 목업(mock)을 주고 “이 웹 UI를 만들어줘”라고 하면 꽤 잘 만든다. 하지만 2~3번 반복하도록 하면 거의 완벽하게 만든다. 핵심은 피드백을 받아 작업을 확인할 수 있는 도구를 제공하는 것이다. 그러면 Claude가 스스로 반복하며 훨씬 더 나은 결과를 얻을 수 있다.
도메인이 유닛 테스트든, 통합 테스트든, 앱이나 웹 스크린샷이든 상관없이, 결과를 볼 수 있는 방법을 제공하면 Claude가 반복하며 개선한다.
다음 단계:
- Claude가 팀의 도구를 사용하는 방법을 가르친다
- 올바른 워크플로우를 파악한다: Claude가 즉시 코드에 뛰어들기를 원하는지, 브레인스토밍하고 계획을 세우기를 원하는지, 반복하기를 원하는지 등을 이해하여 원하는 대로 프롬프트하는 방법을 안다
Level 4: 컨텍스트 관리 - 더 똑똑한 결정을 위한 정보 제공
도구를 넘어서 더 깊이 들어가면 Claude에게 더 많은 컨텍스트를 제공해야 한다. 컨텍스트가 많을수록 더 똑똑한 결정을 내릴 수 있다. 코드베이스에서 작업하는 엔지니어로서 시스템과 모든 히스토리에 대한 엄청난 양의 컨텍스트가 머릿속에 있다. Claude에게도 이를 제공하는 다양한 방법이 있으며, 컨텍스트를 더 많이 제공할수록 성능이 향상된다.
Claude.md 파일
가장 간단한 방법은 Claude.md라는 특수한 파일명을 사용하는 것이다.
프로젝트 루트 Claude.md:
- 프로젝트 루트(Claude를 시작하는 디렉토리)에 Claude.md를 두면 모든 세션 시작 시 자동으로 컨텍스트로 읽힌다
- 첫 번째 사용자 턴에 Claude.md가 포함된다
- 소스 컨트롤에 체크인해야 하며, 팀과 공유하여 한 번 작성하면 팀 전체가 활용할 수 있다
로컬 Claude.md:
- 개인용으로 소스 컨트롤에 체크인하지 않는다
- 개인 선호도나 설정에 사용
Claude.md에 포함할 내용:
- 일반적인 Bash 명령어
- 일반적인 MCP 도구
- 아키텍처 결정사항
- 중요한 파일들
- 코드베이스에서 작업하기 위해 일반적으로 알아야 할 모든 것
작성 팁:
- 가능한 한 짧게 유지한다. 너무 길면 컨텍스트를 많이 소모하고 대개 유용하지 않다
- Anthropic의 코드베이스에는 일반적인 Bash 명령어, 스타일 가이드, 몇 가지 핵심 파일 등이 포함되어 있다
중첩 디렉토리의 Claude.md:
- 다른 중첩된 하위 디렉토리에 Claude.md를 두면 Claude가 해당 디렉토리에서 작업할 때 온디맨드로 가져온다
- 자동으로 가져와지는 것은 프로젝트 루트와 로컬 Claude.md뿐이지만, 중첩 디렉토리의 Claude.md는 해당 디렉토리에서 작업할 때 자동으로 가져와진다
엔터프라이즈 루트:
- 회사 차원에서 모든 코드베이스에 공유되는 Claude.md를 관리하고 싶다면 엔터프라이즈 루트에 둘 수 있다
- 사용자를 대신하여 관리되며 자동으로 가져와진다
슬래시 명령어(Slash Commands)
.claude/commands 디렉토리를 사용하여 슬래시 명령어를 정의할 수 있다. 홈 디렉토리나 프로젝트에 체크인할 수 있다.
Anthropic의 예시: Claude Code 레포지토리에서 실제로 사용하는 슬래시 명령어들이 있다. 예를 들어 “label GitHub issues”라는 명령어는 GitHub 이슈에 레이블을 자동으로 붙인다. GitHub 액션이 이 슬래시 명령어를 실행하여 사람이 수동으로 할 필요 없이 이슈에 레이블을 붙인다.
컨텍스트 제공의 다양한 방법
| 방법 | 설명 |
|---|---|
| Claude.md | 자동으로 가져와짐 |
| 슬래시 명령어 | .claude/commands에 정의 |
| 파일 멘션 | @filename으로 컨텍스트에 추가 |
| 중첩 디렉토리 Claude.md | 해당 디렉토리에서 작업 시 자동 가져오기 |
컨텍스트 튜닝의 중요성
컨텍스트를 튜닝하는 데 시간을 투자할 가치가 있다:
- 프롬프트 개선기(prompt improver)를 통해 실행
- 컨텍스트가 누구를 위한 것인지 고려: 매번 가져올 것인지, 온디맨드로 가져올 것인지, 팀과 공유할 것인지, 개인 선호도인지
- 올바르게 수행하면 성능이 극적으로 향상된다
Level 5: 계층적 구성 관리 - 엔터프라이즈 스케일
더 고급 단계로 가면 모든 것을 가져오는 계층적 방법에 대해 생각해야 한다. Claude.md뿐만 아니라 설정과 Claude에 관한 모든 것을 계층적으로 가져올 수 있다.
구성 계층 구조
프로젝트별 → 전역 → 엔터프라이즈
프로젝트 수준:
- Git 레포지토리에 특정
- 체크인하거나 개인용으로 만들 수 있음
전역 수준:
- 모든 프로젝트에 걸쳐 적용
- 개인 설정
엔터프라이즈 정책:
- 전역 설정과 본질적으로 동일하지만 모든 직원/팀원에게 자동으로 배포됨
적용 범위
이 계층 구조는 다양한 기능에 적용된다:
슬래시 명령어:
- 모든 직원이 사용하는 테스트 명령어가 있다면 엔터프라이즈 정책 파일에 체크인
- 해당 명령어를 실행할 때 자동 승인됨
권한 관리:
- 명령어를 자동 승인하여 사람들을 언블록
- 명령어를 차단하여 코드베이스 안전성 확보
- 예: 절대 가져와서는 안 되는 URL이 있다면 이 설정에 추가하면 직원이 오버라이드할 수 없으며 해당 URL은 절대 가져와지지 않음
MCP 서버:
- MCP JSON 파일을 코드베이스에 체크인
- 코드베이스에서 Claude Code를 실행하는 사람은 MCP 서버 설치를 프롬프트받고 팀과 공유됨
권장 시작점
이 복잡한 매트릭스가 혼란스럽다면(Anthropic이 많은 것을 지원하고, 엔지니어 워크플로우는 매우 유연하며, 모든 회사가 다르므로 모든 것을 지원하려고 함), 공유 프로젝트 컨텍스트로 시작하는 것을 권장한다.
한 번 작성하면 팀의 모든 사람과 공유되어 네트워크 효과를 얻을 수 있다. 누군가가 약간의 작업을 하면 팀 전체가 혜택을 받는다.
관리 도구
Claude에는 이를 관리하는 다양한 도구가 내장되어 있다:
/memory 명령어:
- 가져와지는 모든 메모리 파일을 볼 수 있음
- 예: 엔터프라이즈 정책, 사용자 메모리, 프로젝트 Claude.md, 특정 디렉토리에만 가져와지는 중첩 Claude.md
- 특정 메모리 파일을 편집할 수 있음
# 기호로 기억하기:
#을 입력하고 무언가를 기억하라고 하면 어떤 메모리에 저장할지 선택할 수 있음
실제 사용 예시: Puppeteer MCP 서버
Anthropic의 앱 레포지토리(모든 웹 및 앱 코드가 있는 레포)에는 Puppeteer MCP 서버가 있고 팀과 공유된다. MCP JSON이 체크인되어 있어서 해당 레포에서 작업하는 모든 엔지니어가 Puppeteer를 사용하여 엔드투엔드 테스트를 진행하고 자동으로 스크린샷을 찍고 반복할 수 있다. 각 엔지니어가 직접 설치할 필요가 없다.
실용적인 키 바인딩과 단축키
터미널용으로 개발하는 것은 매우 어렵지만 동시에 재미있다. 새로운 디자인 언어를 재발견하는 느낌이다. 하지만 터미널은 극도로 미니멀하기 때문에 키 바인딩을 발견하기 어려울 수 있다.
주요 키 바인딩 참조표
| 키 | 기능 | 상세 설명 |
|---|---|---|
Shift + Tab | 자동 편집 수락 모드 | Bash 명령어는 여전히 승인 필요하지만 편집은 자동 수락. Claude가 올바른 방향으로 가고 있거나 유닛 테스트를 작성하고 반복할 때 유용 |
# | 기억하기 | Claude가 도구를 올바르게 사용하지 않을 때 앞으로 올바르게 사용하도록 기억시킴. 자동으로 Claude.md에 통합됨 |
! | Bash 모드 | Bash 명령어 실행. 로컬에서 실행되지만 컨텍스트 윈도우에도 들어감. Claude가 다음 턴에서 명령어와 출력을 볼 수 있음. 정확히 원하는 것을 알고 있는 긴 실행 명령어나 컨텍스트에 넣고 싶은 명령어에 유용 |
@ | 파일/폴더 멘션 | 파일과 폴더를 컨텍스트에 추가 |
Esc | 중단 | Claude가 무엇을 하든 안전하게 중단 가능. 세션을 손상시키거나 망가뜨리지 않음. 예: 파일 편집 중 Esc를 누르고 다르게 해야 할 것을 말하거나, 20줄 편집 제안 중 19줄은 완벽하지만 1줄은 변경해야 할 때 Esc를 누르고 그것을 말한 다음 재편집 요청 |
Esc 두 번 | 히스토리로 점프 | 이전 대화 내역으로 이동 |
--resume | 세션 재개 | 세션 종료 후 이전 세션 재개 |
--continue | 계속하기 | 세션을 이어서 진행 |
Ctrl + R | 전체 출력 보기 | Claude가 컨텍스트 윈도우에서 보는 것과 동일한 전체 출력 표시 |
Claude Code SDK: 프로그래밍 가능한 AI 유틸리티
Claude Code SDK는 강연 바로 다음 Sid가 심층적으로 다룰 예정이었다. -p 플래그를 사용하면 이것이 바로 SDK다. 최근 몇 주 동안 더 나아지게 만드는 많은 기능들이 추가되었다.
CLI SDK 기본 사용법
claude -p [프롬프트] --allowed-tools [도구들] --format [포맷]특징:
- 프롬프트 전달 가능
- 특정 Bash 명령어를 포함한 허용 도구 지정 가능
- 원하는 포맷 지정 가능 (JSON, 스트리밍 JSON 등)
활용 사례:
- CI에서 사용
- 인시던트 대응
- 각종 파이프라인
개념:
Unix 유틸리티처럼 생각하면 된다. 프롬프트를 주면 JSON을 준다. 파이프로 입력하고 파이프로 출력할 수 있다.
파이프 활용 예시
Git 상태 확인 및 결과 선택:
git status | claude -p "..." | jq -r '.result'GCP 버킷에서 로그 읽기:
gsutil cat gs://bucket/huge.log | claude -p "이 로그에서 흥미로운 점이 뭔가요?"Sentry CLI 데이터 가져오기:
sentry-cli ... | claude -p "이 데이터로 무언가 해줘"조합은 무한하다. 슈퍼 인텔리전트 Unix 유틸리티라는 새로운 아이디어이며, 이를 어떻게 사용할지 이제 막 파악하기 시작했을 뿐이다.
고급 활용: 병렬 작업과 세션 관리
Boris 자신은 “Claude 일반 사용자(Claude normie)“라고 표현하며 보통 한 번에 하나의 Claude만 실행하고 여러 레포를 위해 몇 개의 터미널 탭을 가지고 있을 뿐이라고 했다.
하지만 Anthropic 내외부의 파워 유저들을 보면 거의 항상:
- SSH 세션을 사용
- Claude 세션으로의 TMUX 터널을 가지고 있음
- 동일한 레포의 여러 체크아웃을 가지고 있어서 해당 레포에서 여러 Claude를 병렬로 실행
- Git worktree를 사용하여 어느 정도 격리를 유지하며 작업
Anthropic은 이를 더 쉽게 사용할 수 있도록 적극적으로 작업 중이다. 현재로서는 Claude와 병렬로 더 많은 작업을 수행하는 방법에 대한 아이디어들이다. 원하는 만큼 많은 세션을 실행할 수 있으며 병렬로 많은 것을 해낼 수 있다.
설계 철학과 미래 비전
왜 IDE가 아닌 CLI인가?
Boris는 이에 대해 두 가지 이유를 제시했다:
1. 도구 다양성 지원:
Anthropic에서 시작했을 때 사람들은 광범위한 IDE를 사용했다. VS Code, Zed, Xcode, Vim, Emacs 등. 모두를 위해 작동하는 무언가를 만드는 것은 어려웠다. 터미널은 그냥 공통 분모였다.
2. 모델의 빠른 발전:
Anthropic은 모델이 얼마나 빠르게 좋아지는지 가까이서 본다. 연말까지 사람들이 더 이상 IDE를 사용하지 않을 가능성이 충분히 있다. 이러한 미래를 준비하고 싶고, UI와 다른 레이어에 과도하게 투자하는 것을 피하고 싶다. 모델이 발전하는 방식을 고려하면 곧 유용한 작업이 아닐 수 있다.
기계학습 모델링에서의 활용
Anthropic에서 Claude Code를 기계학습과 모델링에 얼마나 사용하는지에 대한 질문에 Boris는 실제로 많이 사용한다고 답했다. Anthropic의 엔지니어와 연구원 모두 매일 Claude Code를 사용한다. 기술직 직원의 약 80%가 매일 Claude Code를 사용한다. 제품에 쏟아부은 애정과 독스푸딩(dogfooding)을 볼 수 있을 것이다.
여기에는 노트북 도구(notebook tool)를 사용하여 노트북을 편집하고 실행하는 연구원들도 포함된다.
구현의 기술적 도전 과제
가장 어려운 구현 부분에 대한 질문에 Boris는 Bash 명령어를 안전하게 만드는 작업을 꼽았다.
Bash는 본질적으로 상당히 위험하며 예상치 못한 방식으로 시스템 상태를 변경할 수 있다. 동시에 모든 Bash 명령어를 수동으로 승인해야 한다면 엔지니어로서 매우 성가시고 생산성이 떨어진다. 계속해서 모든 명령어를 승인하느라 시간을 보내게 된다.
모든 사람이 Docker 컨테이너에서 코드를 실행하는 것은 아니기 때문에 다양한 종류의 코드베이스에 걸쳐 안전하게 확장 가능한 방식으로 이를 수행하는 것이 꽤 까다로웠다.
해결 방법:
- 읽기 전용 명령어가 있음
- 어떤 명령어가 안전한 방식으로 결합될 수 있는지 파악하기 위해 정적 분석 수행
- 다양한 레벨에서 명령어를 허용 목록에 추가하고 차단 목록에 추가할 수 있는 꽤 복잡한 계층적 권한 시스템
멀티모달 기능: 숨겨진 보석
Claude Code가 이미지를 받아들일 수 있다는 언급에 대해 질문이 있었다. Boris는 Claude Code가 처음부터 완전히 멀티모달이라고 확인했다.
터미널에서 실행되기 때문에 발견하기 어렵지만, 이미지를 드래그 앤 드롭하면 작동한다. 파일 경로를 제공해도 작동한다. 이미지를 복사하여 붙여넣어도 작동한다.
활용 예시:
무언가의 목업이 있다면 그냥 드래그 앤 드롭하고,
구현하라고 말하고,
Puppeteer 서버를 제공하여 반복할 수 있게 하면,
완전히 자동화된다.
이는 프론트엔드 개발에서 특히 강력한 워크플로우다.
핵심 인사이트 요약
단계별 학습 경로
| 레벨 | 핵심 활동 | 목표 |
|---|---|---|
| Level 1 | 코드베이스 Q&A | 프롬프팅 학습, 경계 파악 |
| Level 2 | 코드 편집, 계획 수립 | 에이전틱 워크플로우 이해 |
| Level 3 | 팀 도구 통합 | 생산성 극대화 |
| Level 4 | 컨텍스트 관리 | 의사결정 품질 향상 |
| Level 5 | 엔터프라이즈 설정 | 팀 스케일 배포 |
성공을 위한 원칙
- 모델을 신뢰하라: 시스템 프롬프트에 명시하지 않아도 모델은 Git 사용법, 커밋 포맷 파악, 히스토리 탐색 등을 안다
- 계획을 세워라: 큰 작업은 코드 작성 전에 브레인스토밍과 승인 단계를 거친다
- 피드백 루프를 만들어라: Claude가 작업을 확인할 수 있는 도구를 제공하면 반복을 통해 거의 완벽한 결과를 얻는다
- 컨텍스트를 공유하라: 프로젝트 Claude.md를 사용하여 네트워크 효과를 활용한다
- 온보딩은 Q&A로: 새로운 사용자에게는 화려한 기능보다 코드베이스 질문부터 시작한다
생산성 지표
- 온보딩 시간: 2~3주 → 2~3일 (약 90% 단축)
- Anthropic 기술직 채택률: 약 80%가 매일 사용
- 자동화 사례: 주간 업무 요약, GitHub 이슈 레이블링, 커밋 메시지 작성 등
Claude Code는 단순한 코드 완성 도구가 아니라 엔지니어의 워크플로우 전체를 재정의하는 에이전틱 AI 플랫폼이다. 터미널 기반이라는 선택은 모든 환경과 도구와의 호환성을 보장하며, 강력한 모델과 유연한 도구 통합, 그리고 계층적 컨텍스트 관리를 통해 개인 개발자부터 엔터프라이즈 팀까지 확장 가능한 솔루션을 제공한다.