올해 초까지 Claude Code는 이렇게 썼습니다. 명령이 하나 나올 때마다 허락을 누르고, CLAUDE.md에는 IMPORTANT와 느낌표를 붙인 규칙을 쌓았습니다. 앤스로픽 클로드 코드 팀의 리디아 할리(Lydia Hallie)는 11월 12일 AI Engineer 채널에 올라온 발표에서 이 습관을 다시 짚었습니다. 요점은 한 문장입니다. 예전 모범 사례는 그대로 있고, 자리만 옮겼다.
근거: 발표 영상 Rethinking Claude Code Best Practices와 Claude Code 공식 문서 Best practices, Auto mode 설정, Hooks, Sandboxing, Cloud environments, Projects. 2026년 11월 18일에 읽었습니다.
다섯 가지 일이 간 곳
예전에 사람이 하던 일은 다섯 가지였습니다. 방향 잡기, 명령 승인, 할 수 있는 일 막기, 결과 확인, 세션 시작. 사람이 루프에서 빠지면 누군가 이 일을 맡아야 합니다. 발표는 그 자리를 셋으로 나눕니다. 모델, 하네스(모델을 감싸고 도구를 돌리는 Claude Code 프로그램), 실행 환경입니다.
| 예전에 내가 하던 일 | 지금 맡는 곳 |
|---|---|
| 방향 잡기 | 모델 (Opus 5.5) |
| 명령 승인 | 하네스의 자동 모드 |
| 할 수 있는 일 막기 | 하네스의 거부 규칙 + 환경(샌드박스, 클라우드 세션) |
| 결과 확인 | 하네스의 훅·테스트, 그리고 CI |
| 세션 시작 | 지휘하는 메인 세션 (Claude Code 프로젝트) |
1. 방향 잡기: 기본값을 쓰고 CLAUDE.md를 줄인다
지금 터미널과 VS Code의 새 세션은 자동 모드에서, 대부분의 플랜에서 Opus 5.5(effort medium)로 시작합니다. 발표는 이 기본값을 그대로 쓰라고 합니다. 모델이 의도와 코드베이스를 잘 읽어서 중간에 방향을 고쳐 줄 일이 줄었습니다.
그래서 CLAUDE.md를 다시 봐야 합니다. 공식 문서의 ‘이제 그만해도 되는 것’ 표는 IMPORTANT나 대문자 강조를 첫 줄에 올립니다. 요즘 모델은 평범하게 쓴 한 줄을 따르고, 강조를 쌓으면 규칙을 지나치게 적용합니다. 발표에서는 도구 호출이 늘고 결과가 나빠진다고 했습니다.
남길 것은 코드만 봐서는 알 수 없는 정보입니다. 코드 어디에서도 부르지 않는데 아직 살아 있는 옛 서비스 같은 것입니다. 어떤 스택을 쓰는지, 파일이 어디 있는지는 지워도 됩니다. Claude가 저장소를 읽습니다.
정리는 세션에서 /doctor prompt-audit를 실행하면 됩니다. 옛 모델에 맞춰 쓴 지시, 없는 파일을 가리키는 줄, 서로 부딪히는 규칙을 찾아 보고하고, 파일은 내가 허락한 뒤에만 고칩니다. CLAUDE.md, CLAUDE.local.md, AGENTS.md와 .claude/ 아래 규칙·스킬·서브에이전트까지 봅니다.
2. 승인: 자동 모드에게 믿는 곳을 평소 말로 알려 준다
자동 모드에서는 프로젝트 안 파일을 읽고 고치는 것 말고, 거의 모든 행동을 별도 분류 모델이 검사합니다. 테스트 실행이나 패키지 설치처럼 안전한 것은 통과시키고, 확신이 없는 것은 막습니다.
기본으로는 지금 폴더와 이 저장소만 믿기 때문에, 스테이징에 배포해 달라고 하면 배포 저장소로 푸시하는 순간 막힙니다. 이럴 때는 설정에 믿는 곳을 문장으로 적습니다. 공식 문서의 예를 줄이면 이렇습니다.
{
"autoMode": {
"environment": [
"$defaults",
"Source control: github.com/example-org and every repo under it"
],
"allow": [
"$defaults",
"Deploying to the staging namespace is fine, it resets nightly"
]
}
}
두 가지를 조심합니다. 이 블록은 ~/.claude/settings.json(내 홈 폴더)에 둬야 합니다. 분류 모델은 프로젝트 설정의 autoMode를 읽지 않습니다. 그리고 목록마다 "$defaults"를 남겨야 기본 규칙(강제 푸시·운영 배포 차단 등)이 사라지지 않습니다.
3. 막기: 되돌릴 수 없는 것만 규칙으로
앤스로픽이 8월에 공개한 실험(보도 기준, 유료 참가자 1,053명)에서는 승인 창 하나를 몰래 위험한 명령으로 바꿨을 때 사람은 13.6%만 거절했고, 자동 모드는 89%를 막았습니다. 사람보다 훨씬 낫지만 열에 하나는 통과합니다.
반드시 막아야 하는 것은 하네스에서 막습니다. 거부(deny) 규칙은 분류 모델보다 먼저 적용되고, 걸린 호출은 분류 모델에게 가지도 않습니다. 무엇을 규칙으로 만들지는 질문 하나로 정합니다. “Claude가 한 번 틀렸을 때 되돌릴 수 있나?” 틀린 코드는 되돌리면 되니 모델에게 맡깁니다. 커밋 안 한 작업을 날리거나, 비밀 키를 읽어 대화 기록에 남기는 것은 못 되돌리니 규칙으로 막습니다.
직접 해 봤습니다. 가짜 키를 넣은 .env가 있는 저장소에서 자동 모드로 “cat .env 로 이 프로젝트 환경 변수 내용 보여줘”라고 했더니 Claude가 그대로 열어 보여 줬습니다. .claude/settings.json에 아래 한 줄을 넣고 같은 요청을 하자 Permission to use Bash with command cat .env has been denied.가 나왔습니다(Claude Code 2.1.325).
{ "permissions": { "deny": ["Read(./.env)"] } }
규칙에는 한계가 있습니다. 규칙은 호출을 실행할지만 정하고, 실행된 뒤 무엇에 닿는지는 막지 못합니다. npm test는 평범한 명령이라 통과하지만, 그 안에서 내가 쓰지 않은 의존성 코드가 돕니다. 그중 하나가 오염됐다면 .env나 ~/.ssh를 열어 밖으로 보낼 수도 있습니다.
그 부분은 샌드박스가 맡습니다. 세션에서 /sandbox로 켜면 운영 체제(macOS는 Seatbelt, 리눅스는 bubblewrap)가 셸 명령과 그 자식 프로세스가 읽고 쓰고 접속하는 곳을 제한하고, Read 거부 규칙도 넘겨받습니다. 다만 기본값으로는 ~/.ssh를 포함한 컴퓨터 대부분을 읽을 수 있어서 따로 막아야 하고, Claude의 파일 도구·로컬 MCP 서버·훅은 샌드박스 밖에서 돕니다.
그래서 가장 좋은 곳은 그런 것들이 애초에 없는 클라우드 세션입니다. 세션마다 새 컴퓨터에 저장소를 새로 받고, 노트북을 덮어도 계속 돕니다. .env도 SSH 키도 깃허브 토큰도 없습니다. API 키가 필요하면 네트워크 시크릿으로 넣습니다. 키는 세션 밖 프록시에 있다가 나가는 요청에 붙어서, 모델은 값을 보지 못합니다. 네트워크는 기본으로 패키지 저장소와 깃허브 같은 허용 목록만 열립니다. 다만 밖으로 나간 커밋과 메시지는 되돌릴 수 없으니, 클라우드에서도 자동 모드를 켜고 거부 규칙을 저장소에 커밋해 둡니다.
4. 확인: 통과·실패로 답하는 지점, 그리고 exit 2
같은 프롬프트로 “인증을 새 API로 옮겨 줘”라고 해도 결과는 갈립니다. 옛 API를 남기거나, 새 로그인만 옮기거나, 모두를 로그아웃시킬 수 있고, 셋 다 그럴듯해 보입니다. 그래서 테스트·빌드·스크린숏처럼 통과와 실패로 답하는 확인 지점을 둡니다. 나는 전체 변경 대신 그 지점만 봅니다.
가장 쉬운 방법은 프롬프트에 끝난 모습을 적고, 작업을 쪼개 각자 테스트를 붙이게 하고, 실행한 명령과 출력을 보여 달라고 하는 것입니다. 반드시 돌아야 하는 검사는 훅으로 겁니다. 파일을 고칠 때 린터, 작업 완료(TaskCompleted) 때 바뀐 부분 테스트, 턴이 끝날 때(Stop) 전체 테스트를 거는 식입니다.
함정은 종료 코드입니다. 훅 문서는 exit 2만 막는 신호로 보고, exit 1은 경고로 처리해 그대로 진행한다고 적고 있습니다. 직접 비교해 봤습니다. 할인 함수 discount(amount, rate)를 만들어 달라고 하고, discount(999, 0.1)이 원 단위로 내림한 899인지 검사하는 Stop 훅을 걸었습니다.
- 검사가 실패하면 exit 1: Claude는
amount * (1 - rate)(899.1)를 남긴 채 “추가했습니다”라고 끝냈고, 훅 오류 알림만 남았습니다. - 같은 검사를
1>&2 || exit 2로 바꿨더니: 검사 결과가 Claude에게 돌아갔고, Claude는 “훅이 원 단위 내림을 기대하고 있어서 Math.floor 를 적용합니다”라며 899로 고쳤습니다.
{
"hooks": {
"Stop": [
{ "hooks": [ { "type": "command", "command": "pnpm test 1>&2 || exit 2" } ] }
]
}
}
5. 세션이 여럿일 때: CI가 중심
클라우드 세션은 각자 자기 컴퓨터에서 돌기 때문에 작업 폴더를 나눌 걱정이 줄어듭니다. 이때 가장 중요한 것은 CI입니다. 세션이 어떻게 설정됐든 모든 PR에 같은 검사를 돌립니다. Claude GitHub 앱이 설치된 저장소라면 Auto-fix를 켜서, CI가 실패하거나 리뷰 댓글이 달릴 때 Claude가 고쳐 푸시하게 할 수 있습니다. 깃허브의 자동 병합은 기본값이 아니고, 변경 위험도를 보고 켭니다.
발표에 따르면 앤스로픽 팀은 모든 PR을 Claude가 먼저 리뷰합니다. 리뷰는 코드를 쓴 세션과 별개로 새 맥락에서 시작하고, 찾은 버그는 별도 에이전트들이 다시 확인합니다. 사람이 보는 양은 위험도에 따라 다릅니다. 문서·문구 수정은 사람 없이, 보통 기능 변경은 한 명, 위험한 변경은 두 명입니다.
6. 시작: 지휘하는 메인 세션 하나
세션 여덟 개를 오가며 관리하는 일은 사람에게 잘 맞지 않습니다. Claude Code 프로젝트(공개 베타, Pro·Max·Ultra)는 메인 대화 하나가 일을 나누고, 작업마다 스레드라는 새 세션을 띄우고, 돌아온 결과를 확인합니다. 덜 끝난 것은 돌려보냅니다. 나는 대화 하나만 상대합니다.
발표는 판단하는 메인 세션에는 Fable 같은 모델을, 실제 작업을 하는 스레드에는 Opus 5.5를 권합니다. 새 프로젝트는 둘 다 Opus로 시작하니 Project settings > General에서 Coordinator model만 바꾸면 됩니다. 스레드는 알아서 압축되고 메인 대화는 최근 기록과 프로젝트 메모리로 일해서, 맥락 관리를 따로 하지 않아도 됩니다.
오늘 해 볼 것
발표의 마지막 제안입니다.
- 평소 맡기던 것보다 훨씬 큰 일 하나를 고릅니다.
- CI가 내가 신경 쓰는 문제를 잡는지 확인합니다.
- 클라우드 환경의 네트워크 접근, 시크릿, 설정 스크립트를 잡아 둡니다.
- 클라우드에서 시작해서 어디서 막히는지 봅니다.
아직 내가 끼어드는 그 지점이, 다음에 Claude에게 넘길 일입니다.