Claude Code 창시자가 절대 어기지 않는 단 하나의 규칙

하이라이트

• Claude Code 사용 시 가장 중요한 것은 작업에 대한 검증 방법을 항상 제공하는 것 - 테스트, bash 명령, UI 검증 등을 통해 피드백 루프를 구축해야 함

• Claude.md 파일은 각 프로젝트마다 고유해야 하며, 기술 스택, 코드 스타일, 하지 말아야 할 것들을 포함하여 팀 전체가 주기적으로 업데이트해야 함

• 위험하게 권한 건너뛰기 모드 대신 권한 설정을 통해 허용/확인/거부 명령을 세밀하게 제어하는 것이 프로덕션 환경에서 안전함

• 플랜 모드에서 먼저 계획을 세우고 검증한 후 자동 수락 편집 모드로 실행하는 워크플로우가 효과적임

• Opus 4.5 사고 기능 모델은 느리지만 오류가 적어 전체 작업 시간이 오히려 단축됨

• 백그라운드 에이전트와 웹 세션을 활용하면 클라우드에서 장기 실행 작업을 처리하고 모바일에서도 관리 가능

• /commands와 서브에이전트는 반복적인 내부 루프 워크플로우를 자동화하는 간단하면서도 강력한 내장 기능임

타임라인

1. 00:00 - 01:41

   검증 메커니즘의 중요성

   Anthropic에서 Claude Code를 실제로 만든 보리스는 사람들이 가진 가장 큰 오해를 지적한다. 사용자들은 작업을 주고 작은 오류가 발생하면 실망하지만, 인간도 유사하게 일한다는 것이다. 보리스는 Claude에게 항상 작업을 검증할 수 있는 방법을 제공해야 한다고 강조하며, Python 프로젝트라면 테스트를 사용하도록 지시해야 한다고 설명한다. 이를 통해 Claude가 피드백 루프를 얻게 되고 최종 결과물의 품질이 즉시 향상된다. 자율적 작동을 원한다면 Claude.md 파일에 작업 전 검증 방법을 언급하도록 지시하여 지속적인 피드백 루프를 구축할 수 있다.

2. 01:41 - 02:06

   도메인별 검증 전략

   검증 방법은 각 도메인마다 다르게 적용되어야 한다. bash 명령 실행처럼 간단할 수도 있고, UI 기반 검증의 경우 Claude의 브라우저 확장 프로그램을 사용할 수 있다. 이를 통해 Claude가 전체 사이트를 탐색하며 모든 것을 검증할 수 있다. 모바일 앱 개발의 경우 iOS 및 Android 시뮬레이터 MCP를 활용할 수 있으며, 토큰 소비가 걱정된다면 테스트 주도 개발(TDD) 같은 검증 주도 기법을 사용할 수 있다. 새로운 기능에 대한 테스트를 먼저 작성하고 실제 구현을 진행하며, 그 과정에서 스크린샷을 사용하여 UI도 검증할 수 있다.

3. 02:06 - 03:06

   Claude.md 파일 관리 전략

   보리스는 Claude.md 파일이 얼마나 중요하며 각 프로젝트마다 얼마나 고유해야 하는지 강조한다. 새로 생성된 Claude 세션이 프로젝트에 대해 가져야 할 모든 기본 정보를 포함해야 하며, 기술 스택, 프로젝트 구조, 코드 스타일과 규칙, 그리고 가장 중요한 하지 말아야 할 것들이 포함되어야 한다. 보리스는 팀 전체가 일주일에 여러 번 Claude.md에 기여하는 습관을 들였으며, 잘못된 작업을 볼 때마다 거기에 추가한다. 풀스택 앱의 경우 각 마이크로서비스가 자체 Claude.md를 가질 수 있으며, 보리스 자신의 Claude.md는 약 2.5K 토큰으로 비대하지 않게 유지된다.

4. 03:06 - 03:56

   권한 관리와 안전한 실행 모드

   Claude Code에는 플랜 모드, 자동 수락 모드, 위험하게 권한 건너뛰기 모드 등 다양한 모드가 있다. 보리스는 위험하게 권한 건너뛰기 모드를 사용하지 않는다고 명확히 밝히는데, 특히 프로덕션 환경에서 단 하나의 터미널 명령이 전체 프로젝트를 망칠 수 있기 때문이다. 대신 Claude Code의 권한 설정을 사용하여 허용되는 명령, 실행 전에 물어봐야 하는 명령, 완전히 거부되는 명령을 설정한다. 원하는 규칙을 프로젝트 수준에서 설정할 수 있으며, .Claude 폴더의 settings.json 파일에 모든 명령이 기록되어 팀과 공유할 수 있다.

5. 03:56 - 04:50

   오케스트레이터로서의 Claude Code

   Claude Code는 Anthropic에서 가장 잘못 명명된 제품 중 하나로, 코드에만 사용되는 것이 아니다. 사람들이 완전한 Anetian 워크플로우 생성, 전체 SEO 파이프라인 설정, 비즈니스 시장 분석 에이전트 생성 등 다양한 용도로 사용하고 있다. 보리스는 Claude가 Slack, BigQuery, Sentry 같은 다른 모든 도구를 MCP 서버와 CLI를 통해 사용한다고 설명하며, 이는 Claude Code를 오케스트레이터 형태로 사용할 수 있음을 보여준다. 영상 제작자의 경우 Notion 내부에서 MCP를 통해 데이터베이스를 생성하고 채우며 모든 비디오 아이디어의 맥락을 이해하는 방식으로 오케스트레이션을 활용하고 있다.

6. 04:50 - 05:26

   보리스의 실제 워크플로우

   보리스가 실제로 Claude Code를 사용하는 방법은 기능이나 작업을 구현하기 전에 먼저 플랜 모드로 전환하여 원하는 것을 명확하게 설명하는 것이다. Claude가 계획을 세우면 거기서부터 계속 진행하며, 좋은 계획을 세우는 것이 매우 중요하다고 강조한다. 에이전트와의 모든 주고받기가 플랜 모드에서 일어나며, 계획이 실제로 유효하다는 것을 확인한 후에만 에이전트를 시작한다. 그 후에는 위험하게 권한 건너뛰기 모드가 아닌 자동 수락 편집 모드로 실행한다. 대규모 작업의 경우 Claude Code 세션을 병렬로 다섯 개 실행하며, 작업하는 동안 탭에 번호를 매겨 어느 터미널 탭에서 알림이 오는지 알 수 있도록 한다.

7. 05:26 - 06:11

   웹 세션과 백그라운드 에이전트 활용

   보리스는 Claude Code의 웹 세션도 많이 사용하며, 웹 버전을 GitHub에 연결하고 데모 리포지토리에 대한 액세스 권한을 부여하여 클라우드에서 작업한다. 백그라운드 에이전트 기능을 사용하여 장기 실행 작업을 백그라운드에 배치하며, 때로는 휴대폰에서도 사용한다. Claude가 클라우드 세션에서 자동으로 모든 작업을 수행하고, 완료되면 새 브랜치를 생성하여 모든 코드 변경 사항을 푸시하여 검토할 수 있도록 한다. 텔레포트 명령을 사용하면 클라우드 세션을 로컬 터미널로 다시 가져와서 직접 보고 작업할 수 있으며, 이것이 AI 에이전트를 주니어 개발자처럼 다루는 진정한 정의라고 설명한다.

8. 06:11 - 06:49

   Opus 4.5 모델과 GitHub 액션 활용

   보리스는 모든 것에 대해 사고 기능이 활성화된 Opus 4.5를 거의 사용한다고 밝힌다. 더 크고 느린 모델이며 Sonnet보다 더 많은 시간이 걸리고 Haiku보다 훨씬 더 많은 시간이 걸리지만, 오류를 만들 가능성이 훨씬 낮다는 장점이 있다. 결과적으로 모델과 함께 작업하고 조정하는 데 소요되는 전체 시간은 실제로 Opus 4.5에서 훨씬 더 적다고 주장한다. 또한 Claude Code GitHub 액션을 사용하는데, 이는 승인된 GitHub 저장소 내에서 호출할 수 있는 봇이다. PR 리뷰 중에 실수를 발견하면 단순히 Claude에게 그 실수들을 Claude.md 파일에 추가하도록 요청하는 강력한 사용 사례를 제공했다.

9. 06:49 - 07:28

   장시간 실행 작업 관리 전략

   장시간 실행되는 작업의 경우 보리스는 세 가지 다른 접근 방식을 사용한다. 첫 번째는 Claude Code 자체가 생각해낸 다양한 테스트를 사용하여 Claude에게 작업을 검증하도록 요청한 다음 해당 작업들을 백그라운드로 전환하는 것이다. 이것들은 클라우드 에이전트가 아니라 조용히 실행되며 완료되면 메인 에이전트에 다시 보고하는 백그라운드 작업이다. 두 번째 접근 방식은 Claude가 출력을 중지할 때 자동으로 검증을 트리거하는 중지 훅을 사용하는 것이다. 세 번째 옵션은 이 아이디어를 기반으로 하며, Ralph Wiggum 플러그인이 구축된 기반이 되었다.

10. 07:28 - 08:01

    검증 도구와 코드 품질 관리

    검증 패턴을 반복하면서 보리스는 다양한 언어에 대한 여러 종류의 린터와 포매터를 사용하여 작성되는 코드의 형식을 검증한다. 모델들이 기본적으로 올바른 코드를 생성하지만, 이러한 포매터들이 나머지 10%를 정리하는 데 도움이 된다고 설명한다. 이것은 GitHub 통합 파이프라인의 일부로 CI에서 코드가 실행될 때 오류가 발생하지 않도록 하는 데 중요하다. Claude Code에 오랫동안 있었지만 여전히 많은 시간을 절약해주고 많은 초보자들이 잘 모르는 간단한 기능들이 있으며, 보리스 자신의 워크플로우는 놀랍도록 평범하다고 언급한다.

11. 08:01 - 09:04

    내장 기능 활용: /commands와 서브에이전트

    진정으로 생산적이기 위해 Claude Code의 모든 것을 지나치게 복잡하게 만들 필요는 없으며, 간단한 내장 기능들만으로도 생산성의 약 90%를 얻을 수 있다. /commands의 경우, 보리스는 반복적인 워크플로우를 '내부 루프' 워크플로우라고 부르며, 하루에 여러 번 반복해야 하는 것들에 사용한다. 모든 /commands는 .claud 폴더 안에 저장되므로 git에 커밋하여 전체 팀과 공유할 수 있다. 서브에이전트의 경우, 사람들이 다양한 사용 사례로 활용하지만 보리스는 완전히 다른 지침이 필요한 간단한 워크플로우를 자동화하기 위해 사용한다. 그의 대부분의 에이전트는 코드 아키텍처 검증, 코드 리팩토링, 최종 빌드 검증에 사용된다.

12. 09:04 - 09:50

    Automata 소개 및 마무리

    영상 제작자는 수백만 명에게 AI로 구축하는 방법을 가르친 후 이러한 워크플로우를 직접 구현하기 시작했다고 밝힌다. 그 어느 때보다 빠르게 더 나은 제품을 만들 수 있다는 것을 발견했으며, 앱이든 웹사이트든 아이디어를 실현하는 데 도움을 주는 Automata를 소개한다. 좋은 아이디어가 있지만 구축할 기술 팀이 없는 사람들을 위한 기술 부조종사 역할을 하며, 수백만 명에게 가르친 동일한 워크플로우를 프로젝트에 직접 적용한다. 개발 팀을 고용하거나 관리하는 골치 아픈 일 없이 개념을 실제 작동하는 솔루션으로 전환하며, hello@automata.dev로 연락할 수 있다고 안내한다.