30분 만에 클로드 코드 마스터하기 - 보리스 체르니, 클로드 코드 창안자, Anthropic, 2025.5.

클로드 코드 개발자가 말하는, AI에게 일을 시키는 법

최근 X에서 “클로드 코드(Claude Code는 AI 개발사인 엔트로픽 Anthropic의 AI 코딩 도구)를 만든 엔지니어가 28분짜리 영상에서 어떤 유료 강연보다 효과적인 프롬프트 작성법을 알려준다”는 식의 소개로 한 영상이 공유되고 있다. 과장된 표현으로 보이지만, 영상의 가치는 크다.
* 클로드 코드란? : Claude Code는 미국 AI 개발사 앤트로픽(Anthropic)이 만든 Claude 기반 코딩 도구이다. Claude는 ChatGPT, Gemini와 함께 세계 최상위권 생성형 AI 모델로 평가되는데, Claude Code는 이 Claude가 개발자의 터미널 안에서 코드베이스를 이해하고, 파일을 고치고, 명령어를 실행하며, 테스트까지 도와주게 만든 도구다.

제목은 「Mastering Claude Code in 30 minutes」. 발표자는 Anthropic에서 Claude Code를 만든 보리스 체르니 Boris Cherny이다. 이 발표는 2025년 5월 22일 샌프란시스코에서 열린 Anthropic의 개발자 콘퍼런스 ‘Code with Claude’에서 진행된 세션이다.
이 강연이 중요한 이유는 AI에게 일을 맡기는 방식의 변화를 알려주기 때문이다. 많은 사람은 아직 AI 코딩 도구를 자동완성기의 확장판으로 생각한다. “이 코드 짜줘”, “이 오류 고쳐줘”라고 요청하는 식이다. 그러나 Claude Code는 한두 줄을 대신 써주는 도구가 아니다. 코드베이스를 읽고, 파일을 수정하고, 명령어를 실행하고, 테스트를 돌리며, 작업을 반복 개선하는 에이전트형 개발 도구에 가깝다.
Boris가 가장 먼저 권하는 사용법도 흥미롭다. 처음부터 코드를 고치게 하지 말고, 코드베이스에 질문하라는 것이다.
“이 함수는 어디서 쓰이나?”
“이 클래스는 어떻게 생성되나?”
“이 인자는 왜 추가됐나?”
이런 질문을 통해 Claude Code가 먼저 맥락을 파악하게 한다.
두 번째 핵심은 계획이다. Claude에게 바로 코드를 쓰게 하지 말고, 먼저 관련 파일을 조사하고 구현 계획을 세우게 하라는 것이다. “코드를 쓰기 전에 계획을 제안하고 승인받아라”는 한 문장만으로도 결과의 품질은 크게 달라진다. AI에게 일을 맡긴다는 것은 명령어를 던지는 일이 아니라, 좋은 동료에게 업무를 맡기듯 배경, 목표, 제약, 검토 기준을 주는 일이다.
세 번째는 CLAUDE.md 파일이다. 이 파일에는 프로젝트의 규칙, 자주 쓰는 명령어, 코드 스타일, 중요한 파일, 팀의 작업 방식 등을 적어둔다. 매번 프롬프트로 반복 설명하는 대신, AI가 참고할 수 있는 업무 안내문을 만들어두는 셈이다.
네 번째는 검증 루프다. Claude에게 결과를 만들게 하는 데서 끝내지 않고, 테스트를 실행하거나 스크린샷을 확인하게 한다. 그러면 Claude는 결과를 보고 스스로 다시 고친다. 피드백 없는 AI는 빠른 추측기계에 가깝지만, 검증 수단을 가진 AI는 반복 개선 도구가 된다.

이 강연은 “이거 만들어줘”라고 던지는 것은 나쁜 방식이고, 좋은 방식은 “먼저 조사하고, 기존 패턴을 찾고, 계획을 제안하고, 승인 후 수정하고, 테스트로 검증하라”고 맡기는 것이라고, 이 차이가 Claude Code 사용의 본질이라고 말한다. AI에게 문장을 잘 던지는 문제가 아니라, 업무 프로세스를 넘기는 문제다. 그래서 이 강연은 개발자 외에 디자인, 기획, 정책, 연구 업무에서도 시사점이 있다. 앞으로 AI 활용 능력은 “어떤 맥락과 기준을 주고, 어떻게 검증하게 할 것인가”에 가까워질 가능성이 크다. 2025년에는 신기한 개발 도구 사용법처럼 보였던 이 강연이, 지금 이시점에서는 일하는 방식의 변화로 다시 주목받고 있는 이유가 아닐까.

찾아보니 유튜브에도 있길래 번역본과 함께 링크한다.
“Mastering Claude Code in 30 minutes,” Code with Claude, Anthropic, San Francisco, Boris Cherny,  2025. 5.22.

보리스 체르니 Boris Cherny

보리스 체르니는 Anthropic에서 Claude Code를 이끄는 엔지니어이자 Claude Code의 창안자이다. Claude Code는 한두 줄의 코드를 자동완성하는 도구가 아니라, 코드베이스를 이해하고, 파일을 수정하고, 명령어를 실행하며, 기능 구현과 버그 수정을 수행하는 에이전트형 코딩 도구이다. 이번 발표에서 그는 Claude Code를 실제 개발 현장에서 어떻게 활용할 수 있는지 소개한다. 코드베이스에 질문하는 법, 작업 전에 계획을 세우게 하는 법, 팀의 도구와 문맥을 연결하는 법, 테스트와 스크린샷을 통해 Claude가 스스로 결과를 검증하고 반복 개선하게 하는 법을 구체적인 사례로 설명한다. 그는 AI 코딩 도구를 더 잘 쓰는 핵심은 더 많은 명령을 외우는 것이 아니라, 좋은 동료 엔지니어에게 일감을 맡기듯 맥락과 목표, 검증 방법을 분명히 주는 것이라고 설명한다. 

https://youtu.be/XFYUKBPfUMw?si=qwVnsQk8f9H8TSQp  
영상 번역 : 챗GPT (생략, 요약, 오역이 있을 수 있습니다. 원본 영상을 봐주세요)

---

안녕하세요.

여러분 안녕하세요. 저는 보리스입니다. Anthropic의 기술 스태프 멤버이고, Claude Code를 만든 사람입니다. 오늘은 Claude Code를 사용할 때 도움이 되는 실용적인 팁과 요령을 조금 이야기하려고 합니다. 아주 실전적인 내용으로 갈 예정입니다. 역사나 이론 같은 이야기는 많이 하지 않겠습니다.

시작하기 전에 손을 한번 들어볼까요? Claude Code를 사용해 본 분?

좋습니다. 우리가 보고 싶었던 장면이네요.

손을 들지 않은 분들은, 발표 중에 원래 이런 걸 하면 안 되긴 하지만, 노트북을 열고 이 명령어를 입력해 보세요. Claude Code 설치에 도움이 됩니다. 그러면 나머지 발표를 따라오실 수 있습니다.

필요한 것은 Node.js뿐입니다. Node.js가 있으면 작동할 것입니다.

반드시 따라 하실 필요는 없습니다. 다만 아직 설치하지 않았다면 지금이 설치해서 따라올 기회입니다.

Claude Code란 무엇일까요? Claude Code는 새로운 종류의 AI 어시스턴트입니다. 코딩을 위한 AI 어시스턴트도 여러 세대가 있었습니다. 대부분은 한 줄씩 코드 완성을 하거나, 몇 줄 정도의 코드를 완성하는 방식이었습니다.

Claude Code는 그런 용도가 아닙니다. 완전히 에이전트형입니다. 기능을 만들고, 전체 함수를 작성하고, 전체 파일을 만들고, 버그 하나를 통째로 고치는 데 쓰는 도구입니다.

Claude Code의 멋진 점은 여러분이 이미 쓰는 모든 도구와 함께 작동한다는 것입니다. 워크플로를 바꿀 필요가 없습니다. 모든 것을 갈아엎고 시작하지 않아도 됩니다.

VS Code를 쓰든, Xcode를 쓰든, JetBrains IDE를 쓰든 상관없습니다. Anthropic에도 JetBrains IDE를 절대 놓지 않는 사람들이 있습니다. 그런데 그들도 Claude Code를 씁니다. Claude Code는 모든 IDE, 모든 터미널에서 작동하기 때문입니다.

로컬에서도, 원격 SSH에서도, tmux에서도 작동합니다. 어떤 환경에 있든 실행할 수 있습니다.

Claude Code는 범용 도구입니다. 이런 자유형 코딩 어시스턴트를 과거에 써본 적이 없다면 처음 시작하기가 다소 어렵게 느껴질 수 있습니다. 열어보면 프롬프트 입력창 하나만 보입니다. 그러면 “여기에 뭘 입력해야 하지?”라는 생각이 들 수 있습니다.

이것은 파워툴입니다. 많은 일을 할 수 있습니다. 하지만 너무 많은 일을 할 수 있기 때문에, 우리는 특정 워크플로로 사용자를 유도하려 하지 않습니다. 엔지니어라면 원하는 방식으로 사용할 수 있어야 하기 때문입니다.

Claude Code를 처음 열면, 환경 설정을 위해 몇 가지를 하는 것을 권장합니다. 아주 간단합니다.

먼저 터미널 설정을 실행하세요. 그러면 Shift+Enter로 줄바꿈을 할 수 있습니다. 줄바꿈을 위해 백슬래시를 입력하지 않아도 됩니다. 사용성이 조금 더 좋아집니다.

theme 명령어로 라이트 모드, 다크 모드, 달토나이즈드 테마 등을 설정할 수 있습니다.

또 /install-github-app을 실행할 수 있습니다. 오늘 우리는 GitHub 앱을 발표했습니다. GitHub 이슈나 풀리퀘스트에서 Claude를 멘션할 수 있는 앱입니다. 설치하려면 터미널에서 이 명령어를 실행하면 됩니다.

사용 가능한 허용 도구 목록도 커스터마이즈할 수 있습니다. 매번 권한 확인을 받지 않아도 되므로 꽤 편리합니다. 자주 허용 요청을 받는 도구라면 저는 이렇게 설정해 둡니다. 매번 승인하지 않아도 되기 때문입니다.

그리고 제가 실제로 자주 하는 방식이 하나 있습니다. 많은 프롬프트를 Claude Code에 직접 타이핑하지 않습니다. macOS를 쓴다면 시스템 설정의 접근성에서 받아쓰기를 켤 수 있습니다. 저는 받아쓰기 키를 두 번 누르고, 프롬프트를 말로 입력합니다.

구체적인 프롬프트를 주는 데 큰 도움이 됩니다. 꽤 훌륭합니다. Claude Code에게 다른 엔지니어에게 말하듯 그냥 말하면 됩니다. 많은 코드를 직접 입력할 필요가 없습니다.

Claude Code를 처음 시작할 때는 너무 자유롭고 많은 일을 할 수 있기 때문에, 무엇부터 시작해야 할지 막막할 수 있습니다. 제가 가장 추천하는 것은 코드베이스 Q&A부터 시작하는 것입니다. 즉, 코드베이스에 대해 질문하는 것입니다.

이것은 Anthropic에서 신입 직원에게 가르치는 방식입니다. 기술 온보딩 첫날 Claude Code에 대해 배우고, 다운로드하고, 설정한 뒤 곧바로 코드베이스에 대해 질문하기 시작합니다.

과거의 기술 온보딩은 팀에 부담을 많이 주었습니다. 팀의 다른 엔지니어에게 계속 질문해야 하고, 코드를 뒤져야 하고, 도구 사용법도 익혀야 합니다. 시간이 오래 걸립니다.

Claude Code를 쓰면 Claude Code에게 물어보면 됩니다. Claude Code가 코드베이스를 탐색하고 이런 질문에 답합니다.

Anthropic에서 기술 온보딩은 예전에는 2~3주 정도 걸렸습니다. 지금은 2~3일 정도 걸립니다.

Q&A의 또 다른 멋진 점은 우리가 어떤 인덱싱도 하지 않는다는 점입니다. 여러분의 코드가 들어 있는 원격 데이터베이스가 없습니다. 코드를 어디에도 업로드하지 않습니다. 코드는 로컬에 남아 있습니다. 우리는 그 코드로 생성 모델을 학습하지 않습니다. 여러분이 통제합니다. 인덱스 같은 것도 없습니다.

이는 설정이 필요 없다는 뜻이기도 합니다. Claude를 다운로드하고 실행하면 됩니다. 인덱싱을 기다릴 필요가 없습니다. 바로 사용할 수 있습니다.

이 발표는 기술 발표입니다. 그래서 아주 구체적인 프롬프트와 코드 샘플을 보여드릴 예정입니다. 여러분이 이것을 활용해서 Claude Code 사용 경험을 개선할 수 있기를 바랍니다.

예를 들어 이런 질문을 할 수 있습니다. “이 특정 코드는 어떻게 사용되는가?” 또는 “이 객체는 어떻게 인스턴스화하는가?”

Claude Code는 단순히 텍스트 검색을 해서 답하려 하지 않습니다. 보통 한 단계 더 깊이 들어갑니다. 이 클래스가 어떻게 인스턴스화되는지, 어떻게 사용되는지 예시를 찾고, 훨씬 깊이 있는 답을 줍니다.

단순히 Command+F로 찾는 수준이 아니라, 위키나 문서에서 얻을 법한 답을 줍니다.

제가 자주 하는 또 다른 방식은 Git 이력에 대해 묻는 것입니다. 예를 들어 “이 함수는 왜 인자가 15개나 되는가?”, “왜 인자 이름이 이렇게 이상한가?”라고 묻는 것입니다.

우리의 모든 코드베이스에는 아마 이런 함수나 클래스가 하나쯤 있을 것입니다. Claude Code는 Git 이력을 살펴볼 수 있습니다. 이 인자들이 어떻게 도입되었는지, 누가 도입했는지, 당시 상황이 무엇이었는지, 그 커밋이 어떤 이슈와 연결되어 있었는지 살펴보고 요약해 줍니다.

이 모든 것을 자세히 설명할 필요가 없습니다. 그냥 “Git 이력을 살펴봐”라고 하면 됩니다. 그러면 Claude Code가 알아서 합니다.

참고로 Claude가 이것을 아는 이유는 우리가 그렇게 프롬프트를 넣어두었기 때문이 아닙니다. 시스템 프롬프트에 Git 이력을 살펴보라는 내용은 없습니다. 모델이 훌륭하기 때문에 아는 것입니다. Git을 사용하라고 말하면 Git 사용법을 압니다. 우리는 좋은 모델 위에서 만들고 있어 운이 좋습니다.

저는 GitHub 이슈에 대해서도 자주 묻습니다. Claude Code는 web fetch를 사용할 수 있고, 이슈를 가져와 맥락을 파악할 수 있습니다. 이것도 아주 좋습니다.

제가 매주 월요일 주간 스탠드업에서 하는 일이 하나 있습니다. “이번 주에 내가 무엇을 배포했지?”라고 묻는 것입니다. 그러면 Claude Code가 로그를 봅니다. 제 사용자명을 알고 있고, 제가 배포한 모든 내용을 보기 좋게 정리해 줍니다. 저는 그것을 문서 어딘가에 복사해 붙여넣습니다.

이것이 첫 번째 팁입니다. Claude Code를 사용해 본 적 없는 사람에게 처음 보여주거나 팀을 온보딩할 때, 우리가 강력하게 추천하는 것은 코드베이스 Q&A부터 시작하는 것입니다.

화려한 도구부터 쓰지 마세요. 코드 편집부터 시작하지 마세요. 코드베이스에 대해 질문하는 것부터 시작하세요. 그러면 사람들이 프롬프트하는 법을 배우게 됩니다. 또 Claude Code가 무엇을 할 수 있는지, 어디까지 가능한지, 어느 부분은 더 구체적으로 도와줘야 하는지 감을 잡게 됩니다.

무엇은 한 번에 처리할 수 있는지, 무엇은 두 번이나 세 번에 나눠야 하는지, 무엇은 대화형 모드에서 반복적으로 해야 하는지 알게 됩니다.

Q&A에 익숙해지면 코드 편집으로 들어갈 수 있습니다. 이것이 다음 단계입니다.

에이전트 방식으로 LLM을 사용하는 것의 멋진 점은 도구를 주면 마법처럼 알아서 도구를 사용한다는 것입니다.

Claude Code에서 우리는 꽤 작은 도구 세트를 제공합니다. 많지 않습니다. 파일을 편집하는 도구, Bash 명령을 실행하는 도구, 파일을 검색하는 도구가 있습니다. Claude Code는 이것들을 엮어서 코드를 탐색하고, 아이디어를 내고, 마지막으로 편집을 수행합니다.

이 도구를 쓰고, 저 도구를 쓰고, 또 다른 도구를 쓰라고 구체적으로 프롬프트할 필요가 없습니다. 그냥 “이 일을 해줘”라고 말하면 됩니다. 그러면 Claude Code가 적절한 방식으로 알아서 조합합니다.

사용 방식은 많습니다.

제가 가끔 하는 방식은 Claude가 바로 코드를 쓰기 전에 먼저 브레인스토밍을 하거나 계획을 세우게 하는 것입니다.

우리가 강력히 추천하는 방식입니다. 가끔 사람들이 Claude Code에게 “이 거대한 3만 줄짜리 기능을 구현해 줘”라고 요청합니다. 때로는 첫 시도에 맞게 해냅니다. 하지만 때로는 전혀 원하지 않았던 결과물을 만들기도 합니다.

원하는 결과를 얻는 가장 쉬운 방법은 먼저 생각하게 하는 것입니다. 아이디어를 내고, 계획을 만들고, 나에게 보여주고, 코드를 쓰기 전에 승인을 요청하라고 말하면 됩니다.

이를 위해 계획 모드를 쓸 필요도 없습니다. 특별한 도구도 필요 없습니다. 그냥 Claude에게 요청하면 됩니다. “코드를 쓰기 전에 계획을 세워줘.” 이게 전부입니다.

또 하나 넣고 싶었던 것이 있습니다. “commit push”입니다. 제가 자주 쓰는 주문 같은 표현입니다. 특별한 것은 없지만, Claude는 이 표현을 해석할 만큼 똑똑합니다.

그러면 커밋을 만들고, 브랜치에 푸시하고, 브랜치를 만들고, GitHub에서 풀리퀘스트까지 만들어 줍니다. 아무것도 자세히 설명할 필요가 없습니다. Claude가 코드를 보고, 이력을 보고, Git 로그를 보고, 커밋 형식과 필요한 내용을 알아낸 뒤 올바른 방식으로 커밋하고 푸시합니다.

다시 말하지만, 우리가 이것을 시스템 프롬프트로 넣은 것이 아닙니다. 모델이 이것을 할 줄 압니다. 모델이 좋습니다.

조금 더 고급 단계로 가면, 팀의 도구를 연결하고 싶어질 것입니다. 이때 Claude Code가 정말 빛나기 시작합니다.

일반적으로 도구는 두 종류가 있습니다. 하나는 Bash 도구입니다. 예시로 제가 “barley CLI”라는 가상의 도구를 만들었습니다. 실제 도구는 아닙니다.

여러분은 “이 CLI를 사용해서 무엇을 해라”라고 말할 수 있습니다. Claude Code에게 이 도구에 대해 알려주고, 예를 들어 --help를 사용해 사용법을 파악하라고 말할 수 있습니다. 효율적입니다.

자주 사용한다면 이것을 CLAUDE.md에 넣어둘 수도 있습니다. 잠시 후 이야기하겠지만, 이렇게 하면 Claude가 세션을 넘어 기억할 수 있습니다.

이것은 Anthropic에서 우리가 흔히 따르는 패턴이고, 외부 고객들도 사용하는 방식입니다. MCP도 마찬가지입니다. Claude Code는 Bash 도구도, MCP 도구도 사용할 수 있습니다. 도구에 대해 알려주고, MCP 도구를 추가하고, 사용 방법을 알려주면 곧바로 사용하기 시작합니다.

이것은 매우 강력합니다. 새 코드베이스에서 Claude Code를 사용하기 시작할 때, 팀이 그 코드베이스에서 이미 사용하고 있는 모든 도구를 Claude에게 줄 수 있습니다. 그러면 Claude Code가 여러분 대신 사용할 수 있습니다.

몇 가지 일반적인 워크플로가 있습니다. 앞에서 말한 것처럼, 약간 탐색하고, 계획을 세우고, 코드를 쓰기 전에 확인을 요청하게 하는 방식입니다.

오른쪽의 다른 두 워크플로는 Claude가 자기 작업을 확인할 방법이 있을 때 매우 강력합니다. 예를 들어 유닛 테스트를 작성하게 하거나, Puppeteer로 스크린샷을 찍게 하거나, iOS 시뮬레이터 스크린샷을 찍게 하는 방식입니다.

그러면 Claude는 반복 개선할 수 있습니다. 이것은 놀랍습니다. 예를 들어 목업을 주고 “이 웹 UI를 만들어줘”라고 하면 꽤 잘 만듭니다. 하지만 두세 번 반복하게 하면 거의 완벽에 가까워지는 경우가 많습니다.

비결은 Claude가 결과를 확인할 수 있는 피드백 도구를 주는 것입니다. 그러면 그 피드백을 바탕으로 스스로 반복 개선하고, 훨씬 더 나은 결과를 얻을 수 있습니다.

여러분의 분야가 무엇이든, 유닛 테스트든 통합 테스트든 앱이나 웹 스크린샷이든 상관없습니다. Claude가 자기 결과를 볼 수 있는 방법을 주세요. 그러면 반복하면서 더 좋아집니다.

이것이 다음 단계입니다. Claude에게 여러분의 도구 사용법을 가르치고, 올바른 워크플로를 찾아내세요.

Claude가 바로 코드에 뛰어들게 할지, 먼저 브레인스토밍을 하게 할지, 계획을 세우게 할지, 반복 개선하게 할지 감을 잡아야 합니다. 그래야 Claude에게 원하는 방식으로 프롬프트할 수 있습니다.

도구를 넘어 더 깊이 들어가면, Claude에게 더 많은 맥락을 주고 싶어질 것입니다. 맥락이 많을수록 Claude의 판단은 더 똑똑해집니다. 엔지니어가 코드베이스에서 일할 때는 시스템, 역사, 여러 배경지식에 대한 많은 맥락을 머릿속에 갖고 있습니다.

그 맥락을 Claude에게 줄 수 있는 방법은 여러 가지입니다. Claude에게 맥락을 더 많이 줄수록 더 잘 작동합니다.

가장 단순한 방법은 우리가 CLAUDE.md라고 부르는 것입니다. CLAUDE.md는 특별한 파일 이름입니다. 가장 간단한 위치는 프로젝트 루트입니다. Claude를 시작하는 같은 디렉터리에 CLAUDE.md를 두면 됩니다. 그러면 매 세션 시작 시 자동으로 컨텍스트에 읽혀 들어갑니다. 사실상 첫 사용자 턴에 CLAUDE.md가 포함되는 방식입니다.

로컬 CLAUDE.md도 둘 수 있습니다. 이것은 보통 소스 관리에 넣지 않습니다. 반면 프로젝트의 CLAUDE.md는 소스 관리에 넣고 팀과 공유하는 것이 좋습니다. 한 번 작성해서 팀 전체가 공유할 수 있기 때문입니다. 로컬 파일은 체크인하지 않고 개인용으로 둡니다.

CLAUDE.md에 넣는 내용은 이런 것들입니다. 자주 쓰는 Bash 명령, 자주 쓰는 MCP 도구, 아키텍처 결정, 중요한 파일, 이 코드베이스에서 일하기 위해 일반적으로 알아야 하는 것들입니다.

너무 길게 만들지는 마세요. 너무 길어지면 컨텍스트만 많이 사용하고, 보통 그다지 유용하지 않습니다. 가능한 짧게 유지하세요.

예를 들어 우리 코드베이스에는 자주 쓰는 Bash 명령, 스타일 가이드, 몇 가지 핵심 파일 같은 것이 들어 있습니다.

다른 CLAUDE.md 파일들은 중첩된 하위 디렉터리에 둘 수도 있습니다. 그러면 Claude가 해당 디렉터리에서 작업할 때 필요에 따라 자동으로 가져옵니다.

자동으로 가져오는 CLAUDE.md에는 여러 종류가 있습니다. 중첩 디렉터리에 CLAUDE.md를 넣으면, Claude가 그 디렉터리에서 작업할 때 자동으로 불러옵니다.

물론 회사라면 여러 코드베이스에 공통으로 쓰이는 CLAUDE.md를 두고 싶을 수 있습니다. 사용자 대신 관리하고 싶을 수 있습니다. 그러면 엔터프라이즈 루트에 둘 수 있고, 자동으로 가져오게 됩니다.

맥락을 가져오는 방법은 정말 많습니다. 이 슬라이드를 만들면서 그 폭을 전달하기가 어려웠습니다. CLAUDE.md는 자동으로 불러옵니다.

슬래시 명령도 사용할 수 있습니다. .claude/commands가 있고, 이것은 홈 디렉터리에 둘 수도 있고 프로젝트에 체크인할 수도 있습니다. 슬래시 명령을 위한 것입니다.

여기에는 Claude Code 자체에서 사용하는 몇 가지 슬래시 명령 예시가 있습니다. 예를 들어 Claude Code 저장소에서 이슈에 라벨이 붙는 것을 본다면, 실제로는 여기의 워크플로가 실행되는 것입니다. GitHub 이슈에 라벨을 붙이는 명령입니다.

우리는 오늘 아침에 이야기한 것과 같은 GitHub Action을 실행하고, Claude Code가 이 명령을 실행합니다. 그것은 그냥 슬래시 명령입니다. 실행되면 이슈에 라벨을 붙입니다. 사람이 하지 않아도 되니 시간을 많이 아껴줍니다.

물론 파일을 멘션해서 컨텍스트로 불러올 수도 있습니다. 앞서 말했듯, 중첩 디렉터리의 CLAUDE.md는 Claude가 그 디렉터리에서 작업할 때 불러옵니다.

Claude에게 더 많은 맥락을 주세요. 그리고 맥락을 조정하는 데 시간을 쓰는 것은 분명 가치가 있습니다. 프롬프트 개선 도구에 넣어 다듬을 수도 있습니다.

그 맥락이 누구를 위한 것인지 생각하세요. 매번 불러오고 싶은 것인지, 필요할 때만 불러오고 싶은 것인지, 팀과 공유할 것인지, 개인 선호인지 생각해야 합니다. 시간을 들여 조정하세요.

잘하면 성능이 극적으로 좋아집니다.

더 고급으로 갈수록 이 부분을 더 깊이 생각해야 합니다. 다양한 방식으로 모든 것을 불러오는 일종의 계층 구조입니다. CLAUDE.md뿐 아니라 설정과 Claude와 관련된 거의 모든 것을 이런 계층 방식으로 불러올 수 있습니다.

프로젝트 설정은 특정 Git 저장소에 연결됩니다. 이것은 체크인할 수도 있고, 개인용으로만 둘 수도 있습니다. 모든 프로젝트에 걸친 글로벌 설정도 둘 수 있습니다. 엔터프라이즈 정책도 둘 수 있습니다. 이것은 사실상 모든 직원, 모든 팀원에게 자동으로 배포되는 글로벌 설정입니다.

이 슬라이드는 정보가 꽤 많습니다. 핵심은 이것이 많은 것에 적용된다는 점입니다. 슬래시 명령에도 적용할 수 있고, 권한에도 적용할 수 있습니다.

예를 들어 모든 직원이 사용하는 Bash 명령이 있다고 합시다. 모든 직원이 특정 테스트 명령을 사용한다면, 이것을 엔터프라이즈 정책 파일에 넣을 수 있습니다. 그러면 직원이 이 명령을 실행할 때 자동으로 승인됩니다. 꽤 편리합니다.

명령을 차단하는 데도 사용할 수 있습니다. 예를 들어 절대 fetch하면 안 되는 URL이 있다고 합시다. 그것을 이 설정에 추가하면, 직원이 덮어쓸 수 없고 그 URL은 절대 fetch되지 않습니다. 사람들의 작업을 막힘없이 도와주면서도 코드베이스를 안전하게 유지하는 데 모두 편리합니다.

MCP 서버도 마찬가지입니다. MCP JSON 파일을 만들어 코드베이스에 체크인하세요. 그러면 누군가 그 코드베이스에서 Claude Code를 실행할 때 MCP 서버 설치 안내를 받고, 팀과 공유할 수 있습니다.

무엇을 써야 할지 모르겠다면, 이 표가 꽤 복잡하게 보일 수 있습니다. 우리는 많은 것을 지원하고, 엔지니어 워크플로는 매우 유연하며, 회사마다 다르기 때문입니다. 그래서 우리는 가능한 모든 방식을 지원하려 합니다.

어디서 시작해야 할지 모르겠다면 공유 프로젝트 컨텍스트부터 시작하는 것을 추천합니다. 한 번 작성해서 팀 전체와 공유하세요. 그러면 누군가 조금만 작업해도 팀 전체가 이득을 보는 네트워크 효과가 생깁니다.

Claude에는 이것을 관리하는 도구도 많이 내장되어 있습니다. 예를 들어 /memory를 실행하면 어떤 메모리 파일들이 불러와지고 있는지 모두 볼 수 있습니다. 엔터프라이즈 정책이 있을 수 있고, 사용자 메모리가 있을 수 있고, 프로젝트 CLAUDE.md가 있을 수 있고, 특정 디렉터리에서만 불러오는 중첩 CLAUDE.md가 있을 수 있습니다.

마찬가지로 /memory를 실행하면 특정 메모리 파일을 편집할 수 있습니다. 무언가를 기억시키기 위해 # 기호를 입력하면, 어느 메모리에 저장할지도 선택할 수 있습니다.

다음 팁은 이것입니다. CLAUDE.md, MCP 서버, 팀이 사용하는 모든 도구를 설정하는 데 시간을 쓰세요. 한 번 설정하고 모두가 공유할 수 있게 하세요.

예를 들어 Anthropic의 apps 저장소가 있습니다. 웹과 앱 코드가 들어 있는 저장소입니다. 여기에 Puppeteer MCP 서버가 있고, 우리는 이것을 팀과 공유합니다. MCP JSON도 체크인되어 있습니다.

그래서 그 저장소에서 일하는 어떤 엔지니어든 Puppeteer를 사용해 엔드투엔드 테스트를 조종하고, 자동으로 스크린샷을 찍고, 반복 개선할 수 있습니다. 모든 엔지니어가 직접 설치할 필요가 없습니다.

이 발표는 프로 팁에 관한 것이므로, 사람들이 잘 모를 수 있는 일반적인 키 바인딩을 잠깐 이야기하고 싶습니다.

터미널용으로 제품을 만드는 것은 매우 어렵습니다. 동시에 아주 재미있습니다. 새로운 디자인 언어를 다시 발견하는 느낌입니다. 하지만 터미널은 매우 미니멀합니다. 그래서 때때로 이런 키 바인딩을 발견하기 어렵습니다.

간단한 참조표를 보겠습니다.

언제든 Shift+Tab을 눌러 편집을 수락할 수 있습니다. 이것은 자동 편집 수락 모드로 전환합니다. Bash 명령은 여전히 승인이 필요하지만, 파일 편집은 자동으로 수락됩니다. 나중에 언제든 Claude에게 되돌리라고 요청할 수 있습니다.

저는 Claude가 올바른 방향으로 가고 있다고 확신할 때 이렇게 합니다. 또는 유닛 테스트를 작성하고 테스트를 반복하고 있을 때 보통 자동 수락 모드로 전환합니다. 매번 편집을 승인하지 않아도 되기 때문입니다.

Claude에게 무언가를 기억시키고 싶다면, 예를 들어 Claude가 도구를 올바르게 사용하지 못하고 있고 앞으로는 제대로 쓰게 하고 싶다면, # 기호를 입력한 다음 기억할 내용을 말하면 됩니다. 그러면 Claude가 그것을 기억합니다. 자동으로 CLAUDE.md에 반영합니다.

Bash 모드로 내려가서 Bash 명령을 실행하고 싶다면, 느낌표 !를 누르고 명령을 입력하면 됩니다. 로컬에서 실행됩니다. 동시에 컨텍스트 창에도 들어가므로, 다음 턴에서 Claude가 그것을 볼 수 있습니다.

이것은 오래 실행되는 명령에 좋습니다. 정확히 무엇을 할지 알고 있거나, 어떤 명령과 출력 결과를 컨텍스트에 넣고 싶을 때 좋습니다. Claude는 그 명령과 출력을 보게 됩니다.

파일과 폴더는 언제든 멘션할 수 있습니다. Claude가 무엇을 하고 있든 Escape를 눌러 멈출 수 있습니다. Claude가 어떤 작업을 하고 있더라도 Escape를 누르는 것은 안전합니다. 세션이 망가지지 않습니다. 무언가가 꼬이지 않습니다.

예를 들어 Claude가 파일 편집 중이면 Escape를 누르고, 다르게 해야 할 일을 말합니다. 또는 Claude가 20줄짜리 편집을 제안했는데 19줄은 완벽하고 한 줄만 바꾸면 된다면, Escape를 누르고 그 부분을 말한 뒤 다시 편집하라고 합니다.

Escape를 두 번 누르면 이력에서 뒤로 이동할 수 있습니다. 세션이 끝난 뒤에는 Claude를 resume으로 시작해 해당 세션을 이어갈 수 있습니다. 또는 continue를 사용할 수 있습니다.

더 많은 출력을 보고 싶다면 Control+R을 누르면 됩니다. 그러면 전체 출력이 표시됩니다. Claude가 컨텍스트 창에서 보는 것과 같은 출력입니다.

다음으로 이야기할 것은 Claude Code SDK입니다. 앞에서도 이야기했습니다. 이 발표 직후 Sid가 아마 복도 건너편에서 SDK를 훨씬 깊게 다루는 세션을 할 것입니다.

아직 이것을 써보지 않았다면, Claude에서 -p 플래그를 사용한 적이 있다면 그것이 SDK입니다. 지난 몇 주 동안 우리는 이것을 더 좋게 만들기 위해 여러 기능을 배워가며 추가했습니다.

이 위에 직접 무언가를 만들 수 있습니다. 멋진 것들을 만들 수 있습니다. 이것은 Claude Code가 사용하는 바로 그 SDK입니다. 정확히 같은 SDK입니다.

예를 들어 claude -p를 사용할 수 있습니다. 이것이 CLI SDK입니다. 프롬프트를 넘길 수 있고, 허용 도구를 넘길 수 있습니다. 특정 Bash 명령을 포함할 수도 있습니다.

원하는 출력 형식도 지정할 수 있습니다. JSON을 원할 수도 있고, 무언가를 처리하려면 스트리밍 JSON을 원할 수도 있습니다. 이것은 무언가를 만들 때 아주 좋습니다.

우리는 CI에서 이것을 항상 사용합니다. 인시던트 대응에도 사용합니다. 여러 파이프라인에서 사용합니다. 아주 편리합니다. 일종의 Unix 유틸리티라고 생각하면 됩니다. 프롬프트를 주면 JSON을 줍니다. 원하는 방식으로 사용할 수 있습니다. 파이프로 입력할 수도 있고, 출력할 수도 있습니다.

파이핑도 꽤 멋집니다. 예를 들어 git status를 파이프로 넣고, jq로 결과를 선택할 수 있습니다. 조합은 끝이 없습니다. 이것은 새로운 아이디어입니다. 초지능적인 Unix 유틸리티 같은 것입니다. 저는 우리가 이것을 어떻게 사용할 수 있는지 아직 표면만 긁어본 수준이라고 생각합니다. 이제 막 알아가는 중입니다.

GCP 버킷에서 데이터를 읽거나, 거대한 로그를 읽어서 파이프로 넣고, Claude에게 이 로그에서 흥미로운 점을 찾아보라고 할 수 있습니다.

Sentry CLI에서 데이터를 가져와 파이프로 넣고, Claude가 무언가를 하게 할 수도 있습니다.

마지막 내용입니다. 아마 우리가 보는 가장 고급 사용 사례일 것입니다.

저는 약간 Claude 일반 사용자에 가깝습니다. 보통 Claude 하나를 한 번에 실행합니다. 몇 개의 다른 저장소에 대해 터미널 탭을 몇 개 열어두는 정도입니다.

하지만 Anthropic 안팎의 파워 유저들을 보면 거의 항상 SSH 세션을 사용합니다. tmux 터널을 Claude 세션에 연결해 둡니다. 같은 저장소를 여러 개 체크아웃해서 그 저장소에서 여러 Claude를 병렬로 실행합니다. 또는 Git worktree를 사용해서 격리를 확보합니다.

우리는 이것을 더 쉽게 만들기 위해 적극적으로 작업 중입니다. 현재로서는 Claude Code로 더 많은 일을 병렬로 하기 위한 아이디어들이라고 보면 됩니다. 원하는 만큼 많은 세션을 실행할 수 있습니다. 병렬로 할 수 있는 일이 많습니다.

여기까지입니다. Q&A 시간을 남겨두고 싶었습니다. 제 마지막 슬라이드는 이것입니다. 질문이 있다면 양쪽에 마이크가 있습니다. 질문해 주시면 답변하겠습니다.

[박수]

[웃음]

네, 제가 만들었습니다.

[웃음]

보리스, Claude Code를 만들어줘서 감사합니다. 구현 과정에서 가장 어려웠던 부분이 무엇이었는지 궁금합니다.

어려운 부분이 많았습니다. 특히 까다로웠던 부분은 Bash 명령을 안전하게 만드는 일이었습니다. Bash는 본질적으로 꽤 위험하고, 예상치 못한 방식으로 시스템 상태를 바꿀 수 있습니다.

동시에 모든 Bash 명령을 매번 수동 승인해야 한다면 엔지니어 입장에서는 매우 귀찮습니다. 생산적일 수 없습니다. 계속 명령을 승인하고 있어야 하니까요.

이것을 다양한 종류의 코드베이스에서 확장 가능한 방식으로 안전하게 운영하는 것이 꽤 어려웠습니다. 모든 사람이 Docker 컨테이너 안에서 코드를 실행하는 것도 아니기 때문입니다.

우리가 도달한 방식은 이렇습니다. 읽기 전용 명령이 있고, 어떤 명령들이 안전한 방식으로 결합될 수 있는지 판단하기 위한 정적 분석이 있습니다. 그리고 여러 수준에서 명령을 허용 목록과 차단 목록에 넣을 수 있는 꽤 복잡한 계층형 권한 시스템이 있습니다.

안녕하세요, 보리스. 이미지를 Claude Code에 줄 수 있다고 말씀하셔서 궁금해졌습니다. 제가 모르는 멀티모달 기능이 있는 건가요? 파일 시스템에 있는 이미지를 가리키는 식인가요?

네. Claude Code는 완전히 멀티모달입니다. 처음부터 그랬습니다. 터미널 안에 있다 보니 약간 발견하기 어렵긴 합니다.

이미지를 드래그 앤 드롭하면 됩니다. 파일 경로를 줘도 됩니다. 이미지를 복사해서 붙여넣어도 됩니다. 모두 작동합니다.

저는 이것을 꽤 자주 사용합니다. 예를 들어 어떤 목업이 있으면 그냥 목업을 드래그 앤 드롭합니다. 그것을 구현하라고 말합니다. Puppeteer 서버를 주어 반복 개선할 수 있게 합니다. 그러면 사실상 완전히 자동화됩니다.

안녕하세요. 왜 IDE가 아니라 CLI 도구를 만드셨나요?

좋은 질문입니다. 이유는 아마 두 가지입니다.

첫 번째는 우리가 Anthropic에서 이것을 시작했기 때문입니다. Anthropic 사람들은 매우 다양한 IDE를 사용합니다. 어떤 사람은 VS Code를 쓰고, 어떤 사람은 Zed, Xcode, Vim, Emacs를 씁니다. 모두에게 작동하는 것을 만드는 것이 어려웠습니다. 그래서 터미널이 공통분모였습니다.

두 번째는 Anthropic에서 우리는 모델이 얼마나 빠르게 좋아지고 있는지 가까이서 보고 있다는 점입니다. 그래서 올해 말쯤이면 사람들이 더 이상 IDE를 사용하지 않을 가능성도 꽤 있다고 봅니다.

우리는 그 미래에 대비하고 싶습니다. 모델 발전 속도를 고려하면 UI나 그 위의 여러 레이어에 과도하게 투자하는 것이 곧 그다지 유용하지 않은 일이 될 수도 있다고 생각합니다.

Claude Code를 머신러닝 모델링이나 거의 AutoML 같은 경험에 얼마나 사용해 보셨는지 궁금합니다.

질문은 Claude Code를 머신러닝과 모델링에 얼마나 사용하느냐는 것이었습니다. 우리는 실제로 이것을 꽤 많이 사용합니다. Anthropic의 엔지니어와 연구자 모두 매일 Claude Code를 사용합니다.

Anthropic의 기술 인력 중 약 80%가 매일 Claude Code를 사용하는 것으로 알고 있습니다. 제품에서도, 그리고 우리가 얼마나 애정을 갖고 직접 써가며 개선했는지에서도 그것이 보이길 바랍니다.

여기에는 노트북 도구를 사용해 노트북을 편집하고 실행하는 연구자들도 포함됩니다.

좋습니다. 감사합니다.