이 강연은 누가, 무엇을 이야기했나

강연자는 Boris, Anthropic의 Member of Technical Staff이자 Claude Code의 창조자다. 28분 강연에서 그는 이론과 역사적 배경을 완전히 건너뛰고, 「Claude Code를 평소에 어떻게 사용하는가」를 직접 시연했다.

이 강연의 가치는 Boris가 수많은 세부 사항을 다뤘다는 점에 있다——# 키로 CLAUDE.md에 자동 기록하기, Shift+Tab으로 auto-accept 전환, CLAUDE.md의 중첩 디렉터리 자동 로드, claude -p를 Unix 유틸리티로 파이프라인에 연결하기——이런 세부 내용은 docs에 적혀 있어도 잘 읽히지 않는다. 창조자가 직접 시연해야만 커뮤니티에 전달된다.

강연 핵심을 14가지로 정리하고 논리적 분류에 따라 배열했으며, 마지막에 개발자를 위한 takeaway 6개를 붙였다.

1. Claude Code란 무엇인가

보완 도구가 아닌, 완전한 에이전트 AI 어시스턴트다.

한 줄씩 코드를 자동 완성해 주는 종류가 아니라, 기능을 직접 만들고, 함수 전체를 작성하고, 버그 전체를 수정하는 방식으로 동작한다.

가장 편리한 점은 기존 IDE 워크플로와 충돌하지 않는다는 것이다. VS Code, Xcode, JetBrains, Vim, Emacs 어디서든 동시에 사용할 수 있다——Claude Code는 터미널, SSH, tmux 어디서든 실행되기 때문이다.

2. 초기 설정 (설치 후 먼저 할 4가지)

  1. /terminal-setup → Shift+Enter 줄 바꿈 설정 (백슬래시 불필요)
  2. /theme → light / dark / 색맹 친화 모드 설정
  3. /install-github-app → GitHub issue/PR에서 @claude 멘션하면 자동 응답
  4. macOS: 시스템 설정에서 Dictation 활성화 후 두 번 눌러 음성 입력 — 직접 말해서 프롬프트를 입력, 타이핑보다 훨씬 빠름

Boris는 대부분의 프롬프트를 말로 입력한다고 했다——타이핑보다 빠르며, 특히 긴 프롬프트나 요구사항을 설명할 때 유용하다.

3. 초보자는 코드 작성부터 서두르지 말고, 먼저 codebase Q&A를 활용하라

Boris가 초보자에게 주는 가장 강력한 조언: 코드 작성부터 시키지 말고, 먼저 codebase에 대한 질문을 던져라.

예시 질문:

  • 「이 함수는 어떻게 사용하나요?」
  • 「왜 이 함수에 파라미터가 15개나 있나요? 역사적 맥락이 무엇인가요?」
  • 「이 클래스는 어디서 인스턴스화되나요?」

Claude는 단순한 텍스트 검색에 그치지 않는다. git history를 살펴보고, GitHub 이슈를 추적해, 완전한 배경 정보를 제공해 준다.

Anthropic 내부 온보딩이 23주에서 23일로 단축됐다——신규 입사자가 시니어 엔지니어를 방해하지 않고 Claude에게 codebase 질문을 직접 하기 때문이다.

그리고 코드는 업로드되지 않으며, 인덱싱도 없고, 코드로 모델을 훈련시키지도 않는다. 바로 열어서 사용하면 된다. 인덱싱 대기 시간도 없다.

4. 매주 월요일 스탠드업 핵

Boris는 매주 월요일 스탠드업 전에 Claude에게 이렇게 묻는다고 한다:

「내가 이번 주에 뭘 출시했지?」

Claude가 자동으로 git log를 읽고 사용자명을 인식해, 깔끔한 요약을 출력한다. 그걸 doc에 붙여넣으면 끝이다.

git을 사용하는 모든 팀에 적용 가능하며, 주간 보고, 월간 보고, 분기 보고에도 활용할 수 있다.

5. 코드 작성 전에 먼저 계획하기 (plan mode 불필요)

가장 단순하고 효과적인 습관:

「먼저 계획을 세우고, 확인한 뒤에 코드 작성해줘.」

plan mode로 전환할 필요도, 특별한 도구도 필요 없다. 이렇게 말하는 것만으로 된다. Claude는 먼저 브레인스토밍하고 계획을 제시한 뒤, 확인을 기다렸다가 작업을 시작한다.

「3,000줄을 작성했는데 원하는 방향이 아닌」 상황을 사전에 방지할 수 있다.

또 자주 쓰는 주문:

「commit push PR」

Claude가 git log를 보고 커밋 형식을 스스로 학습하고, branch를 만들고, GitHub에 push하고, PR을 열어준다. 아무것도 설명할 필요가 없다.

6. 팀 도구 연동 — bash CLI + MCP

Claude Code를 팀 도구에 연동하는 방법은 두 가지다:

bash CLI: Claude에게 「이 CLI 사용해, --help 실행하면 사용법 알 수 있어」라고 알려주면 된다.

MCP servers: 마찬가지로, 어떤 MCP가 있는지 알려주면 스스로 사용한다.

팁: 자주 쓰는 것은 CLAUDE.md에 기록해두면 (다음에 설명), 세션을 넘어 기억한다.

7. Claude에게 자가 검증 능력을 부여하면 → 스스로 iterate하며 더 나아진다

이 내용은 이번 강연에서 가장 가치 있는 개념 중 하나다.

Claude에게 자신의 작업을 확인할 수 있는 도구를 제공하기만 하면, 2~3번 스스로 iterate하며 거의 완벽한 수준에 도달한다.

  • 프론트엔드 작성? puppeteer 스크린샷을 제공
  • iOS 앱 작성? 시뮬레이터 스크린샷을 제공
  • 백엔드 작성? 유닛 테스트 / 통합 테스트를 제공
  • 어떤 분야든? 피드백 루프를 만들어주면 된다

Boris는 one-shot 결과는 보통 완벽하지 않지만, 피드백 루프를 주면 두세 번 iterate한 후 품질이 눈에 띄게 한 단계 올라간다고 강조했다.

8. CLAUDE.md: 가장 중요한 컨텍스트 도구

프로젝트 루트에 위치한 CLAUDE.md는 매 세션마다 자동으로 읽힌다.

무엇을 넣어야 하는가:

  • 자주 쓰는 bash 명령어
  • 자주 쓰는 MCP 도구
  • 중요한 아키텍처 결정 사항
  • 핵심 파일 위치
  • 규칙 및 스타일 가이드

주의 사항:

  • ⚠️ 간결하게 유지할 것. 너무 길면 컨텍스트 윈도를 낭비하며, 오히려 효과가 떨어진다.
  • 중첩 디렉터리에도 CLAUDE.md를 배치할 수 있으며, Claude가 해당 디렉터리에서 작업할 때 자동으로 로드된다.
  • 대기업은 enterprise 루트에 배치해 전사적으로 공유할 수 있다.

일반적인 구성은 ~/.claude/CLAUDE.md(개인 전역) + 각 프로젝트의 CLAUDE.md(프로젝트 레벨)이며, 중첩 디렉터리 부분은 대부분의 사람이 충분히 활용하지 못하고 있다——대형 monorepo에서 서브 디렉터리까지 세분화하면 더욱 정밀하게 동작한다.

9. Slash commands (자신만의 루틴 정의)

.claude/commands/를 홈 디렉터리 또는 프로젝트 루트에 두고, slash command를 직접 정의할 수 있다.

Boris가 예시로 든 것: Claude Code 레포 자체에 「label GitHub issues」라는 slash command가 있고, GitHub Action과 연동해 자동으로 실행된다——이슈가 자동으로 레이블링되며 사람이 개입할 필요가 없다.

팀에 특히 유용하다: 반복해서 사용하는 프롬프트를 slash command로 만들어두면, 한 단어만 입력해도 실행된다.

10. 계층 구조 (설정 시 주의)

Claude Code의 설정은 세 가지 레벨로 나뉜다:

  1. project 레벨 (git repo에 체크인, 팀 전체 공유)
  2. user 레벨 (개인 ~/.claude/)
  3. enterprise 레벨 (회사 강제 정책)

적용 범위: commands / permissions / MCP servers / Bash 화이트리스트 / 블랙리스트.

Enterprise 레벨 활용 예시:

  • 특정 URL 강제 차단 (직원이 재정의 불가)
  • 자주 사용하는 명령어 전사 auto-approve (매번 확인 불필요)
  • MCP servers 설정 통일

11. 터미널 숨겨진 키 바인딩 (강연 최대 깜짝 선물)

반 년을 써도 모르는 사람이 많은 키 목록:

키기능
Shift+Tabauto-accept edits 모드 전환 (bash는 여전히 승인 필요)
#Claude가 기억하도록 CLAUDE.md에 자동 기록
!bash 모드 전환, 명령어 실행 + 결과를 컨텍스트에 추가
@파일 / 폴더 멘션
Esc언제든지 Claude 중단 (안전하며 세션 유지)
Esc Esc히스토리로 돌아가기
Ctrl+R전체 출력 보기
--resume / --continue이전 세션 복원

# 키가 특히 실용적이다: Claude에게 「다음엔 이렇게 하지 마」라고 자주 말한다면, #를 눌러 CLAUDE.md에 기록하면 다음 번엔 기억한다. 반복해서 가르칠 필요가 없다.

12. Claude Code SDK = claude -p

많은 사람이 모르는 사실: 이미 사용하고 있는 claude -p 플래그가 곧 SDK다.

활용 예:

  • CI/CD 파이프라인 자동 실행
  • Incident response 자동 분석
  • 모든 Unix 파이프라인 연결

예시:

1

git status | claude -p "이 변경 사항을 분석해서 PR 설명을 작성해줘" --format json

Boris는 「super intelligent Unix utility」라고 표현했다.

claude -p를 기존 shell 파이프라인에 연결하고 jq로 JSON 출력을 처리하는 방식은, 아직 널리 활용되지는 않지만 파급력이 큰 패턴이다——CI/CD, cron job, incident response 프로세스 모두에 적용할 수 있다.

13. 파워 유저 모드 (여러 Claude 병렬 실행)

Boris의 관찰: Anthropic 내부 파워 유저들은 Claude를 하나만 쓰지 않는다. 여러 개를 동시에 실행한다.

기법:

  • 다수의 SSH 세션 + TMUX 다중 창
  • 동일 레포 다중 체크아웃
  • git worktree로 격리 + 여러 Claude 병렬 실행
  • 「코드 작성 Claude」+「코드 리뷰 Claude」+「코드 테스트 Claude」를 동시에 실행

이 패턴은 「혼자 여러 역할」을 하는 워크플로에 특히 유용하다——개발, 리뷰, 테스트 세 개의 Claude를 동시에 실행하면, 순서대로 돌리는 것보다 훨씬 빠르다.

14. Q&A 핵심

가장 어려운 부분은 무엇인가?

Bash 명령어 보안이다. 매번 수동으로 승인하면 번거롭고, 전부 auto-approve하면 위험하다. 해결책:

  1. read-only 명령어 구분
  2. Static analysis로 명령어 조합의 안전성 확인
  3. 계층적 권한 (허용 목록, 차단 목록)

멀티모달 지원은?

이미지 drag/drop, 파일 경로 지정, 이미지 copy-paste——세 가지 모두 지원한다.

Boris가 시연한 일반적인 활용법: Claude에게 목업 이미지 + puppeteer를 제공하면, 스스로 스크린샷과 목업을 비교하며 일치할 때까지 iterate한다.

왜 IDE가 아닌 CLI인가?

Boris의 답변은 두 가지 층위로 나뉜다:

  1. Anthropic 내부에서 다양한 IDE를 사용해 합의를 이끌어내기 어려웠다
  2. 「개인적으로 연말 전에 IDE를 더 이상 쓰지 않게 될 것 같다」——UI 레이어에 과도하게 투자하고 싶지 않다

두 번째 답변은 다시 생각해볼 만하다——모델이 계속 발전한다면, IDE가 더 이상 주요 인터페이스가 아닐 수도 있다.

ML 분야에서 Claude Code는?

Anthropic 기술 직원의 약 80%가 매일 Claude Code를 사용하며, 리서처도 notebook 도구로 노트북을 직접 편집하는 방식으로 활용한다.

개발자를 위한 takeaway 6가지

  1. Shift+Tab으로 auto-accept 전환 — Claude를 신뢰하게 된 이후에는 매번 수동 승인을 멈춰라. 전환 시간을 대폭 절약할 수 있다
  2. # 기억 핵 — Claude에게 「다음엔 이렇게 하지 마」라고 말할 때 #로 CLAUDE.md에 기록하면, 반복해서 가르칠 필요가 없다
  3. Slash commands — 반복해서 쓰는 프롬프트는 모두 slash command로 만들어라. 한 단어만 입력하면 실행된다
  4. claude -p 파이프 연결 — Claude를 Unix 유틸리티로 활용해 CI/CD, cron, incident response 프로세스에 연결하라
  5. CLAUDE.md 중첩 구성 — 전역 + 프로젝트 레벨 + 서브 디렉터리 레벨 세 계층 설정, 대형 monorepo에 특히 효과적
  6. 여러 Claude 병렬 실행 — git worktree로 격리하고, 코드 작성 / 리뷰 / 테스트를 세 개의 Claude가 동시에 처리하게 하라

마치며

이번 강연의 가치는 「Claude Code가 얼마나 강력한가」라는 정성적 설명에 있지 않다. Boris가 직접 시연한 세부 사항——# 키, Shift+Tab, CLAUDE.md 중첩, claude -p 파이프——에 있다. 이런 세부 내용은 docs에 적혀 있어도 잘 읽히지 않는다. 창조자가 직접 「평소 이렇게 씁니다」라고 말해야 커뮤니티에 전달된다.

Claude Code를 사용하고 있다면, 28분 전체를 처음부터 끝까지 한 번 다 볼 것을 권한다.

링크: Boris on X (원본 스레드)