실전 가이드 · 4분 · 06.02

Stanford가 학부 교실에 AI 룰북을 만들었습니다 — CS336 CLAUDE.md 10가지 금지조항 전문 분석

loopy vibecoder

핵심 요약 (TL;DR)

Stanford CS336 'Language Modeling from Scratch' 강의가 2026년 6월 1일 학생용 CLAUDE.md 파일을 GitHub에 공개했습니다(HN 6/1 270점·106댓글). AI 코딩 도구의 사용은 허용하되 학습 경험을 침범하지 못하도록 10가지 금지조항을 명시한 학부 교실 최초의 공식 룰북입니다. 회사·팀의 AI 정책 문서로 그대로 변형 가능합니다.

왜 Stanford는 'AI 금지'가 아니라 'AI 룰북'을 택했나

AI 도구를 학생에게 어떻게 허용할지 고민해본 분이라면 두 가지 극단을 잘 아실 겁니다. 전면 금지 — 강제력 없는 honor code, 어차피 학생들은 ChatGPT를 켜죠. 전면 허용 — Transformer를 처음부터 짜보는 강의에서 학생이 GPT-4에게 "이 TODO 채워줘"라고 하면 강의 목적이 무너집니다.

Stanford CS336(담당: Tatsu Hashimoto, Percy Liang)는 세 번째 길을 골랐습니다. AI 도구는 허용한다. 단, 학습 경험을 침범하지 않는 행동 규칙을 텍스트 파일 하나로 명시한다. 이 파일이 stanford-cs336/assignment1-basics/CLAUDE.md로 GitHub에 그대로 공개돼 있어요(github.com/stanford-cs336/assignment1-basics/blob/main/CLAUDE.md).

흥미로운 건 형식입니다. PDF 가이드라인이 아니라 CLAUDE.md — Anthropic이 제안한 프로젝트별 instruction 파일 포맷. AI에게 직접 말 거는 룰북이죠. 학생 PC의 Claude Code·Cursor·Copilot이 작업 시작 시 자동으로 이 파일을 읽고, 자기 행동을 제약합니다. 강의자가 학생을 감시하는 게 아니라 AI 본인이 자기 자신을 제약하는 구조입니다.

10가지 금지조항 전문 — 그대로 직역

GitHub에 공개된 파일에 명시된 10가지 항목은 다음과 같습니다.

  1. Python 또는 의사코드(pseudocode) 작성 금지
  2. 어떤 문제든 해법(solution) 제시 금지
  3. 과제 코드의 TODO 섹션 완성 금지
  4. tokenizer, transformer, optimizer, training loop의 핵심 컴포넌트 구현 금지
  5. 3rd-party 구현으로 학생을 우회시키기 금지
  6. "문제를 어떻게 풀지"의 아이디어 제공 금지
  7. 학생 레포의 코드 직접 편집 금지
  8. bash 명령 실행 금지
  9. 과제 요구사항을 곧바로 working code로 변환 금지
  10. 직접 구현 요청이 오면 → 설명·디버깅 가이드·코드 리뷰·붙여넣기 불가능한 high-level outline으로 pivot

핵심은 마지막 항목입니다. 단순 금지가 아니라 "막힌 자리에서 어떻게 행동할지"의 대체 행동을 명시했다는 점이죠. AI에게 "하지 마"만 말하면 모델은 우회 경로를 찾습니다(Codex의 docker 그룹 사건 같은). 대신 "이렇게 해"를 같이 주면 alignment 강도가 다릅니다.

회사 정책으로 변형하는 7가지 항목

Stanford 룰북을 사내 정책으로 옮길 때 직역으로는 부족합니다. 학부 학습 경험 → 회사 코드베이스 보호로 목적이 바뀌니까요. 변형 예시는 이렇습니다.

첫째, "프로덕션 코드를 자동 생성 금지, 항상 review-ready 패치로 제출".

둘째, "DB 마이그레이션·인증·결제 모듈의 핵심 로직 자동 완성 금지" — 학생용 "tokenizer 금지"의 회사 버전.

셋째, "3rd-party 라이브러리 무단 추가 금지, 반드시 PR 설명에 근거 명시".

넷째, "shell 명령 실행 시 사전 승인 필수, sudo·rm·docker 명령은 별도 채널 확인" — 5월 31일 Codex docker 그룹 사건의 정확한 대응.

다섯째, "비밀키·환경변수에 접근 금지, 마주치면 즉시 작업 중단 후 보고".

여섯째, "커밋·푸시 자동 수행 금지, 항상 diff를 사람 리뷰 후 진행".

일곱째, "막힌 작업은 우회 시도 금지, 막힌 사유와 함께 보고".

프로젝트 루트에 이 7가지를 CLAUDE.md로 두면 끝입니다. 도구가 어떤 거든, 작업 시작 시 자동으로 이 파일이 컨텍스트에 들어갑니다.

더 깊은 의미 — 룰북이 정책 레이어가 되는 시점

Stanford 사건이 의미하는 건 단순합니다. AI 도구의 사용 정책이 PDF가 아니라 코드로 들어가는 시대가 시작됐다는 거죠. 학부 교실에서 시작했지만 회사·팀이 따라잡는 건 시간 문제입니다. 안영국 학원장님 같은 교육 운영자에게도, 사내 개발팀장에게도, 1인 개발자 본인에게도 동일하게 적용됩니다.

프로젝트 시작할 때 git init 다음 줄에 touch CLAUDE.md를 넣어보세요. 한 줄이라도 적어두면, AI 에이전트는 그 한 줄을 지키려고 노력합니다. 그게 정책의 시작입니다.

FAQ

Q. CLAUDE.md는 Claude Code 전용인가요?

A. 이름은 그렇지만 실제로는 Cursor, Codex, GitHub Copilot Workspace 등 대부분의 에이전트형 도구가 프로젝트 루트의 CLAUDE.md 또는 유사 instruction 파일을 자동으로 컨텍스트에 포함합니다. 도구별 별칭이 있는 경우(.cursorrules, AGENTS.md 등) 같이 두면 안전합니다.

Q. 정책이 너무 길면 AI가 무시하지 않나요?

A. Karpathy가 "4-rule CLAUDE.md로 Claude의 실수율을 크게 줄였다"고 한 발언이 회자된 적이 있습니다(2차 인용). 핵심은 짧고 명확한 행동 규칙입니다. 10개 이상으로 늘리면 모델이 우선순위를 흐리게 처리합니다. Stanford 룰북도 10가지에서 끊은 이유가 있어요.

Q. 학생/주니어가 우회하면요?

A. CLAUDE.md는 honor code의 디지털 버전입니다. 강제력은 약하지만, AI 자체가 자기 자신을 제약하는 구조이기 때문에 "적극적으로 우회"하지 않는 한 작동합니다. 우회 의도가 있는 사용자는 어떤 정책으로도 못 막습니다. 정책은 선의의 80%를 위한 안전망입니다.

0

댓글 0

아직 댓글이 없습니다