릴스에서 클로드 코드 한도 절약 팁을 봤다. “공식 문서 기반”이라고 했다. 진짜인지 확인했다. 클로드 코드 토큰 절약이 목적이면 결국 습관 5개로 요약된다.
릴스가 주장한 5가지 습관은 뭔가
릴스가 소개한 건 외부 도구가 아니다. 클로드 코드에 이미 내장된 명령어 5가지다. 순서대로 적으면 이렇다.
- /clear와 /rename — 작업이 바뀌면 /clear로 컨텍스트를 정리한다. 나중에 다시 찾아야 할 세션이라면 /clear 전에 /rename부터 해둔다.
- @파일 멘션 — 파일 경로를 직접 입력하는 대신 @파일 형식으로 멘션하면 Read 호출 자체가 사라진다.
- /rewind — 대화 방향이 틀어졌을 때 /compact 대신 /rewind를 쓴다. 뒤쪽 턴만 잘라내고 그 이전은 캐시가 유지되기 때문에 비용이 들지 않는다.
- 모델·이포트는 세션 시작 시 고정 — /model이나 /effort를 대화 중간에 바꾸면 캐시가 깨져서 전체 대화를 다시 읽는다. 더 비싸진다.
- /usage — 스킬, 서브에이전트, 플러그인, MCP별 소비 비율을 퍼센트로 확인할 수 있다.
주장 자체는 그럴듯하다. 문제는 그게 실제 공식 문서와 맞는 얘기냐는 거다. 클로드 코드 토큰 절약을 다룬 콘텐츠가 워낙 많다 보니, 근거 없이 떠도는 얘기인지부터 걸러야 했다.
위는 릴스 화면에서 5가지 습관이 소개되는 장면이다. 각 항목 뒤에 출처 화면을 직접 띄워놓고 넘어간다는 게 처음부터 눈에 들어왔다.
공식 문서와 직접 대조한 검증 방법
이번엔 GitHub 저장소가 없다. 설치할 것도 없다. 릴스가 소개한 게 클로드 코드에 내장된 기능이라서, 검증 방향 자체를 바꿨다.
릴스가 화면에 직접 캡처해서 보여준 출처가 두 곳이다. 앤트로픽 공식 블로그(claude.com/blog/maximizing-the-value-of-your-claude-code-sessions)와 공식 문서(code.claude.com/docs/en/costs)다. 이 두 URL을 WebFetch로 직접 열었다. 그리고 릴스 자막·화면 텍스트와 원문을 한 줄씩 비교했다. 클로드 코드 토큰 절약을 진지하게 고민한다면 이 두 문서를 북마크해두는 게 릴스 하나 보는 것보다 낫다.
검증 기준은 단순하다. 릴스가 주장한 내용이 원문에 실제로 존재하는가. 문장 수준에서 일치하는가. 그게 전부다.
위는 WebFetch로 앤트로픽 공식 블로그·문서 원문을 직접 열어서 확인하는 장면이다.
화면 캡처와 실제 원문이 일치했을까
일치했다. 5가지 전부.
하나씩 확인한 결과를 그대로 적는다.
/rename before /clear — 릴스 자막은 “나중에 다시 찾을 거면 /clear 전에 /rename”이라고 했다. 공식 문서(code.claude.com/docs) 원문은 ‘rename before you /clear if you’ll want the session back later’다. 일치한다.
위는 공식 문서에서 /clear·/rename 관련 원문 문장이 확인되는 화면이다. 릴스 화면 캡처와 나란히 보면 문장이 그대로 옮겨졌다는 게 바로 보인다.
@파일 멘션 — “Read 호출 자체를 없앤다”는 주장의 원문은 ‘there’s no Read call for it’이다. 그대로다.
위는 앤트로픽 공식 블로그에서 @파일 멘션 관련 원문이 확인되는 화면이다.
/rewind — “뒤쪽만 잘라내고 비용이 안 든다”는 주장의 원문은 ‘Rewinding only cuts those turns off the end, so everything before them is still cached and it costs nothing’이다. 릴스가 요약한 방식과 원문이 정확히 같은 내용이다.
위는 /rewind 설명이 담긴 공식 블로그 원문 캡처다. “costs nothing”이라는 문구가 그대로 적혀 있다.
모델·이포트 중간 변경 금지 — 이건 가장 구체적인 주장이었다. “캐시가 깨져서 전체를 다시 읽어 더 비싸진다”는 내용의 원문은 ‘every model has its own cache, so on the next turn the entire conversation gets prefilled again at full price’다. 정확히 일치한다.
위는 /model·/effort 전환 시 캐시가 깨지는 이유를 설명한 공식 블로그 원문 캡처다.
/usage — 스킬·서브에이전트·플러그인·MCP별 퍼센트라는 주장은 공식 문서의 ‘Plan usage breakdown’ 섹션 문구와 그대로 일치했다.
위는 공식 문서 /usage 섹션 원문이다. 릴스가 언급한 항목 구분이 그대로 적혀 있다.
릴스가 주장만 하고 넘어가는 게 아니라, 각 항목 뒤에 출처 스크린샷을 화면에 직접 띄운다는 것도 확인됐다. 그 출처를 직접 열어보니 화면에 나온 문장과 실제 원문이 토씨까지 일치했다. 이건 좀 인상적이었다.
확인하지 못한 부분들
없다고 하면 거짓말이다. 두 가지는 확인하지 못했다.
첫째, 이번 검증은 공식 문서 기준 시점에만 유효하다. /rename이라는 명령어 이름 자체나 /usage의 세부 UI는 클로드 코드 버전에 따라 바뀔 수 있다. 지금 이 글을 읽는 시점에 명령어가 그대로인지는 확인할 수 없다. 직접 확인해야 한다.
둘째, 정량적 효과는 확인 못 했다. 이 5가지 습관을 지켰을 때 실제로 한도를 얼마나 절약하는지, 개인차는 없는지 — 이번 검증 범위 밖이다. “효과가 있다”는 건 확인됐지만 “얼마나”는 모른다.
왜 이번엔 ‘진짜’라고 판정했는가
이 블로그에서 다룬 릴스 대부분은 주장과 실제가 어긋났다. 핵심 프레이밍이 틀렸거나, 출처라고 보여준 화면이 원문과 달랐거나. 이번은 반대였다.
주장, 릴스가 화면에 직접 띄운 출처 스크린샷, 그리고 그 출처의 실제 원문. 세 갈래가 전부 일치했다. 과장하거나 왜곡한 지점을 찾지 못했다. 그래서 판정은 진짜다.
클로드 코드 토큰 절약이 목적이라면 이 다섯 가지만 지켜도 체감 차이가 크다. 쓸 만하냐고 묻는다면 — 쓸 만하다. 단, 버전 업데이트로 명령어 이름이 바뀔 수 있으니 공식 문서를 한 번 직접 확인하고 쓰기 시작해라. 릴스를 믿어도 되지만 문서 북마크는 따로 해두는 게 낫다.
클로드 코드 관련 다른 검증이 궁금하다면 클로드 코드 MCP 저장소 7개를 GitHub API로 검증한 글도 같이 보면 좋다. 이번처럼 한도 절약 팁 하나가 공식 문서와 정확히 맞아떨어지는 경우는 드물다는 걸 그 글에서도 확인할 수 있다.