앤트로픽의 기술 스태프 보리스가 클로드 코드(Claude Code) 개발자 워크숍을 통해 에이전틱 코딩 도구의 실전 팁과 워크플로를 공개했다. 코드베이스 질의응답부터 CLAUDE.md 컨텍스트 관리, GitHub 앱 연동까지 단계별 방법론을 제시해 개발자들의 주목을 받고 있다.
앤트로픽 기술 스태프이자 클로드 코드 개발자인 보리스는 최근 공개된 약 24분 분량의 워크숍 영상에서 클로드 코드를 처음 도입하는 팀부터 숙련 사용자까지를 대상으로 단계별 실전 팁을 공유했다. 이 영상은 이론보다 즉시 적용 가능한 실무 기법에 집중해 개발자 커뮤니티에서 빠르게 확산되고 있다.
클로드 코드는 앤트로픽이 만든 에이전틱 코딩 도구로, 터미널에서 작동하며 자연어 명령으로 코드를 읽고 편집하고 깃(Git) 워크플로를 처리한다. 기존 AI 코딩 보조 도구가 한 줄 단위 자동완성에 머물렀다면, 클로드 코드는 기능 전체를 구현하거나 파일 단위로 버그를 수정하는 완전한 에이전트 방식으로 작동한다. VS Code, Xcode, JetBrains 등 어떤 IDE에도 종속되지 않고, 로컬 환경은 물론 원격 SSH나 Tmux 환경에서도 동일하게 실행된다는 점이 특징이다.
보리스가 가장 먼저 꼽은 팁은 ‘코드베이스 질의응답(Q&A)’이다. 클로드 코드를 코드 편집 도구로 쓰기 전에 먼저 질문 도구로 활용해야 한다는 것이다. 특정 클래스가 어떻게 인스턴스화되는지, 왜 어떤 함수에 인자가 15개나 있는지 등을 물으면 클로드 코드는 단순 텍스트 검색이 아니라 깃 히스토리를 직접 뒤져 해당 코드가 어떤 커밋에서 어떤 이유로 도입됐는지까지 추적해 답한다. 앤트로픽에 따르면 이 방식을 사내 신규 입사자 온보딩에 도입한 결과, 기술직 온보딩 기간이 기존 2~3주에서 2~3일로 단축됐다. 보리스는 매주 월요일 스탠드업 전에 “이번 주에 내가 무엇을 배포했는가”를 클로드 코드에 물어보고 그 결과를 그대로 문서에 붙여넣는다고도 밝혔다.
코드 편집 단계에서는 ‘먼저 계획을 세우게 하라’는 원칙이 핵심이다. 보리스는 3,000줄짜리 기능을 한 번에 구현하라고 시키면 원하는 결과와 전혀 다른 산출물이 나오는 경우가 있다고 지적했다. 해결책은 간단하다. “코드를 작성하기 전에 계획을 세우고 내게 확인을 받아라”라고 프롬프트에 명시하면 클로드 코드는 플랜 모드 같은 별도 기능 없이도 브레인스토밍과 계획을 먼저 수행한다. 또한 커밋·푸시·풀리퀘스트를 한 번에 처리하는 “commit push PR”이라는 간단한 명령어 하나로 클로드 코드가 깃 히스토리를 스스로 살펴 커밋 형식을 파악하고 브랜치를 만들어 PR까지 올린다고 설명했다.
도구 연동 측면에서는 bash 명령어 도구와 MCP(Model Context Protocol) 도구 두 가지를 소개했다. 팀이 이미 사용하는 CLI 도구라면 “이 CLI를 사용해라, –help로 사용법을 파악해라”라고 알려주기만 해도 클로드 코드가 스스로 익혀 활용한다. 반복 품질을 높이려면 클로드 코드에 ‘자체 검증 수단’을 주는 것이 효과적이다. 단위 테스트, Puppeteer 스크린샷, iOS 시뮬레이터 캡처 등 결과를 직접 볼 수 있는 도구를 함께 제공하면, 클로드 코드가 피드백을 받아 스스로 반복 수정하면서 완성도를 크게 높인다는 것이다. 앤트로픽의 공식 문서도 “도메인이 무엇이든 결과를 볼 수 있는 방법을 클로드에게 주면 더 나은 결과를 얻는다”고 권고한다.
컨텍스트 관리의 핵심은 CLAUDE.md 파일이다. 프로젝트 루트에 이 파일을 두면 세션이 시작될 때마다 자동으로 읽혀 공통 bash 명령어, 아키텍처 결정 사항, 스타일 가이드, 핵심 파일 경로 등을 클로드 코드가 사전에 파악한다. 팀 전체가 공유해야 하는 내용은 소스 코드에 체크인하고, 개인 설정만 담은 로컬 CLAUDE.md는 별도로 관리한다. 기업 환경에서는 엔터프라이즈 루트 디렉터리에 올려 여러 코드베이스에 공통 적용할 수 있다. 다만 파일이 지나치게 길어지면 컨텍스트를 낭비해 효율이 떨어지므로 간결하게 유지하는 것이 원칙이다.
슬래시 커맨드 기능도 언급됐다. .claude/commands 경로에 커맨드 파일을 만들면 재사용 가능한 워크플로를 명령어 하나로 실행할 수 있다. 앤트로픽은 이 기능으로 클로드 코드 저장소의 GitHub 이슈를 자동 분류하고 중복 버그 리포트를 제거하는 작업을 실제 운영 중이다. 깃허브 앱 연동도 소개됐는데, /install-github-app 명령어를 터미널에서 실행하면 GitHub 이슈나 풀리퀘스트에 @claude를 멘션하는 것만으로 클로드 코드가 자동으로 반응해 코드 변경을 구현하거나 리뷰를 수행한다.
클로드 코드는 2025년 5월 버전 1.0.0으로 정식 출시된 이후 빠르게 채택이 확산되고 있다. 깃허브 스타 수는 13만 1,000개를 넘어섰으며, 앤트로픽 자체적으로도 클로드 코드 저장소의 이슈 분류와 버그 리포트 중복 제거에 자사 도구를 직접 활용하고 있다. 앤트로픽이 발표한 약 40만 건의 클로드 코드 세션 분석에 따르면, 일반적인 세션에서 사람은 ‘무엇을 할지’ 계획 결정을 주로 담당하고 클로드는 ‘어떻게 할지’ 실행 결정을 맡는 협업 구조가 자연스럽게 형성된다. 도메인 전문성이 높은 사용자일수록 지시 한 번에 클로드가 처리하는 작업량도 늘어나는 것으로 나타났다.
The post 앤트로픽, 24분 워크숍으로 공개한 클로드 코드 실전 활용법 first appeared on 터보뉴스.
댓글0