Anthropic 내부에서 하루에 이뤄지는 코드 변경은 2026년 5월 약 2,500건에서 9월 3만 건 이상으로 약 12배 늘었습니다. Anthropic Claude Code 팀의 한 구성원은 2026년 11월 한 개발자 콘퍼런스에서 Claude Code 권장 사용법(best practice)을 다시 정리해 발표했습니다. 핵심은 개발자가 세션 하나를 지켜보며 지시하던 자리에서 수십 개 세션을 동시에 관리하는 자리로 옮겨 갔다는 것입니다. 반면 대부분의 사용자는 여전히 한 번에 한 세션씩 순서대로 쓰고 있습니다. 이 차이를 좁히려면 사람이 직접 하던 다섯 가지 일을 모델, harness(모델을 둘러싸고 도구 실행과 권한을 관리하는 실행 틀), 실행 환경에 넘겨야 합니다.

사람이 하던 다섯 가지 일은 어디로 갔나

하던 일 예전 방식 지금 맡는 곳
방향 잡기 단계마다 지켜보며 지시하고 교정 모델과 최소한의 CLAUDE.md
명령 승인 명령마다 수동 확인하거나 권한 확인을 통째로 생략 auto mode의 classifier
거절하기 prompt(모델에 주는 지시문)로 하지 말라고 부탁 deny rule, sandbox, 클라우드 세션
결과 확인 사람이 변경 내용을 직접 검토 통과 기준, hook, 리뷰 agent
세션 시작 하위 작업마다 세션을 직접 열기 Claude Code Projects의 조율 세션

아래에서는 각 항목에서 무엇을 고쳐야 하는지 차례로 살펴봅니다.

방향 잡기: CLAUDE.md에서 덜어 낼 것

Opus 4.5를 쓰던 시기에는 개발자가 모델을 계속 지켜보면서 단계마다 지시하고 바로잡아야 했습니다. 그래서 CLAUDE.md에 IMPORTANT, NEVER 같은 대문자 강조 지시를 잔뜩 넣는 습관이 생겼습니다. Opus 5.5 같은 최신 모델에서는 이런 과도하거나 중복된 지시가 오히려 역효과를 내는 경우가 많습니다. 불필요한 tool call(모델이 도구를 호출하는 동작)이 늘고 성능이 떨어집니다.

권장하는 기준은 하나입니다. Claude가 저장소를 살펴봐도 스스로 알아낼 수 없는 정보만 CLAUDE.md에 남깁니다. 코드만 봐서는 드러나지 않는 구조상의 규칙이나 외부 문서의 위치가 여기에 해당합니다. 저장소 파일에서 바로 추론할 수 있는 내용은 지웁니다.

활용 예도 있습니다. 사업 전체를 디렉터리 하나로 관리하면서 CLAUDE.md를 지도처럼 쓰는 방식입니다. 이때 CLAUDE.md는 사내 위키, 브랜드 자료, 재무 장부가 어디 있는지만 가리킵니다.

직접 정리하기 어렵다면 Claude Code에서 /doctor prompt-audit을 실행합니다. 기존 지시를 현재 모델에 견주어, 불필요하거나 역효과를 내는 규칙을 골라 줍니다.

명령 승인: auto mode에 신뢰 범위 알려 주기

예전에는 선택지가 둘뿐이었습니다. 모든 명령을 사람이 일일이 승인하거나, 권한 확인을 통째로 건너뛰는 위험한 방식을 택해야 했습니다. 지금은 터미널과 데스크톱 앱 모두에서 auto mode가 기본 동작입니다.

auto mode에서는 독립된 classifier(명령의 위험도를 판별하는 분류 모델)가 bash 명령을 실행 전에 검사합니다. 테스트 실행이나 패키지 설치처럼 무해한 명령은 통과시키고, 판단이 서지 않으면 멈춥니다. 기본 설정에서는 쓰기 권한이 현재 디렉터리와 저장소로 한정됩니다. 배포용 브랜치로 push하는 것 같은 위험한 동작은 가로막습니다. 예를 들어 신뢰 범위 밖의 저장소로 코드를 배포하려 하면 auto mode가 접근을 제한합니다.

작업이 자주 멈추지 않게 하려면 신뢰 범위를 미리 알려 줘야 합니다.

  • settings.json에 신뢰하는 GitHub 조직, S3 bucket, 내부 도메인을 평범한 문장으로 적습니다.
  • /auto-mode-setup을 실행하면 프로젝트 이력과 최근 세션을 분석해 권한 설정 초안을 만들어 줍니다.

2026년 8월 Anthropic 조사에 따르면, 사람이 직접 승인하는 방식에서는 명백히 위험한 명령의 14%만 걸러졌습니다. auto mode는 89%를 막았습니다. 프로그래밍 배경이 없는 사용자일수록 이런 자동 안전장치가 더 중요해 보입니다.

컨베이어 위 명령 블록이 검사 관문을 지나고 일부가 차단벽 앞에 멈춘 모습

▲ 명령 검사와 차단 규칙

거절하기: 되돌릴 수 없는 일은 규칙으로 막기

89%를 막는다는 것은 위험한 명령 10개 가운데 1개쯤은 여전히 통과할 수 있다는 뜻입니다. 그래서 auto mode만으로는 부족하고, 예외 없이 막는 규칙이 따로 필요합니다.

deny rule(무조건 차단 규칙)은 settings.json에 적습니다. classifier보다 먼저 평가되며, 해당하는 명령은 조건 없이 막습니다. 무엇을 deny rule로 막을지는 "되돌릴 수 있는가"라는 질문으로 정합니다.

되돌릴 수 있는 일 되돌릴 수 없는 일
코드, 테스트, 문서 수정 파일 영구 삭제
테스트 실행 비밀 정보와 자격 증명 노출
버전 관리로 복구되는 작업 외부로 나가는 전송과 연락

왼쪽은 모델에 맡겨도 됩니다. 오른쪽은 deny rule이나 sandbox(프로세스를 격리해 접근 범위를 제한하는 환경)로 막아야 합니다. 예를 들어 .claude/settings.json에 git reset 같은 명령을 차단하는 규칙을 두고, .env와 ~/.ssh 같은 자격 증명 파일은 읽기와 쓰기를 모두 차단합니다.

prompt로 "비밀 정보를 건드리지 말라"고 부탁하는 것과 권한 설정으로 강제하는 것은 보안 면에서 전혀 다릅니다. 명령 검사만으로 잡히지 않는 경로도 있습니다. npm 같은 패키지 관리자로 테스트를 돌리면 검증되지 않은 의존성 코드가 함께 실행됩니다. 이 코드가 환경 변수나 SSH 키에 접근해도 bash 명령 단계에서는 경고가 뜨지 않습니다.

이 틈은 실행 환경에서 막습니다.

  • /sandbox를 실행하면 운영체제 수준에서 프로세스가 격리되어 파일 접근과 외부 네트워크 연결이 제한됩니다.
  • 몇 시간씩 걸리는 긴 작업은 클라우드 세션에서 돌립니다. 로컬 자격 증명이 없는 일회용 원격 기기에서 실행되므로 내 컴퓨터의 정보가 노출되지 않습니다.

결과 확인: 통과 기준과 hook으로 검증 맡기기

세션이 오랫동안 혼자 돌아간 뒤에 수천 줄의 변경을 사람이 직접 검토하는 것은 현실적이지 않습니다. 같은 prompt에서도 결과는 여러 갈래로 나올 수 있습니다. 인증 시스템을 새 API 엔드포인트로 옮기는 작업을 예로 들면, 겉으로는 통과해도 다음과 같은 결과가 나올 수 있습니다.

  • 예전 엔드포인트가 그대로 살아 있습니다.
  • 새로 로그인하는 사용자에게만 적용됩니다.
  • 기존 사용자가 모두 로그아웃됩니다.

그래서 작업 중간중간에 통과와 실패를 가르는 객관적인 기준을 둬야 합니다. 화면 스크린샷 확인이나 자동화된 단위 테스트가 그런 기준입니다. 코딩이 아닌 지식 업무에도 같은 방식을 씁니다. 시장 조사 보고서라면 모든 사실 주장이 유효한 출처로 연결되는지, 표의 수치가 스프레드시트 원본과 맞는지를 기준으로 삼습니다.

Claude에게 "완료"와 "좋은 결과"가 무엇인지 먼저 정의하게 하는 방법도 있습니다. 그러면 모델이 첫 결과물을 내놓기 전에 자기 초안을 평가하고 고칩니다.

검사대에서 불합격한 부품이 다시 작업 팔로 돌아가는 자동 검증 순환 구조

▲ 자동 검증과 재작업

hook의 exit code는 2로

hook(특정 시점에 자동으로 실행되는 스크립트)을 걸어 두면 검증이 자동으로 돌아갑니다. 시점은 세 가지입니다.

  • 도구 사용 직후: lint(코드 형식과 오류 검사)
  • 작업 완료 시: 해당 작업의 테스트
  • Claude가 작업을 멈출 때: 전체 테스트

여기서 놓치기 쉬운 것이 exit code(스크립트가 끝나면서 돌려주는 종료 값)입니다. 테스트가 실패했을 때 hook 스크립트는 기본값인 1이 아니라 2로 끝나야 합니다. 2로 끝나면 Claude Code가 돌아가서 문제를 고칩니다. 1로 끝나면 실패했는데도 작업이 완료로 처리됩니다.

hook 검증이 실패하면 돌아가 고치는 흐름 아니오 예 도구 사용 직후 lint 작업 완료 시해당 작업의 테스트 테스트 통과? hook 스크립트가exit code 2로 종료 Claude Code가돌아가서 문제 수정 Claude가 멈출 때전체 테스트
▲ hook 검증이 실패하면 돌아가 고치는 흐름

Anthropic 내부에서는 모든 pull request(코드 변경을 합치기 전에 올리는 검토 요청)가 사람이 보기 전에 새로 띄운 독립된 Claude 리뷰 agent(스스로 작업을 수행하는 AI)를 거칩니다. 리뷰 agent들은 버그를 찾고 심각도를 확인한 뒤, 잘못 짚은 지적을 걸러 내고 댓글을 남깁니다.

세션 시작: Claude Code Projects에 맡기기

마지막으로 남은 수작업은 하위 작업마다 세션을 직접 여는 일입니다. Anthropic은 Claude Code Projects를 Pro, Max, Ultra 요금제에 베타로 내놓았습니다. 최상위 세션 하나가 한 주 분량의 프로젝트 목표를 통째로 관리하는 기능입니다.

최상위 세션은 프로젝트의 전체 작업 목록을 받습니다. 그리고 결과물 하나마다 독립된 작업 세션을 자동으로 띄워 관리합니다. 프로그래밍뿐 아니라 고객 보고서, 리서치 문서, 영상 제작 과정에도 같은 구조를 쓸 수 있습니다.

프로젝트 설정에서는 역할마다 다른 모델을 지정할 수 있습니다. 조율은 Fable 5.2처럼 추론에 강한 모델에 맡기고, 실행은 Opus 5.5에 맡기는 식입니다. 계획과 평가를 맡는 모델과 실행하는 모델을 나누는 편이 여러 agent가 함께 일하는 프로젝트에 더 잘 맞는 것으로 보입니다.

정리: 지금 고칠 수 있는 것들

다섯 항목을 관통하는 방향은 같습니다. 사람의 노력을 세세한 실행에서 빼내어 harness, 실행 환경, 자동 검증 기준을 설계하는 쪽으로 옮기는 것입니다. Claude Code를 한 세션씩 지켜보며 쓰고 있다면 아래 순서로 바꿔 볼 수 있습니다.

  1. /doctor prompt-audit을 실행해 CLAUDE.md에서 대문자 강조와 저장소에서 추론할 수 있는 내용을 덜어 냅니다.
  2. /auto-mode-setup으로 권한 설정 초안을 만들고, settings.json에 신뢰하는 저장소, 도메인, 저장 공간을 적습니다.
  3. 되돌릴 수 없는 작업을 골라 deny rule로 막습니다. .env와 ~/.ssh 같은 자격 증명 파일은 읽기와 쓰기를 모두 막습니다.
  4. 긴 작업은 /sandbox나 클라우드 세션 안에서 돌립니다.
  5. 테스트와 lint hook을 걸고, 실패할 때 exit code 2를 반환하는지 확인합니다.
  6. 어느 정도 규모가 있는 프로젝트 하나를 골라 Claude Code Projects에 맡겨 봅니다. 그 뒤에도 남는 수작업을 하나씩 자동화합니다.

제 판단으로는, 3번과 5번이 갖춰져야 여러 세션을 동시에 맡기고 자리를 비울 수 있습니다. 차단 규칙과 검증 기준 없이 세션 수만 늘리면 사람이 검토할 양만 늘어날 수 있습니다.