Claude Code 작업 기록을 Claude Docs 런북으로 정리하는 법
TL;DR
현재 Claude Code 세션에서 Claude Docs 런북을 요청합니다. 터미널이 돌려준 웹 링크를 열고 이미 확보된 작업 근거와 단계별 상태를 대조합니다.
이 글의 완료물은 실행 여부·결과·미확인 사항을 구분한 내부 검토본입니다. 새 명령을 실행하거나 공유하지 않습니다. 근거를 읽은 사람이 내부 검토를 승인해야 마칩니다.
핵심 3줄 요약
핵심 1
세션 런북은 작업을 다시 수행하는 지시서가 아니라, 확보된 증거를 검토하는 문서로 설계합니다.
핵심 2
근거 검토에서는 ‘실행했다’와 ‘성공했다’를 구분합니다. 확인하지 못한 내용은 미확인으로 표시합니다.
핵심 3
완료 기준은 문서 생성이 아니라, 근거 연결과 사람의 내부 승인까지 포함하도록 제안합니다.
이 글에서 다룰 내용
Claude Docs의 기능 범위, 사용 전 조건, 세션 런북 작성 6단계, 복사용 프롬프트, 근거와 상태의 분리, 내부 인수인계 주의사항
확인 기준은 2026년 10월 6일입니다. 제품 기능은 공식 문서에 근거합니다. 아래 런북 구조와 승인 절차는 저자의 실무 제안입니다.
실제 사용 테스트 결과를 보고하는 글은 아닙니다.
기능 정의
Claude Docs는 Claude 계정에 저장되는 리치 텍스트 문서이며 Artifacts에서 찾을 수 있습니다.
공식 안내의 ‘Where you can create docs’에는 현재 Claude Code 세션을 명세서·런북·결과 보고서로 정리하도록 요청하는 기능이 명시되어 있습니다. 터미널에서는 웹에서 문서를 여는 링크를 반환합니다.
여기서는 이미 작업 중인 터미널 세션 한 개에서 시작합니다. 새로운 세션을 만들어 전체 기록을 자동 복구하는 절차나 특정 설치 버전의 제공을 보증하지 않습니다. 이번 요청이 Docs 문서 생성으로 이어지는지 현재 계정에서 확인합니다.
이 글에서 제안하는 ‘세션 런북’은 비민감 내부 Docs 검토본입니다. 작업 목적, 실행 절차별 근거, 실행 여부, 결과, 주의점, 검토자, 승인 상태를 묶어 다음 담당자가 판단할 수 있도록 구성합니다.
대화 요약과의 차이는 문장의 매끄러움보다 결론을 뒷받침하는 증거의 위치를 우선한다는 점입니다. ‘수정 완료’라는 문장만 남기지 않습니다. 어떤 범위에서 무엇이 확인되었는지를 함께 적습니다.
언제 쓰면 좋은가
저자는 작업 담당자가 바뀌거나, 해결 과정에 여러 실패와 우회가 있었거나, 다음 담당자가 재실행 여부를 판단해야 할 때 이 형식을 권합니다.
예를 들어 오류 수정 세션을 정리한다면 ‘원인 후보’, ‘실제로 적용한 조치’, ‘확보된 검사 결과’, ‘남은 위험’을 분리합니다. 채택하지 않은 접근도 이유와 함께 남겨 같은 실패를 반복하지 않도록 합니다.
다만 모든 작업을 성공 사례로 포장하는 용도로 사용하지 않습니다. 증거가 부족하면 ‘판정 보류’가 적절한 결론입니다.
시작 전 확인할 조건
공식 안내상 Claude Docs는 Pro·Max·Team·Enterprise의 베타 기능입니다. Pro·Max·Team에서는 기본 활성화됩니다.
Enterprise에서는 소유자가 Organization settings > Artifacts에서 켜야 합니다. CMEK·ZDR·HIPAA-ready 구성은 지원하지 않습니다.
지역·언어·특정 클라이언트 버전 조건은 이 도움말만으로 단정하지 않습니다. 현재 계정과 조직 정책에서 사용 가능한지를 직접 확인합니다.
저자는 계정 조건과 별도로 문서화가 승인된 비민감 세션인지 먼저 확인할 것을 권합니다. 계정에 저장할 수 있다는 사실과 조직이 해당 자료의 저장을 허용한다는 판단은 별개로 취급합니다.
허용 입력은 이미 확보된 증거 중 사람이 승인한 비민감 발췌와 참조 정보로 제한합니다. 비밀값, 고객 개인정보, 원본 로그 전체를 제외하고도 근거를 설명할 수 있는지 확인합니다.
민감 내용이 포함된 세션이라면 프롬프트의 제외 문구만 믿고 진행하지 않습니다. 조직의 자료 취급 기준에 맞는 입력 범위가 확보될 때까지 문서화를 보류합니다.
세션 런북을 만드는 순서
1. 문서화 범위를 고정합니다
작업 목적과 대상 범위를 한두 문장으로 적습니다. ‘이번 세션에서 확인된 내용만 정리하며 새 작업은 수행하지 않는다’는 경계를 명시합니다.
전체 저장소나 과거 세션까지 조사한 것처럼 범위를 넓히지 않습니다. 기준 시점과 제외 범위를 함께 남기도록 제안합니다.
문서 독자는 이 작업을 다시 검토할 담당자 한 명으로 정합니다. 첫 문단에는 작업 대상과 확인 시점, 포함한 증거 범위를 적습니다. 모델에게 전체 프로젝트의 정상 동작을 인증하거나 운영 환경의 안전성을 결론 내리도록 요청하지 않습니다.
2. 승인된 근거를 구분합니다
이미 확보된 비민감 발췌에 근거 ID를 붙입니다. 세션 내 위치나 승인된 내부 참조를 연결합니다.
원문 근거는 전체 로그 복사가 아니라, 판단에 필요한 승인된 짧은 발췌로 제한합니다.
출처를 찾지 못한 설명은 사실 목록에서 분리합니다. 추가 파일 읽기나 명령 실행으로 빈칸을 채우지 않습니다.
예를 들어 승인된 근거에 내부 식별자 E-A를 붙였다면, 절차마다 어떤 발췌를 가리키는지 적습니다. 이 식별자는 사람이 정하는 검토 규칙이며 Docs의 자동 인용 기능 이름이 아닙니다. 날짜·경로·출력 값은 승인된 근거에 실제로 있을 때만 기록합니다.
3. 현재 세션에서 자연어로 요청합니다
Claude Code에 ‘현재 세션을 Claude Docs 런북으로 정리해 주세요’라고 요청합니다. 현재 세션의 런북 전환과 터미널 링크 반환은 공식 안내에 있는 진입 방식입니다. 별도 전용 명령이나 플래그를 만들 필요는 없습니다.
요청에는 독자, 허용 입력, 제외 입력, 출력 형식과 완료 기준을 함께 적습니다. 문서 생성 외의 작업을 허용하지 않는다고 명시합니다.
현재 계정에서 문서가 만들어지지 않거나 일반 텍스트 답변만 나온다면 그 답변을 Docs 생성 성공으로 기록하지 않습니다. 미지원 상태를 우회하려고 새 플러그인 설치, 조직 설정 변경, 모델 전환을 임의로 시도하지 않습니다. 확인한 도움말과 실제 화면의 차이를 남깁니다.
4. 반환된 링크에서 검토본을 확인합니다
터미널이 반환한 링크를 웹에서 열어 문서 내용을 검토합니다. 검토 대상은 제목의 완성도가 아니라, 각 절차의 근거 연결과 상태 표시입니다.
단계별 상태표에는 ‘원문 근거·실행 여부·결과·주의점·검토자·승인 상태’를 둡니다. 검토자와 승인 상태가 정해지지 않았다면 각각 ‘미지정’, ‘승인 대기’로 남깁니다.
한 단계에 성공 문구와 오류 출력이 함께 있으면 서로 다른 실행을 섞었는지 확인합니다. 일치하는 근거가 없으면 성공 여부를 보류합니다. 표의 모든 빈칸을 채우는 것보다 증거가 없는 칸을 드러내는 편이 다음 검토에 도움이 됩니다.
5. 근거와 결론을 대조합니다
Claude Code의 공식 모범 사례는 관찰 가능한 검사와 결과 증거를 제시하도록 권합니다. 성공 선언만 믿지 말라는 취지입니다. Docs가 사실을 자동 검증한다는 뜻은 아닙니다.
이 문서화 단계에서는 새 검사를 실행하지 않습니다. 이미 있는 결과만 대조합니다. 실패·반례·미실행 테스트를 삭제하지 않습니다.
제안한 명령, 실제 실행한 명령, 확인된 출력은 별도 항목입니다. 초안이 제안만 한 테스트를 실행 완료로 바꿨다면 그 행을 미실행으로 되돌려 적습니다. 새로운 테스트가 필요하다는 의견은 후속 확인 항목에 남기되 이번 요청으로 실행하지 않습니다.
6. 사람의 내부 승인으로 마칩니다
저자는 담당자가 입력 범위, 근거 연결, 미확인 항목을 검토한 뒤 승인하도록 제안합니다. 승인된 검토본만 내부 인수인계의 기준으로 삼습니다.
승인은 사람의 내부 검토에 한정합니다. 문서 생성 요청을 커밋·배포·외부 공유 승인으로 확대 해석하지 않습니다.
검토 담당자는 원문으로 돌아갈 수 있는지, 미확인 부분이 보이는지, 기록한 범위와 결론이 일치하는지 확인합니다. 내부 검토 승인과 문서의 실제 접근 권한 변경은 다릅니다. 이번 작업은 승인 상태 기록에서 끝내고 다른 사람에게 링크를 보내는 일도 별도로 결정합니다.
복사해서 쓰는 프롬프트
목표: 현재 Claude Code 세션을 Claude Docs의 비민감 내부 세션 런북 검토본으로 정리합니다. 문서 생성 외의 새 실행은 하지 않습니다.
허용 입력: 현재 세션에서 이미 확보되었고 사람이 문서화를 승인한 비민감 근거 발췌와 세션 내 위치·승인된 내부 참조만 사용합니다.
제외 입력: 비밀값·개인정보·원본 로그 전체를 제외합니다. 추가 조회·셸 실행·저장소 변경·커밋·푸시·배포·외부 전송·공유·내보내기를 하지 않습니다.
출력 형식: 목적과 범위, 절차별 상태표의 원문 근거·실행 여부·결과·주의점·검토자·승인 상태, 실패와 반례, 미확인 항목을 작성합니다.
완료 기준: 모든 절차에 근거 또는 근거 없음 표시를 남깁니다. 미실행 테스트를 통과로 쓰지 않습니다. 추가 실행 없이 사람의 내부 검토 대기 상태로 마칩니다.
추정 금지: 누락된 출력·수치·성공 여부·검토자·승인을 만들지 않습니다. 미확인과 미실행을 구분합니다. 근거가 충돌하면 양쪽을 남깁니다.
승인 지점: 허용 입력이 불명확하면 작성을 멈추고 사람에게 확인합니다. 내부 인수인계 승인도 사람이 직접 결정하도록 남깁니다.
이 프롬프트는 저자의 작성 지침입니다. 권한 통제 장치가 아닙니다. 실제 권한과 조직 정책을 대신하지 않습니다.
실전 인사이트
저자는 상태를 ‘실행 여부’와 ‘결과’로 나누는 방식을 권합니다. 실행 사실이 확인되어도 결과가 없으면 성공으로 판정하지 않습니다.
가상의 작성 예시는 ‘실행 여부: 실행 확인, 결과: 출력 근거 부족으로 미확인, 승인 상태: 보류’입니다. 이는 실제 세션의 실행 결과가 아니라 상태를 구분하는 예시입니다.
반대로 테스트가 제안되기만 했다면 ‘실행 여부: 미실행, 결과: 판정 불가’로 적습니다. 일부 검사가 통과한 근거만 있다면 그 범위만 기록합니다. 전체 기능의 정상 동작으로 일반화하지 않습니다.
내부 인수인계용 검토본에는 해결되지 않은 실패를 남기는 편을 권합니다. 다음 담당자가 알아야 할 것은 성공 서사보다 확인된 범위와 남은 불확실성입니다.
주의할 점
공식 안내상 문서는 처음에는 비공개입니다. 버전 기록은 아직 제공되지 않습니다. 문서 내부의 편집과 댓글 활동도 Compliance API에 기록되지 않습니다.
따라서 Docs만으로 변경 이력이나 감사 기록을 충족한다고 판단하지 않습니다.
검토 전 승인된 발췌와 상태 메모는 조직이 허용한 위치에 따로 보존합니다. 이는 사람이 만드는 기록이며 제품의 자동 백업 기능이 아닙니다. 프롬프트의 입력 제한은 현재 세션에 이미 포함된 비밀을 지우는 기능도 아니므로 민감한 세션은 처음부터 제외합니다.
현재 세션을 정리할 수 있다는 안내를 전체 대화 원문 보존, 저장소 전체 감사, 자동 동기화 보장으로 확대하지 않습니다. 이 글의 상태표 역시 저자의 제안이지, 제품이 자동 제공하는 검증 체계가 아닙니다.
문서화 중 근거가 부족해도 셸 명령이나 테스트를 추가 실행하지 않습니다. 저장소 변경, 커밋·푸시·배포, 외부 전송·공유·내보내기도 이 작업의 범위 밖입니다.
자주 묻는 질문
1. 전용 슬래시 명령을 입력해야 하나요?
이 글에서는 현재 Claude Code 세션에서 자연어로 런북을 요청하는 공식 경로를 사용합니다. 문서에 없는 슬래시 명령·플래그·버전 조건·기기 설정을 추가하지 않습니다.
2. 테스트 결과가 없으면 다시 실행해야 하나요?
이 글의 문서화 절차에서는 실행하지 않습니다. ‘미실행’ 또는 ‘결과 미확인’으로 남깁니다. 추가 검증은 별도 작업과 승인으로 분리합니다.
3. 근거 검토를 Claude가 자동으로 끝내 주나요?
공식 모범 사례는 관찰 가능한 검사와 증거 제시를 권합니다. 이를 근거의 진위를 자동 보증하는 기능으로 해석하지 않습니다. 최종 대조와 승인은 사람이 맡도록 제안합니다.
4. 생성된 문서를 바로 인수인계해도 되나요?
저자는 검토 전 문서를 초안으로 취급합니다. 근거 연결, 민감정보 제외, 실패와 미확인 항목을 확인하고 사람이 승인한 뒤 내부 인수인계에 사용하도록 권합니다.
출처
2026-10-06 공식 본문을 직접 HTTP 200으로 확인했습니다. 첫 출처는 세션→Docs 진입과 제공 조건을, 둘째는 확인 가능한 증거를 요구하는 작업 원칙을 뒷받침합니다. 상태표와 내부 승인 절차는 저자의 제안입니다.
마무리
Claude Code 작업 기록을 런북으로 정리할 때는 문서의 분량보다 판단 가능성을 우선합니다. 승인된 비민감 근거만 사용합니다.
실행 여부와 결과를 분리하세요. 실패와 반례를 그대로 남깁니다.
이 글의 완료 기준은 ‘그럴듯한 요약’이 아닙니다. 추가 실행 없이 작성한 Docs 검토본을 사람이 확인하고 승인하는 것입니다.
한 줄 요약: 세션 런북은 성공을 선언하는 문서가 아니라, 이미 확보된 근거와 남은 불확실성을 사람이 검토하는 내부 인수인계 문서입니다.
감자나라 AI 강의보기 5,000 
