클로드 코드 한도 꿀팁, read-once 켜는 법과 되돌리는 법

3. 진짜로 막게 켜기

그런데 깔기만 해서는 다시 읽기가 막히지 않아요. 처음 설정은 warn이에요. warn은 다시 읽기를 그대로 두고 “이미 읽은 파일이에요”라는 안내 글만 붙여요. 그러면 토큰은 그대로 나가요. 진짜로 막으려면 deny로 바꿔야 해요.

아래 한 줄을 통째로 복사해 터미널에 붙여 넣고 엔터를 누르세요. 설정 파일에 "env": {"READ_ONCE_MODE": "deny"} 한 줄을 넣어 줘요.

jq '.env.READ_ONCE_MODE = "deny"' ~/.claude/settings.json > ~/.claude/settings.json.tmp && mv ~/.claude/settings.json.tmp ~/.claude/settings.json

env는 클로드 코드가 대화를 열 때마다 읽는 설정 값이에요. 클로드 코드 공식 문서도 이 자리에 값을 넣으라고 안내해요.

그다음 클로드 코드를 새로 열어요. 이미 열려 있었다면 닫고 다시 claude를 치세요. 새 대화부터 켜져요.

4. 확인: 정말 막히는지 보기

그다음엔 정말 막히는지 봐야 해요. 가장 확실한 확인은 클로드 코드 안에서 해 보는 거예요. 아무 파일이나 있는 폴더에서 클로드 코드를 열고 아래 문장을 붙여 넣으세요. 파일 이름은 그 폴더에 있는 것으로 바꿔 써요.

notes.py를 Read 도구로 처음부터 끝까지 읽어 줘. 그다음 한 번 더 Read 도구로 notes.py 전체를 다시 읽어 줘(grep 쓰지 마). 두 번째 읽기에서 무슨 일이 있었는지 그대로 알려 줘.

두 번째 읽기에서 맨 위의 그림처럼 “already in context”라는 글이 뜨면 성공이에요.

터미널에서 점검 명령으로도 볼 수 있어요.

~/.claude/read-once/read-once verify

여기서 헷갈리기 쉬운 점이 두 가지 있어요. 맥에서는 끝 줄이 “All checks passed”가 아니라 “12/13 checks passed. read-once is ready.”로 나올 수 있어요. 맥에 기본으로 든 bash가 옛 버전이라 경고가 하나 붙는 거예요. 그래도 동작은 해요. 또 3단계처럼 설정 파일에 deny를 넣으면 이 점검에는 “Mode: warn”으로 보여요. 점검 명령은 설정 파일의 env를 읽지 않기 때문이에요. 그러니 켜졌는지는 클로드 코드 안의 막힘 글로 판단하세요.

켜 두면 이렇게 움직여요

• 파일을 고친 뒤에는 다시 읽기가 막히지 않아요. 바뀐 파일은 늘 통과해요.
• 20분이 지나면 같은 파일도 다시 읽을 수 있어요. 대화가 길어져 클로드 코드가 앞 내용을 줄일 때를 대비한 거예요. 이 시간은 READ_ONCE_TTL 값으로 바꿀 수 있어요. 값은 초 단위이고 처음엔 1200이에요.
• 파일의 일부만 읽는 건 막지 않아요. 파일 전체를 또 읽을 때만 막아요.
• 새 대화에서 처음 읽는 건 막지 않아요. 그래서 deny에서 “File has not been read yet”가 떠도 정상이에요. 한 번 읽고 나면 고칠 수 있어요.
• 고른 사람만 쓰는 선택지도 하나 있어요. READ_ONCE_DIFF를 1로 켜면 고친 파일을 다시 읽을 때 바뀐 줄만 보여 줘요.

한도가 정확히 얼마나 늘어나는지는 확인된 숫자가 없어요. 공식 안내가 말하는 건 다시 읽기를 한 번 막을 때 토큰 2천 개 넘게 아낀다는 것까지예요. 내 대화에서 얼마나 아꼈는지는 대화가 끝난 뒤 아래 줄로 볼 수 있어요.

~/.claude/read-once/read-once stats

5. 되돌리기

그런데 마음이 바뀔 수도 있어요. 그럴 때 쓰는 길이 세 가지예요. 필요한 만큼만 고르세요.

막기만 끄기, warn으로 돌아가기

도구는 남겨 두고 처음 설정인 warn으로 돌아가요.

jq 'del(.env.READ_ONCE_MODE)' ~/.claude/settings.json > ~/.claude/settings.json.tmp && mv ~/.claude/settings.json.tmp ~/.claude/settings.json

잠깐 끄기

도구를 통째로 쉬게 해요. 다시 켤 때는 아래 “다시 켜기” 줄을 붙여 넣어요.

jq '.env.READ_ONCE_DISABLED = "1"' ~/.claude/settings.json > ~/.claude/settings.json.tmp && mv ~/.claude/settings.json.tmp ~/.claude/settings.json

다시 켜기:

jq 'del(.env.READ_ONCE_DISABLED)' ~/.claude/settings.json > ~/.claude/settings.json.tmp && mv ~/.claude/settings.json.tmp ~/.claude/settings.json

두 경우 모두 클로드 코드를 새로 열어야 바뀐 설정이 들어가요.

완전히 지우기

먼저 도구의 지우기 명령을 붙여 넣어요.

~/.claude/read-once/read-once uninstall

“read-once hook removed from settings.”가 보이면 첫 훅이 빠진 거예요. 그런데 이 명령은 다 지우지 않아요. 세 가지가 남아요. 설정 파일 속 두 번째 훅인 PostCompact와 3단계에서 넣은 env 줄, 그리고 ~/.claude/read-once/ 폴더예요. 아래 한 줄이 남은 훅과 env 줄을 지워 줘요.

jq 'del(.hooks.PostCompact[]? | select(any(.hooks[]?; .command | test("read-once")))) | del(.env.READ_ONCE_MODE, .env.READ_ONCE_DISABLED)' ~/.claude/settings.json > ~/.claude/settings.json.tmp && mv ~/.claude/settings.json.tmp ~/.claude/settings.json

마지막으로 폴더를 지워요.

rm -rf ~/.claude/read-once

이제 클로드 코드는 read-once를 깔기 전과 같아요. 새로 열면 그대로 써요.

막히면

• 설치가 실패해요: jq가 없을 때가 많아요. 1단계로 돌아가 jq부터 깔아요.
• 막힘 글이 안 떠요: 3단계 뒤 클로드 코드를 새로 열었는지 봐요. 열려 있던 대화에는 안 들어가요.
• 윈도에서 안 돼요: PowerShell 7 이상인지 봐요. 5.1이면 안 돼요.

더 자세한 동작 순서와 호환성은 read-once 공식 안내에 있어요.