핵심 요약

• 클로드 유료 플랜의 한도는 5시간 세션 한도 + 주간 한도 두 겹이다. claude.ai 웹·데스크톱·Claude Code가 같은 풀을 공유하므로, 웹에서 대화를 많이 하면 그날 코딩 가용량이 줄어든다.
• Pro는 월 $20(연간 결제 시 월 $17 환산, $200 선불). Max 5x는 월 $100(Pro의 5배), Max 20x는 월 $200(Pro의 20배)다. 2026년 10월 21일 기준 1,326원/USD 환산 시 Pro 월 약 26,520원, Max 5x 약 132,600원, Max 20x 약 265,200원이다(부가세 전).
• Anthropic은 메시지 개수·시간으로 환산한 고정 한도표를 공개하지 않는다. 한도 소진 속도는 모델 선택(Opus/Sonnet/Haiku), 노력(effort) 수준, 대화 길이, 첨부 파일, 웹 검색·Research 같은 도구 사용에 따라 달라진다. “Pro면 몇 시간”이라는 단일 숫자는 존재하지 않는다.
• 한도에 걸려도 끝나지 않는다. 사용량 크레딧(종량제, API 표준 요율)으로 자동 전환되고, 월 지출 상한을 걸어 둘 수 있다. 번들 선구매 시 최대 30% 할인된다. 가끔 지급되는 무료 리셋으로 세션·주간 한도를 즉시 만충할 수도 있다.
• Max 플랜은 월 API 크레딧 $100~$200이 별도로 붙지만 Claude Code·앱 추가 사용량에는 쓸 수 없고 Console(API) 전용이다.

결론부터: 3만원 예산이면 무엇을 결정해야 하나

월 3만원 내외 예산이라면 선택지는 세 가지다. 첫째, Pro 연간 결제(월 $17 환산, 연 $200 선불)로 최소 단가를 만든다. 둘째, Pro 월간($20)으로 먼저 2~4주 실측한 뒤 한도 소진 패턴을 보고 Max로 올릴지 결정한다. 셋째, 아예 종량제 API만 쓴다 — 이 손익분기 계산은 코딩 AI 구독, API로 바꾸면 진짜 쌀까?에서 다뤘다.

판정 기준은 간단하다. 하루 5시간 세션 창 안에서 Claude Code를 상시 띄워놓고 작업한다면 Pro는 부족하다. 세션 한도가 코딩 워크플로 기준 수 시간 만에 소진되고, 주간 한도가 상한으로 작동한다. 반면 하루 몇 번의 코드 리뷰·함수 단위 수정용이라면 Pro로 충분하고, 남는 예산은 다른 도구에 배분하는 게 낫다.

한도 구조: 세션 한도와 주간 한도

공식 문서 기준 유료 플랜의 한도 체계는 다음과 같다.

주간 한도 리셋 시점은 계정마다 고정되어 있고 내가 구독을 시작한 날짜와 무관하게 매주 같은 요일·시간에 만충된다. 다음 리셋 시각은 설정 > 사용량(Settings > Usage)에서 확인할 수 있다.

한도 소진에 영향을 주는 요인은 공식 문서에 명시되어 있다.

• 모델 선택: Opus 계열이 같은 대화에서도 한도를 훨씬 빨리 소진한다. Haiku·Sonnet이 저렴하다.
• 노력(effort) 수준: 높일수록 소진이 빠르다.
• 대화 길이: 긴 세션은 맥락가 커져 토큰 소모가 급증한다. 자동 컨텍스트 관리가 작동하는 긴 대화는 한도를 더 빨리 쓴다.
• 도구 사용: 웹 검색, Research, 코드 실행, 파일 생성은 토큰을 추가 소모한다.

Claude Code에서 세션 중간에 한도에 도달하면 “Usage limit reached · wrapping up” 메시지와 함께 진행 중이던 응답만 마무리하고 정지한다. 이 랩업 허용은 Pro는 주간 주기당 1회, Max는 세션 한도 도달 시마다(주간 한도 내에서) 적용된다.

플랜별 실사용량 감 잡기

Anthropic은 “Pro = 몇 시간” 같은 고정 환산표를 제공하지 않는다. 대신 확인 가능한 사실로 예산 계산을 할 수 있다.

Pro(월 $20): 세션 한도 소진까지 Sonnet 기준 짧은 코딩 작업 몇 시간, Opus를 섞으면 그보다 훨씬 짧아진다. 커뮤니티 반응은 하루 종일 Claude Code를 쓰는 사용자는 하루 1~2세션에서 세션 한도에 걸린다는 보고가 많다. 다만 이는 작업 크기에 따라 편차가 크므로, 자기 워크로드로 2주 실측하는 것이 가장 정확하다. 실측 방법은 다음 절차다.

1. Pro 월간으로 구독한다(연간 전환은 실측 후).
2. Claude Code에서 /usage로 세션·주간 소진률을 수시로 확인한다.
3. 5시간 세션 창 안에 몇 개 태스크(기능 1개, 코드 리뷰 1회 등 자기 단위로)가 들어가는지 기록한다.
4. 주간 한도에 며칠째 걸리는지 확인한다. 주중 2회 이상 주간 한도에 걸리면 Max 5x 후보다.

Max 5x(월 $100): Pro 대비 세션당 사용량이 5배다. Claude Code를 주업무 도구로 쓰는 개발자의 표준 선택지다. Fable 모델이 플랜에 포함되고(주간 한도의 50%까지), 월 $100의 API 크레딧이 별도로 붙는다.

Max 20x(월 $200): Pro의 20배. 대형 리포지토리 장기 작업·에이전트 위임(Cowork)을 상시 쓰는 경우. 같은 API 크레딧이 $200로 늘어난다.

한도에 걸렸을 때 대응 4가지

1. 무료 리셋 확인

가끔 계정에 리셋이 지급된다. 설정 > 사용량에서 “Reset for free” 버튼으로 세션 또는 주간 한도를 즉시 만충할 수 있다. 지급 여부는 계정마다 다르고 만료 시각이 있으며, 웹·데스크톱에서만 실행되고 모바일·Claude Code 창에서는 버튼이 없다. 리셋하면 전체 계정 기준으로 초기화되므로 Claude Code에도 적용된다.

2. 사용량 크레딧(종량제) 활성화

설정 > 사용량에서 사용량 크레딧을 켜면 한도 도달 시 자동으로 종량제로 전환되어 작업이 끊기지 않는다. 과금은 API 표준 요율을 따른다(위 차트 참조). 월 지출 상한(spend limit)을 반드시 설정하고, 알림을 켜둔다. 종량제 요율은 Sonnet 5.5가 입력 100만 토큰 $2·출력 $10이므로, 장시간 대량 코딩은 Pro 구독료를 순식간에 넘을 수 있다는 점을 인지해야 한다.

3. 사용량 번들로 10~30% 할인

크레딧을 선구매하면 할인이 붙는다. $50번들 10%($45), $250번들 20%($200), $1,000번들 30%($700). Pro·Max 개인 구독자는 월 $2,000어치까지 살 수 있다. 잦은 종량제 전환이 예상되면 번들이 단가를 낮춘다.

4. 플랜 조정

Pro에서 세션 한도가 지속적으로 부족하면 Max 5x로 올린다. 업그레이드는 일할 계산되고 API 크레딧도 일할 지급된다. 반대로 Max에서 Fable 별도 한도만 소진된다면 모델을 바꿔 일반 주간 한도 내로 돌아가는 것도 방법이다.

3만원·30만원 예산 시나리오 계산

검증된 요율로 예산 시나리오를 계산해본다. 환율은 2026년 10월 21일 실측 1,326원/USD, 부가세 미포함다.

계산 포인트 하나: Max의 API 크레딧($100~$200)은 Console에서만 쓸 수 있고 Claude Code 추가 사용량에는 적용되지 않는다. “Max 5x면 사실상 월 20만원어치다”라는 계산은 Claude Code 사용자 기준으로 성립하지 않는다. API를 직접 다루는 개발자에게만 유효한 혜택이다.

절약 실무 팁

• 모델 계층화: 탐색·리팩터링은 Haiku·Sonnet, 최종 설계·어려운 디버깅만 상위 모델로. 이것만으로 세션당 태스크 수가 몇 배로 벌어진다.
• 새 대화 시작: 긴 대화는 컨텍스트가 누적되어 토큰 소모가 급증한다. 주제가 바뀌면 새 세션을 연다. Claude Code에서도 불필요하게 긴 세션을 이어가지 않는다.
• CLAUDE.md/AGENTS.md로 컨텍스트 최소화: 프로젝트 안내를 한 곳에 정리해 반복 설명을 없앤다. 통합 작성법은 CLAUDE.md와 AGENTS.md, 이제 하나로 쓴다를 참고한다.
• 컴팩션 활용: 긴 세션은 컴팩션으로 원문 맥락을 보존하면서 토큰을 아낀다. fast-jev-compaction 검증 글에서 실측을 다뤘다.
• 5시간 창 배치: 세션 한도는 5시간마다 만충된다. 집중 작업을 세션 창에 맞춰 배치하면 하루 2~3회의 풀 가용량을 쓸 수 있다.

FAQ

클로드 Pro 한도는 정확히 몇 시간인가요?

Anthropic은 시간·메시지 환산표를 공개하지 않는다. 한도는 모델·노력 수준·대화 길이·도구 사용에 따라 달라지는 가변값이다. 자신의 워크로드로 실측하는 것이 유일하게 정확한 방법이고, 방법은 본문 “플랜별 실사용량 감 잡기” 절차를 따르면 된다.

주간 한도는 언제 초기화되나요?

계정마다 고정된 요일·시각이 지정되어 있고, 구독 시작일과 무관하게 매주 같은 시점에 만충된다. 설정 > 사용량에서 다음 리셋 시각을 확인할 수 있다.

한도에 걸렸는데 작업을 끝내야 할 때는요?

사용량 크레딧을 활성화해 두면 종량제로 자동 전환된다. 급하면 모델을 Haiku·Sonnet으로 낮춰 세션을 이어가거나, 리셋이 지급되어 있으면 만충한다. 랩업 허용으로 진행 중 응답은 마무리된다.

Max의 API 크레딧을 Claude Code에 쓸 수 있나요?

아니다. 월 API 크레딧($100/$200)은 Console의 API·에이전트 SDK용이고, Claude Code·앱의 추가 사용량에는 적용되지 않는다. 크레딧은 이월되지 않고 매 결제 주기 갱신된다.

연간 결제가 항상 이득인가요?

월 환산 15% 저렴하지만 $200 선불과 이벤트성 환불 제약이 있다. 한도 패턴을 모르는 첫 구독은 월간으로 실측하고, 유지가 확정되면 전환하는 순서를 권한다.

참고자료

• Anthropic 요금 안내 — https://www.anthropic.com/pricing
• 사용량·길이 제한 작동 방식 — https://support.claude.com/en/articles/11647753
• Pro 플랜 안내 — https://support.claude.com/en/articles/8325606
• Max 플랜 안내 — https://support.claude.com/en/articles/11049741
• 사용량 크레딧 관리 — https://support.claude.com/en/articles/12429409
• 사용량 번들 — https://support.claude.com/en/articles/14246112
• 무료 리셋 — https://support.claude.com/en/articles/17007452
• Max·Team API 크레딧 — https://support.claude.com/en/articles/17154008
• Claude Code와 Pro·Max 플랜 — https://support.claude.com/en/articles/11145838
• API 요금표 — https://platform.claude.com/docs/en/about-claude/pricing

The post 클로드 3만원·Max 실사용 한도 — 세션·주간 한도에서 코딩 에이전트 몇 시간 쓸 수 있나 appeared first on .

핵심 요약 — 30초 결론

• 챗봇·요약 맛보기: 중고 M4 16GB(80~95만 원대). 9~12B급 Q4 모델(6.6~7.7GB)이면 충분하다. 8GB 구형이 아니라 16GB부터 산다.
• 코딩 보조(30B급): 중고 M4 32GB(160~215만 원대). 신형 M6 32GB(251.9만 원) 대비 40~90만 원 절약. 단 대역폭은 120GB/s로 신형 170GB/s보다 느리다.
• 35B급·대역폭 중시: 중고 M4 Pro 24GB(185~250만 원대, 273GB/s) 또는 신형 M5 Pro 24GB(299만 원, 307GB/s). 중고 M4 Pro 48GB(280만 원대~)는 매물이 희소해 검색 비용이 크다.
• 70B급 Q4: 43GB 가중치에 KV 캐시까지 감안하면 64GB 필요. 중고 시장에서 사실상 M4 Pro 64GB(400만 원대, 극희소)만 가능하므로 신형 M5 Pro 64GB(469만 원)와 비교한다.
• 판정 보류: M4 단종 후 중고가가 출시가(89만 원)의 90~107%에 붙어 있다. 할인 심리로 급매(56~75만 원)만 노리는 전략이 유효하다.

왜 지금 중고 판정이 필요한가

2026년 8월 25일 신형 맥미니(M6·M5 Pro) 발표로 M4·M4 Pro는 Apple Store에서 판매가 종료됐다. 이후 중고 시장으로 물량이 넘어왔고, 검색어 “맥미니 m4 중고가”, “맥미니 m4 32gb 중고”는 자동완성에 상시 노출될 만큼 수요가 있다. 커뮤니티에도 “M4 깡통 시세가 궁금해요”류의 질문이 반복된다.

문제는 기존 정보가 갈라져 있다는 것이다. 개인 사용기는 “24GB로 구축했다가 좌절했다”는 사례와 “32GB로 만족한다”는 사례가 뒤섞여 있고, 시세 정리글은 로컬 LLM 관점의 구성별 판정 없이 가격표만 나열한다. 이 글은 (1) 당일 중고 매물가, (2) Apple 공식 신형가, (3) Ollama 공식 모델 크기, (4) 칩별 공식 메모리 대역폭 네 가지를 같은 표에 놓고 구매 판정을 내린다.

중고가 vs 신형 공식가 — 같은 표로 보기

먼저 숫자다. 중고가는 2026년 10월 18일 중고나라·당근 검색 매물 기준이며 극단적 이상치(사기 의심 매물, 도킹스테이션 등 액세서리)는 제외했다. 신형가는 Apple KR 스토어 당일 표시가다.

주의할 점은 두 가지다. 첫째, 중고 M4 16GB 시세(80~95만)는 단종 전 출시가(89만 원)와 거의 차이가 없다. 미개봉 매물이 99~140만 원에 붙는 것도 같은 이유다. 애플 제품은 가격 방어가 강하지만, “신품 대비 반값”을 기대하면 안 된다. 둘째, 중고나라 검색의 “평균 가격”은 액세서리·구매글까지 섞여 실제 시세와 크게 다르므로 판단에 쓰지 않는다. 개별 매물 가격대를 직접 봐야 한다.

*출처: 중고나라·당근 매물, Apple KR 스토어 실측 (2026-10-18)*

로컬 LLM 관점에서 중고 M4의 한계와 강점

대역폭이 속도를 정한다

맥미니에서 로컬 LLM 토큰 생성 속도는 메모리 대역폭에 비례하는 경향이 크다. Apple 공식 수치는 다음과 같다.

같은 32GB라도 중고 M4(120GB/s)와 신형 M6 32GB(170GB/s)는 토큰 생성 속도에서 체감 차이가 난다. 여기에 Apple 발표 기준 M6는 M4 대비 AI 성능 최대 4배다. “메모리만 같으면 똑같다”는 중고 구매 논리는 속도에서는 성립하지 않는다. 반대로 말하면, 속도에 민감하지 않은 배치·요약·야간 학습 추론이라면 이 차이는 돈으로 환산할 이유가 된다.

구성별로 돌릴 수 있는 모델

Ollama 공식 라이브러리의 당일 기준 다운로드 크기다. 실행 시 컨텍스트(KV 캐시)가 추가되며, 통합 메모리는 약 70%만 모델에 쓸 수 있다고 계산하는 것이 실패가 적다.

16GB는 입문용, 32GB는 30B급 코딩 보조의 현실선, 24GB는 대역폭 우선 트레이드오프, 48GB 이상이 35B급 안정권이다. 이 계산법의 배경은 로컬 LLM 메모리 계산법 글에서, 양자화 단계 선택은 VRAM별 양자화 가이드에서 다룬다.

구성별 구매 판정

판정 1: 중고 M4 16GB — 입문이면 산다, 단 80만 원 이상은 신중히

9~12B급 Q4 모델로 챗봇·요약·RAG 실험을 하는 것이 목표면 중고 M4 16GB(80~95만 원대)는 여전히 유효하다. 신형 M6 16GB(183.9만 원)와의 차액이 90만 원 이상이기 때문이다. 단, 급매가 아닌 정가급 매물(90만 원+)은 절반쯤 미래 가치(대역폭·AI 성능)를 포기하는 거래다. OpenClaw 같은 클라우드 API 중계 서버용이라면 이 판정이 가장 강하게 성립한다.

판정 2: 중고 M4 32GB — 코딩 보조용 최적 가성비

qwen3-coder:30b(19GB)급을 긴 컨텍스트 없이 돌리는 용도라면 중고 M4 32GB(160~215만 원대)가 현재 시장에서 가장 좋은 가성비다. 신형 M6 32GB(251.9만 원) 대비 40~90만 원을 아끼면서 같은 메모리 용량을 확보한다. 다만 120GB/s 대역폭의 한계로 토큰 속도는 신형보다 느리고, 35B급(23~24GB)은 가중치만 빠듯해 장문 컨텍스트에서 스왑 위험이 있다. “32GB면 30B까지만”이라는 자기 규칙을 정하고 사는 구성이다.

판정 3: 중고 M4 Pro 24GB — 대역폭 트레이드오프, 매물 확인이 핵심

같은 24GB라도 M4 Pro는 273GB/s로 신형 M6(170GB/s)보다 빠르다. gemma4:26b(16GB)·gpt-oss:20b(14GB)를 속도 있게 돌리는 조합이면 이 매물이 역설적으로 최선이 될 수 있다. 주의: 중고 시장에 12코어 CPU/16코어 GPU 저사양 M4 Pro가 135만 원대에 섞여 있다. 14코어 CPU/20코어 GPU 풀칩인지 반드시 확인해야 한다(매물 제목에 “14코어” 명시 여부로 1차 필터링). 가격대는 풀칩 기준 185~250만 원.

판정 4: 중고 M4 Pro 48GB·64GB — 이론상 최강, 현실은 매물 부재

48GB(35B급 안정권)·64GB(70B Q4 가능) 중고 매물은 존재하지만 희소하고, 발견해도 280만(48GB)~400만 원대(64GB)다. 신형 M5 Pro 48GB(401만 원)·64GB(469만 원)와 차이가 크지 않아 “기다림의 가치”가 낮다. 이 구간부터는 신형 보증·반품·307GB/s 대역폭을 사는 쪽이 합리적이다.

시세가 더 떨어질 가능성은

M4 중고가가 출시가에 붙어 있는 현상은 단종 직후 공급 증가로 몇 달 내지는 완화될 수 있다. 다만 애플 제품의 가격 방어 관성과 로컬 LLM·홈서버 수요가 아직 확장 중이라는 점에서 급락을 기대하기는 어렵다. 전략은 단순하다: 목표 구성의 하한가(예: M4 32GB 160만 원)를 정해 두고 급매만 노린다. 매물은 흐르지만 가격은 잘 안 내려간다.

중고 맥미니 확인 체크리스트

데스크톱이라 배터리 걱정은 없지만, 확인할 항목은 명확하다.

저장 장치는 자주 간과되는 항목이다. 256GB 모델은 llama3.1:70b(43GB)처럼 큰 모델 하나에 실험 분량이면 금방 찬다. 모델 두 개 이상을 상시 테스트할 계획이라면 512GB 이상 매물을 우선한다.

자주 묻는 질문

중고 M4 16GB로 로컬 LLM은 어디까지 현실적인가?

9~12B급 Q4 양자화 모델(6.6~7.7GB)까지 여유 있게 돌아간다. 14B(9.3GB)는 짧은 컨텍스트에서 가능하지만, 에이전트·코딩처럼 컨텍스트를 많이 쓰는 작업은 스왑 위험이 있다. 20B(14GB)부터는 16GB 구성으로는 실행 자체가 어렵다.

중고 M4 32GB와 신형 M6 32GB는 어떻게 고르나?

순수하게 예산이면 중고다(40~90만 원 차이). 토큰 생성 속도·장문 컨텍스트 처리가 중요하거나 기기 수명을 길게 보면 신형 M6(170GB/s, AI 성능 최대 4배)다. 요약하자면, “돌리는 모델의 크기”가 우선이면 중고 32GB, “돌리는 속도”가 우선이면 신형이다.

중고 맥미니 살 때 가장 위험한 건 뭔가?

활성화 잠금과 저사양 M4 Pro 착각이다. 잠금이 걸린 기기는 사실상 벽돌이고, M4 Pro의 12코어 CPU 구성은 같은 “M4 Pro”라도 성능·대역폭 활용에서 14코어 풀칩과 다르다. 거래 전 설정 화면 사진을 요청해 두 항목을 확인한다.

M4 Pro 24GB 중고는 로컬 LLM용으로 어떤가?

273GB/s 대역폭 덕에 20B급(14GB)·26B급(16GB)을 속도 있게 돌리는 특수 목적에 좋다. 다만 24GB는 30B급(19GB)이 한계선이라, 코딩 보조가 주목적이면 M4 32GB가 낫다. 대역폭과 용량 중 무엇을 고를지는 돌릴 모델의 크기로 정한다.

중고가는 앞으로 더 떨어질까?

단종 후 공급은 늘고 있지만 애플 기기의 가격 방어와 로컬 LLM 수요가 받쳐 준다. 급락보다는 완만한 하락을 가정하고, 목표가(구성별 하한)를 정해 급매만 노리는 전략이 실속 있다. 이 글의 시세는 2026-10-18 기준이므로 실제 거래 전 최신 매물을 다시 확인한다.

결론 — 목적별 한 줄 판정

로컬 LLM을 처음 시작한다면 중고 M4 16GB 80만 원대, 30B급 코딩 보조까지 쓴다면 중고 M4 32GB 160만 원대, 속도까지 챙긴다면 중고 M4 Pro 24GB 풀칩 185만 원대 또는 신형 M5 Pro, 35B급 이상은 신형 M5 Pro 48GB 이상이다. 중고의 승부처는 가격표가 아니라 급매 타이밍과 매물 검증이다. 메모리 구성별 모델 선택의 자세한 기준은 맥미니 로컬 LLM 가이드에서, 단종 전 맥미니 구매 전반의 맥락은 맥미니 대란 글에서 이어 볼 수 있다.

참고자료

• Apple KR — Mac mini 구입하기(공식 가격)
• Apple KR — Mac mini 제품 사양(메모리 대역폭 공식 수치)
• Apple 지원 — Mac mini(2024년) 기술 사양(M4·M4 Pro 공식 스펙)
• 중고나라 — 맥미니 m4 검색 매물(중고가 실측 기준)
• 당근 — 맥미니 m4 검색 매물(중고가 실측 기준)
• Ollama — qwen3-coder 태그별 모델 크기
• Ollama — qwen3.6 태그별 모델 크기
• 나무위키 — Mac mini(2026년) 가격 구성표(CTO 옵션 단가 참고))
• Reddit r/LocalLLaMA — M4 32GB vs M4 Pro 24GB 논의(수요 참고)

The post 맥미니 중고 지금 사도 될까? — 단종 M4 로컬 LLM 구성별 구매 판정 (2026년 10월) appeared first on .

왜 지금 “램보다 큰 모델”이 이슈인가

로컬 LLM 사용자에게 램은 곧 “돌릴 수 있는 모델의 크기”다. 양자화로 모델을 줄여도 70B급 모델은 Q4 양자화로 40GB 안팎이라 32GB 시스템에 올리기 어렵다. 그동안의 해법은 램 증설(64GB→128GB)이었는데, AI 서버 수요로 DDR5 가격이 급등하면서 이 경로의 비용이 무너졌다.

동시에 모델 구조가 바뀌었다. Qwen3-Next·DeepSeek 계열처럼 총 파라미터는 크지만 토큰마다 활성 파라미터가 작은 MoE(Mixture of Experts) 모델이 늘었다. MoE는 토큰 생성 시 전체 전문가 중 일부만 필요하므로, 필요한 전문가만 NVMe SSD에서 읽고 자주 쓰이는 전문가는 램에 캐시하는 방식이 가능해졌다. NVMe 읽기 5GB/s대면 초당 수십 토큰 생성이 현실적으로 나온다.

이 그래프가 말하는 것은 단순하다. 2025년 12월 40.7만 원이던 DDR5 32GB가 2026년 1~2월 급등해 10월 현재 79만 원이다. “모델이 못 돌아가서 램을 산다”는 결정이 1년 전보다 두 배 비싸졌다는 뜻이다.

후보 3종: 무엇이 다른가

세 도구는 같은 문제(RAM보다 큰 모델)를 다르게 푼다.

판정: 누가 무엇을 해야 하나

32GB 램 노트북/PC 사용자, 당장 대형 모델 로컬 구동이 급하다면 — janas를 실험해 볼 가치가 있다. 그래픽카드 없이 CPU+iGPU로 돌아가고, 설치는 릴리스 바이너리를 받아 압축 해제 후 janas-chat을 실행하는 것으로 끝난다. 단 지원 모델이 Qwen 계열로 좁고, 한 대의 노트북에서 측정된 수치라 내 환경에서 재측정(janas-bench)이 필수다. 최소 16GB 램, 32GB 이상 권장이며 모델은 NVMe에 둬야 한다.

게이밍 PC(VRAM 12GB+) 보유자, 최신 초대형 모델을 쓰고 싶다면 — Strata가 설치 편의성에서 앞선다. Qwen3.8-Flash-Next(125B)를 원클릭 설치로 구동하며, RTX 5070에서 초당 60~94 토큰을 낸다(공식 측정). 단 모델이 하나로 고정되고, 램 부족 시 멈춤 현상(“engine stopped unexpectedly”)이 공식 문서에 명시돼 있으니 다른 프로그램을 닫아야 한다.

맥 사용자, 96GB 이상 통합 메모리라면 — ds4(DwarfStar)가 정석이다. DeepSeek V4 Flash와 GLM 5.x를 Metal로 최적화해 구동하며, 램이 부족한 맥에서도 SSD 스트리밍을 지원한다. 32GB 맥은 타깃이 아니므로 기대하지 않는다.

아무것도 설치하기 싫고 생산성이 우선이라면 — 구독 유지가 여전히 최저비용·최고품질이다. Claude Pro 월 $20(약 2.7만 원)이면 12개월 32만 원으로, 램 키트 증설보다 싸고 최신 모델을 즉시 쓸 수 있다. 로컬 실험은 취미·학습 목적이라면 몰라도 업무 대체 수단으로 삼기엔 세 도구 모두 이르다.

램 증설이 합리적인 경우는 — DDR5 가격이 정점을 지나 하락 국면으로 확인될 때다. 지금은 그 timing이 아니다. 램 값 추이를 계속 보고 있다면 램 그래프 보는 곳 4곳 글의 방법으로 다나와 주간 최저가를 추적하면 된다.

실패 조건 체크리스트

시도 전에 아래를 확인한다. 하나라도 걸리면 해당 도구는 아직 내 것이 아니다.

• CPU가 x86-64이고 AVX2 이상을 지원하는가 (인텔 2013년 이후, AMD 2015년 이후 — janas 기준)
• 모델 파일이 NVMe SSD에 있는가 (SATA SSD·HDD는 토큰마다 지연이 늘어난다)
• 여유 램이 16GB 이상인가 (janas 최소 요구; 대형 모델은 32GB+)
• 그래픽카드 VRAM 12GB 이상인가 (Strata 요구 — janas는 불필요)
• 맥이라면 통합 메모리 96GB 이상인가 (ds4 기본 타깃)
• 백그라운드 프로그램을 닫을 준비가 됐는가 (전문가 캐시가 여유 램을 사용한다)
• 실험 단계 도구임을 받아들였는가 (API·명령행이 주 단위로 바뀐다 — janas README 명시)
• 자기 기기에서 janas-bench 등으로 재측정할 의지가 있는가 (공식 수치는 단일 기기 기준)

FAQ

램이 부족하면 SSD 스트리밍이 정답인가?

아니다. SSD 스트리밍은 “램 증설 비용을 피하는” 방법이지 램을 대체하는 만능 열쇠가 아니다. 초당 24~37 토큰은 채팅에는 충분하지만 긴 컨텍스트를 읽는 사전처리(prefill)와 에이전트 작업에는 부족하다는 지적이 HN 토론에서 나왔다. 또한 전문가 캐시 알고리즘이 모델·프롬프트 의존적이라 아직 풀린 문제가 아니라는 분석도 있다. 대량 문서 처리·에이전트 워크플로가 주 용도라면 여전히 램/VRAM이 충분해야 한다.

janas 공식 벤치마크를 그대로 믿어도 되나?

반은 믿고 반은 재측정해야 한다. 수치 자체는 측정 조건(기기, 날짜, 라운드 수)을 상세히 공개했고 llama.cpp 비교도 동일 파일·동일 기기에서 이뤄져 신뢰도가 높다. 단 한 대의 노트북(Core Ultra 9 185H, 32GB)에서 나온 값이므로 AMD CPU, 외장 그래픽카드, 느린 디스크 환경은 공식 문서 스스로 “시험된 적 없다”고 명시한다. 내 기기에서 janas-bench를 돌려 확인하는 것이 공식 권장 사용법이다.

Strata는 그래픽카드 없이도 되나?

안 된다. Strata는 NVIDIA RTX 20~50 시리즈 또는 AMD 지정 라데온(VRAM 12GB+)을 요구한다. 그래픽카드가 없거나 구형이라면 janas가 CPU+iGPU 구성을 지원하므로 이쪽이 맞다.

코딩 AI 구독을 끊고 로컬로 완전히 갈아탈 수 있나?

지금은 아니라고 본다. 로컬 MoE 스트리밍은 채팅·단문 생성에는 쓸만하지만 코딩 에이전트가 문서·코드를 대량으로 읽는 워크플로에서는 prefill 속도가 발목을 잡는다. 보안·프라이버시 이유로 코드가 외부로 나가면 안 되는 환경이라면 이야기가 달라지지만, 그 경우에도 안정성이 검증된 시점의 일이다. 당분간은 구독(메인) + 로컬(실험·민감 데이터) 병행이 현실적이다.

램 가격은 언제 떨어지나?

이 글의 범위를 벗어나지만, 기존에 쓴 DDR5 전망 글에서 다뤘다. 짧게만 요약하면 AI 서버 HBM/DDR5 수요가 공급을 계속 흡수하고 있어 단기 반등은 어렵다는 관측이 우세하다. 증설을 서두르지 말고 가격 추이를 보라는 것이 위 판정의 전제다.

함께 읽으면 좋은 글

• 로컬 LLM 양자화 뭘로 받을까? — VRAM별 Q4·Q8·IQ 선택 기준
• 로컬 LLM용 GPU 지금 사도 될까? — 5090·5070 Ti 가격 2배 급등 실측과 VRAM별 구매 판정
• 코딩 AI 구독, API로 바꾸면 진짜 쌀까? — 조합별 월 비용 손익분기 계산법
• 맥미니 로컬 LLM 메모리·모델 선택 가이드

참고 자료

• janas 공식 저장소(README·INSTALL) — 벤치마크 수치, 요구사항, 실험 단계 경고 (2026-10-15 확인)
• Strata 공식 저장소 — 요구사항, 속도 표 (2026-10-15 확인)
• ds4(DwarfStar) 공식 저장소 — 지원 하드웨어, SSD 스트리밍 조건 (2026-10-15 확인)
• Hacker News 토론: Janas — Run LLMs larger than RAM — prefill 한계·캐싱 난제 지적 (219표, 댓글 94건)
• Anthropic 요금 페이지 — Pro 월 $20(연간 결제 시 $17), Max $100~$200 (2026-10-15 확인)
• 다나와 가격비교 — DDR5 32GB 키트·삼성 DDR5-5600 32GB 주간 최저가, NVMe SSD 1TB 최저가 (2026-10-15 조회)

The post 램 값 두 배 뛴 지금, 증설 대신 SSD에서 모델을 읽는 법 — 스트리밍 엔진 3종 판정 appeared first on .

핵심 요약 — 30초 결론

VRAM별 기본 선택 (Qwen3.8-27B 기준 실제 파일 크기)

Q4 vs Q8, 품질 차이는 얼마나 되나

품질 근거는 2026년 Unsloth가 여러 양자화 제공자를 같은 기준으로 비교한 공식 벤치마크(Qwen3.5-122B-A10B, Wiki-text 기반 PPL·KL 발산)를 본다. 같은 모델을 누가 어떤 방식으로 양자화했는지에 따른 차이까지 함께 보인다.

Q8과 Q4의 PPL 차이는 0.056, 평균 KL 발산 차이는 0.011이다. 반면 Q4→Q3으로 내려가면 PPL이 0.13 벌어지고 Q3→Q2에서 0.32 더 벌어진다. 즉 4비트까지는 완만하고, 3비트부터 기울기가 커지며, 2비트에서 품질이 무너진다는 구조다. 이것이 “VRAM이 허락하는 한 Q4 이상을 유지하라”는 기본 전략의 근거다.

단, 이 수치는 일상 대화·지식 질의 수준의 측정이고 에이전트·도구 호출은 더 취약하다. Unsloth가 2026년 9월 발표한 Divergence-300@32 측정(300개 미공개 프롬프트로 BF16 대비 32토큰 궤적 일치율 측정)에서는 2비트 이하에서 급락이 시작된다 — UD-Q2_K_XL 약 25% → UD-IQ2_S 8~10% 미만. 즉:

• Q4_K_M~Q6_K 구간: 측정 가능한 품질 손실이 사실상 없다. VRAM이 부족해서 Q8을 포기할 이유가 없다.
• Q3_K~IQ3 구간: 대화·요약은 유지되지만 긴 추론·도구 호출에서 오답이 늘기 시작하는 구간. 12GB 이하 카드에서는 어쩔 수 없지만, 코딩 에이전트 용도라면 모델을 더 작은 것으로 바꾸는 편이 낫다.
• IQ2 이하: 에이전트·도구 호출 용도로는 쓰지 않는다. Unsloth 공식 문서도 “1-bit는 에이전트 유스케이스에 사용하지 말라”고 명시한다(루핑·빈 응답·도구 호출 실패).

i-quant(IQ)와 K-quant, 뭐가 다른가

같은 비트 수라면 두 계열이 파일 크기와 품질이 다르다.

• K-quant (Q4_K_M, Q5_K_S…): 블록 단위 스케일링. llama.cpp 오리지널. 속도가 빠르고 호환성이 좋다.
• i-quant (IQ4_XS, IQ3_S…): 중요도 행렬(imatrix) 기반. 같은 크기에서 품질이 더 좋지만, 캘리브레이션 데이터에 의존하고 양자화 시간이 오래 걸린다. 극한 압축(3비트 이하)에서 K-quant보다 유리하다.
• UD- 접두사 (UD-Q4_K_M 등): Unsloth Dynamic 3.0. 레이어별 중요도를 차등 배분해 같은 크기의 타 제공자 양자화 대비 최대 +10% top-1 정확도를 낸다고 unsloth가 밝혔다(2026-09). 같은 크기의 plain Q4_K_M이 있다면 UD-를 우선한다.

실제 선택은 “정확도 곡선의 무릎”에서 한다. 4비트까지는 거의 수평이고, 3비트부터 기울어지고, 2비트에서 무너진다. 따라서 VRAM 예산 안에서 무릎 위(4비트 K-quant)에 머무는 것이 정답이고, 예산이 안 되면 모델 크기를 낮춰 다시 4비트로 맞춘다.

2026년형 모델은 규칙이 다르다 — MoE·하이브리드

최근 로컬 모델은 dense 27B보다 gpt-oss-20b(21B 총 파라미터·3.6B 활성)나 Qwen3.8-Flash-Next(125B 총·6B 활성) 같은 MoE가 늘었다. 양자화 선택 기준이 달라진다.

gpt-oss-20b의 특수성: 이 모델은 OpenAI가 애초 MXFP4로 학습 후 양자화(post-training)했다. 그래서 Q4_K_M(11.62GB)와 Q8_0(12.11GB)의 차이가 0.5GB에 불과하다 — MoE 가중치가 이미 4비트로 압축돼 있어 Q8로 올려도 줄어들 게 없다. gpt-oss-20b는 Q8_0를 받아도 된다. 공식 문서도 “All evals were performed with the same MXFP4 quantization”이라고 밝힌다. 단 16GB 미만 카드라면 UD-Q4_K_XL(11.87GB)로 내려가고 이때도 손실은 거의 없다.

Flash-Next 같은 거대 MoE: 125B 총 파라미터 모델의 Q4_K_XL이 103.7GiB다. 단일 소비자 GPU는 커녕 워크스테이션도 아니다. “활성 6B니까 가볍겠지”하고 받으면 74GB짜리 IQ1_M을 내려받게 된다. 총 파라미터 전체가 메모리에 상주해야 하므로 MoE는 총 파라미터 크기로 파일을 고르고, 활성 파라미터는 속도에만 영향을 준다.

컨텍스트가 길어지면 양자화보다 KV 캐시가 먼저 문제다

27B Q4_K_M(16.5GB)을 16GB 카드에 올리고 컨텍스트를 32K로 늘리면 언젠가 OOM이 난다. 가중치 양자화와 별개로 KV 캐시는 컨텍스트에 비례해 커진다. Qwen3.8-27B는 64레이어 중 4개만 풀 어텐션(나머지 Gated DeltaNet)이라 KV 캐시가 매우 작은 편이지만, 일반 dense 모델은 8K 기준 1~2GiB, 32K에서 4~8GiB까지 간다.

이때 선택지는 둘이다.

1. KV 캐시 양자화 — llama.cpp --cache-type-k q8_0 --cache-type-v q8_0(기본 f16). 용량을 절반으로 줄인다. 단 V 캐시 q4_0는 품질 저하 보고가 있어 q8_0까지를 권장한다.
2. MoE 레이어 CPU 오프로드 — llama.cpp --n-cpu-moe N. 전문가 가중치 일부를 RAM에 두고 GPU에는 어텐션만 올린다. MoE 모델을 12~16GB 카드에서 돌리는 사실상 표준 패턴이다. dense 모델엔 --n-cpu-ffn이 대응한다.

즉 “VRAM 부족 → 더 낮은 양자화”만이 아니라 “KV 캐시 q8_0 + MoE 오프로드 조합으로 Q4를 유지”하는 편이 품질적으로 낫다.

VRAM별 최종 판정표

위 데이터를 종합해 한국에서 실제 구매 가능한 카드 기준으로 정리한다. (파일 크기는 2026-10-08 Hugging Face API 실측)

자주 묻는 질문

Q4로 받았는데 Q8과 차이를 체감할 수 있나요?

PPL 데이터상 차이는 소수점 셋째 자리다. 체감 차이는 거의 없으며, 차이를 느꼈다면 양자화가 아니라 샘플링 파라미터(temperature, top_p)나 컨텍스트 초과가 원인일 확률이 높다. Qwen3.8은 thinking 모드 temperature=1.0·top_p=0.95, instruct 모드 temperature=0.7·top_p=0.80을 공식 권장한다.

Ollama로 받으면 뭘로 받기나 하나요?

Ollama는 기본 라이브러리 모델을 Q4_K_M로 배포한다. 즉 ollama pull qwen3.8:27b로 받는 순간 이 글의 “Q4_K_M 기본값” 전략과 같다. 더 높은 정밀도가 필요하면 커뮤니티 GGUF를 직접 내려받아 Modelfile로 등록한다.

IQ4_XS와 Q4_K_S 중 뭐가 좋나요?

거의 같은 크기(14.3GB vs 14.9GB)라면 i-quant(IQ4_XS)가 이론상 같은 크기에서 더 낫다. 다만 IQ 계열은 레거시 하드웨어에서 커널 지원이 늦을 수 있으니, 구형 카드라면 Q4_K_S가 안전하다.

언제 Q8_0를 받아야 하나요?

① 24GB+ 카드에서 파일이 넉넉히 들어갈 때, ② gpt-oss처럼 원본이 이미 4비트 MoE라 Q8과 크기 차이가 없을 때, ③ 파인튜닝처럼 정밀도가 민감한 작업을 할 때다. 그 외에는 Q4~Q6의 손실이 측정 한계 수준이라 Q8의 공간이 아깝다.

2비트 양자화는 언제 쓸 수 있나요?

UD-IQ2_S(8.37GB)는 8GB 카드에서 27B를 돌리는 마지막 수단이지만, Divergence-300@32가 8~10%로 무너진다. 짧은 지식 질의만 가능하고 도구 호출·에이전트는 실패한다. 이 크기면 Qwen3.5-9B Q6_K(7.5GB)를 받는 편이 모든 면에서 낫다.

결론 — 선택은 세 단계로

1. VRAM에 들어가는 가장 높은 K-quant를 받는다. 기본값 Q4_K_M. 16GB 카드면 UD-Q4_K_M, 24GB면 Q6_K.
2. 안 들어가면 양자화를 낮추기 전에 KV q8_0·MoE 오프로드를 먼저 쓴다. Q4를 유지하는 편이 품질에 낫다.
3. IQ3 이하로 내려가야 한다면 모델을 작은 것으로 바꾼다. 27B IQ3_S < 14B Q4_K_M가 실사용 품질 기준으로 대체로 낫다.

커뮤니티에서 반복되는 질문 “3080 10GB로 코딩 모델 뭘 받아야 하나”의 답도 이 표에서 나온다 — 27B UD-IQ3_S + n-cpu-moe로 진입하거나, 14B Q4_K_M로 안정적으로 가거나 둘 중 하나다.

참고자료

• Unsloth Dynamic 3.0 GGUF — Divergence-300@32 측정 방법과 1비트 경고
• Unsloth Qwen3.5 GGUF 벤치마크 — 양자화별 PPL·KL 발산 전체 표
• Unsloth Qwen3.8-27B-GGUF 저장소 (파일 크기 실측 원본)
• OpenAI gpt-oss-20b 모델카드 — MXFP4 post-training 양자화 명시
• llama.cpp server README — –n-cpu-moe / –cache-type-k 옵션
• Qwen3.8-Flash-Next 모델카드 — 125B 총 / 6B 활성 파라미터 구조
• 파일 크기는 2026-10-08 기준 Hugging Face API 실측값이다.

내부 링크: 로컬 LLM용 RAM·VRAM 계산은 로컬 LLM 메모리 계산법에서, GPU 구매 타이밍은 로컬 LLM용 GPU 지금 사도 될까?에서 다룬다. 맥미니 통합 메모리 기준은 맥미니 로컬 LLM 모델 선택을 참고한다.

The post 로컬 LLM 양자화 뭘로 받을까? — VRAM별 Q4·Q8·IQ 선택 기준 (2026년 10월) appeared first on .

핵심 요약

• 결론: AI 코드 리뷰 도구는 “리뷰어 대체”가 아니라 1차 필터다. 머지 책임자는 사람이어야 한다.
• 3단계 게이트: ① 작업 단위 커밋 분할 → ② 자동 리뷰(Copilot Code Review·PR-Agent·CodeRabbit 등) → ③ 사람 승인 + 브랜치 보호 규칙 강제.
• 데이터 경계가 첫 기준: 사내 코드가 외부 SaaS·외부 모델로 나가는지부터 확인한다. 코드가 나가면 안 되는 곳은 PR-Agent 셀프호스팅(오픈소스, 모델 직접 지정) 또는 “로컬 에이전트 + 사람 리뷰” 조합.
• 비용(2026-10-05 공식 페이지 기준): GitHub Copilot Code Review는 Copilot 유료 플랜에 포함(Pro $10/월, Business $19/석/월). CodeRabbit Essentials $24/개발자/월(연간 결제), Greptile Pro $30/석/월. Claude/Codex 구독자는 추가 비용 없이 기존 에이전트로 사전 검토 가능.
• 이 글의 워크플로는 공식 문서 기반 정리이며, 특정 팀 사례를 재현한 실측이 아니다.

왜 지금 문제가 되나

에이전트로 코딩하는 팀이 늘면서 커뮤니티에서 같은 고민이 반복된다. “에이전트 커밋이 너무 커서 실제로 리뷰할 수가 없다”, “회사에 개발자가 나 혼자인데 AI가 유일한 리뷰어다”, “고쳤다고 말했는데 코드만 바뀌고 버그는 그대로다” 같은 질문이 국내외(HN, Reddit, OKKY)에서 2026년 9~10월 연이어 올라온다. 공통 원인은 둘이다. 앞서 정리한 모델 품질 저하 의심을 측정하는 방법과 마찬가지로, 결국 “믿을 수 있는 검증 지점”을 확보하는 문제다.

• 변경 단위가 사람 검수 용량보다 크다. 에이전트는 한 번에 수십 파일을 고치지만, 사람이 한 번에 검증할 수 있는 diff는 기능 단위가 원칙이다.
• “리뷰했다”와 “확인했다”가 구분되지 않는다. AI가 남긴 “LGTM”성 코멘트는 근거가 없다. 머지 승인은 변경을 저장소와 테스트로 다시 확인한 사람의 서명이어야 한다.

3단계 게이트: 분할 → 자동 검토 → 사람 승인

1단계 — 커밋을 작업 단위로 분할한다

에이전트에 처음부터 “작은 단위로 커밋을 나눠라”고 지시하는 게 원칙이고, 이미 몰아서 쓴 커밋은 git add -p로 나누거나 기능 단위로 PR을 다시 만든다. Claude Code는 공식 문서도 “생성된 PR을 제출 전에 검토하고 잠재 위험을 짚어보라”고 안내한다. 분할 기준은 코드 줄 수가 아니라 되돌리기 어려운 정도다.

• 문구·오타·테스트 이름: 자동 통과 또는 빠른 확인
• 단순 버그 수정: 1인 검토
• 기능 설계·공통 모듈·리팩터링: 관점이 다른 복수 검토
• 인증·권한·스키마 변경·외부 연동: 강화 리뷰 + 사람 승인 필수

변경이 커질수록 사람의 검증 능력이 급격히 떨어지는 건 정해진 사실이라, 아래 도식은 그 관계를 개념적으로만 표현한 것이다(실측 데이터가 아니다).

2단계 — 자동 리뷰를 1차 게이트로 놓는다

여기서부터가 도구 선택이다. 목적은 리뷰어 대체가 아니라 사람이 봐야 할 지점을 좁히는 필터다.

가격은 모두 공식 페이지에 오늘(2026-10-05) 접속해 확인한 값이며 세전 미국 달러, 프로모션 미적용이다. CodeRabbit의 데이터 정책 인용은 공식 FAQ 원문 기준이다.

3단계 — 사람 승인과 브랜치 보호로 마무리한다

자동 리뷰가 끝나도 머지 여부는 사람이 결정하고, 그 결정이 규칙으로 강제되어야 한다.

• 브랜치 보호 규칙: main 직접 push 금지, PR 필수, 승인 1건 이상, 상태 검사(CI) 통과 필수
• AI가 승인 코멘트를 남길 수 있게 했다면 “AI 리뷰는 승인 카운트에서 제외”하고 사람 어프루브만 요구하도록 설정한다
• 인증·권한·스키마·외부 연동 변경은 라벨(review:required 등)로 트리거해 사람 승인을 강제한다
• 에이전트 동작 지침은 AGENTS.md·CLAUDE.md에 “검수 가능한 커밋 단위” 규칙으로 명문화한다
• 머지 커밋 메시지에 검수자를 남긴다 — “AI는 코드를 쓰고 검토할 수 있지만, 머지 책임은 이름이 명시된 사람이 진다”

비용 시뮬레이션: 5인 팀 기준

개발자 5명이 한 달에 완료된 리뷰 실행 100회를 균등하게 쓰는 경우를 가정해 계산했다(업계 평균이 아니라 비교용 가정이다).

구독 에이전트(Claude/Codex)를 이미 쓰고 있다면 새 도구를 더 붙이기 전에, PR 생성 전 로컬 검토부터 시작하는 게 비용과 데이터 경계 양쪽에서 유리하다.

자주 묻는 질문

AI 리뷰 도구만 쓰면 사람 리뷰는 없애도 되나?

아니요. AI 리뷰는 스타일·명백한 버그 패턴·보안 초기 스크리닝에 강하고, 비즈니스 로직 정확성·아키텍처 결함·암묵적 팀 지식 판단에 약하다. 공식 문서와 도구 벤더 모두 “사람 최종 검토 필수”를 전제로 설명한다. 사람 승인 게이트를 없애는 방향은 권하지 않는다.

사내 코드가 외부로 나가는 게 걱정되면?

두 가지 선택지가 있다. (1) PR-Agent를 셀프호스팅해 모델을 직접 지정한다 — Ollama 등 로컬 모델 연동도 공식 지원된다. (2) 외부 리뷰 도구 없이 로컬 에이전트 + 사람 검수 조합으로 운영한다. SaaS 리뷰 도구는 코드가 해당 업체와 그 모델 제공사(OpenAI·Anthropic 등)로 전달된다는 점을 계약·보안 검토 전에 확인해야 한다.

에이전트가 만든 커다란 커밋은 어떻게 나누나?

되돌리기 어려운 정도를 기준으로 위험등급을 매기고, 기능 단위로 PR을 다시 구성한다. git add -p로 청크를 나누거나, 에이전트에게 “이 변경을 검수 가능한 단위로 커밋을 분할하라”고 재지시하는 방법이 실무적으로 쓰인다. 분할 자체를 에이전트에게 맡길 때는 결과 diff를 반드시 사람이 훑는다.

CodeRabbit이 Greptile보다 나은가?

목적에 따라 다르다. CodeRabbit은 설정 파일(.coderabbit.yaml)로 경로별 리뷰 규칙·무시 패턴을 팀 단위로 다듬을 수 있고 학습 기능이 있다. Greptile은 저장소 전체 맥락을 읽는 데 강점을 둔다. 소규모 팀이라면 Copilot에 포함된 코드 리뷰로 시작해 부족함이 확인될 때 전문 도구를 검토하는 순서가 비용상 합리적이다.

참고자료

• GitHub Copilot 플랜 및 코드 리뷰 포함 여부 — https://docs.github.com/en/copilot/get-started/plans (2026-10-05 확인)
• CodeRabbit 요금제 — https://www.coderabbit.ai/pricing (2026-10-05 확인)
• CodeRabbit 데이터 프라이버시 FAQ — https://docs.coderabbit.ai/faq (2026-10-05 확인)
• Greptile 요금제 — https://www.greptile.com/pricing (2026-10-05 확인)
• Codex 플랜 및 코드 리뷰 클라우드 통합 — https://developers.openai.com/codex/pricing (2026-10-05 확인)
• Claude Code PR 워크플로 지침 — https://code.claude.com/docs/en/common-workflows (2026-10-05 확인)
• PR-Agent (오픈소스, MIT) — https://github.com/The-PR-Agent/pr-agent (2026-10-05 확인)
• Anthropic 요금제 — https://www.anthropic.com/pricing (2026-10-05 확인)

The post 에이전트가 쓴 코드, 누가 검수하나 — 3단계 게이트와 도구·비용 정리 appeared first on .

핵심 요약

• “너프” 의심의 대부분은 재현 가능한 측정 없이는 참도 거짓도 아니며, n=1 비교는 판정 근거가 되지 않는다.
• 측정이 통제되지 않으면 안 된다: 고정 프롬프트, 고정 채점, 핀된 CLI, 매일 같은 시각, 그리고 통계적 유의성.
• 실제로 있었던 품질 저하 사례는 “은밀한 너프”가 아니라 클라이언트 기본값 변경, 세션 버그, 시스템 프롬프트 수정이었다 — Anthropic이 2026년 4월 postmortem으로 공식 인정했다.
• 검증된 실험(livenerf)에 따르면 모델이 “덜 생각”하게 되면 정확도보다 출력 토큰이 먼저 움직인다. 개인 추적에서 토큰 수 추적이 가장 저렴한 조기 경보다.
• 같은 계열 모델 교체(예: Opus 5 5.5) 정도의 미세한 차이는 월 몇 달러짜리 개인 추적으로는 잡지 못한다. 한계를 알고 측정하자.

왜 “네프 느낌”만으로는 판정이 안 되는가

LLM은 본질적으로 비결정적(non-deterministic)이다. 같은 프롬프트를 두 번 보내도 출력이 달라진다. sampling 온도를 0으로 고정해도 완전한 재현이 보장되지 않고, 최신 모델은 thinking을 끌 수 없는 경우도 있다. 그래서 “어제는 잘하던 게 오늘은 안 된다”는 경험 하나로는 다음 세 가지가 구분되지 않는다.

1. 정상적인 샘플링 변동
2. 실제 서비스 변경(라우팅, 기본값, 프롬프트, 인프라)
3. 사용자 쪽 변화(프롬프트·컨텍스트가 길어짐, 과제가 어려워짐, 신선함 효과가 사라짐)

HN에서 이 주제를 다룰 때마다 반복되는 정론도 같다. “네트워크 느낌”은 증거가 아니고, n=1 비교는 쓸모가 없다는 것. 실제로 한 커뮤니티에서는 여러 해 동안 “너프됐다”는 보고가 반복됐지만 지속적으로 재현된 사례는 소수였고, 그 소수는 뒤에서 설명할 “인시던트”로 판명됐다.

측정 프로토콜: 고정 패널 + 매일 실행 + 통계

2026년 9월 Opus 5.5 출시 직후 시작된 오픈소스 실험 livenerf가 좋은 참고 사례다. 이 프로젝트는 “출시 후 모델이 조용히 나빠지는가”라는 질문 하나에 대해, 논쟁이 감싸움이 되지 않도록 통제된 측정 설계를 공개하고 실행 중이다. 핵심 설계는 다음과 같다.

여기서 개인이 가져갈 수 있는 원칙은 명확하다. 바꿀 수 있는 것은 전부 동결하고, 바뀐 것만 측정한다. 프롬프트·채점 기준·도구 버전·실행 시각이 흔들리면 그 흔들림이 모델 변화로 위장한다.

조기 신호는 토큰 수다

livenerf가 검증 단계에서 얻은 가장 실용적인 발견은 이것이다. 노력(effort) 등급을 high에서 medium으로 낮추면 정확도는 −4.2 ± 3.9포인트로 통계적으로 애매하지만, 출력 토큰은 −26%로 즉각·명확하게 줄어든다. low까지 내리면 정확도 −8.3 ± 4.5포인트, 토큰 −62%다.

alt=”livenerf 검증 결과: 노력 등급 변경과 모델 교체가 정확도와 출력 토큰에 미치는 영향”/>

*출처: ninjahawk/livenerf 저장소 검증 수치 (2026-10-01 기준)*

즉 개인 수준에서 “모델이 예전보다 덜 생각하는 것 같다”를 확인하는 가장 싼 방법은 정답률 재측정이 아니라 동일 과제의 출력 토큰 중앙값 추적이다. 토큰 수는 로그에 남고, 노이즈가 적고, 변화가 정확도보다 먼저 나타난다.

주의할 점도 있다. livenerf의 검증에서 Opus 5로 모델을 통째로 바꿔도 Opus 5.5와 99% 신뢰수준에서 구분되지 않았다(−3.8 ± 6.3포인트). 같은 계열의 미세한 교체는 이 정도 규모의 추적으로는 잡을 수 없다는 것을 스스로 측정한 셈이다. 개인 추적의 한계를 인정하고, “잡을 수 있는 것”(노력 등급·프롬프트 변경급의 변화)과 “못 잡는 것”(동급 모델 스왑)을 구분해서 해석해야 한다.

실제로 있었던 “너프”의 정체 — Anthropic postmortem

“은밀한 너프”가 사실이었던 적이 있을까. Anthropic은 2026년 4월, Claude Code 품질 저하 보고에 대해 공식 postmortem을 발표했다. 사용자들이 “모델이 나빠졌다”고 느낀 기간의 원인을 조사한 결과, 세 가지 개별 변경이 확인됐다.

이 사례가 시사하는 바가 두 가지 있다. 첫째, 사용자들의 체감 저하는 실재했고 원인도 실재했다. 둘째, 그 원인은 “가중치를 몰래 양자화했다”류의 음모가 아니라 클라이언트 기본값·프롬프트·세션 처리의 변경이었다. API는 영향을 받지 않았고, 문제는 Claude Code·Agent SDK·Cowork 쪽이었다. Anthropic은 같은 글에서 “모델을 의도적으로 저하시킨 적은 없다”고 밝히며, 내부 eval이 초기에 재현하지 못한 이유(트래픽 슬라이스별로 다른 시점에 다른 변경이 적용됨)도 설명했다.

5단계 실전 체크리스트

내가 쓰는 모델이 나빠졌는지 의심될 때, 다음 순서로 확인한다. 하루 10분 이내로 끝나는 것부터.

1. 내 쪽 변경 배제 — 시스템 프롬프트, 컨텍스트 길이, 도구 목록, 노력(effort) 설정, CLI/SDK 버전이 바뀌지 않았는지 먼저 확인한다. Opus 5.5는 API 기본 effort가 medium이므로 명시 안 하면 high가 아니다.
2. 고정 과제 3~5개 재실행 — 예전에 잘 풀었던 실무 과제를 프롬프트째 저장해뒀다가 그대로 돌린다. 한 번이 아니라 3회 이상.
3. 출력 토큰 중앙값 비교 — 같은 과제의 출력 토큰 수가 기록 대비 20% 이상 줄었으면 노력·프롬프트·라우팅 변경 의심. 정답률보다 민감한 지표다.
4. API와 구독 경로 분리 테스트 — 같은 모델을 API로 호출해 결과가 다르면 문제는 서빙 경로(구독 클라이언트) 쪽. postmortem 사례가 정확히 이 패턴이었다.
5. 공식 상태 페이지·changelog 확인 — 클라이언트 변경 이력을 먼저 본다. 모델 가중치 의심은 최후에.

자주 묻는 질문

너프 측정에는 얼마나 많은 샘플이 필요한가?

livenerf 기준으로 하루 1회 전 패널(90샘플)을 10일간 돌려야 약 ±7.5포인트 변화를 감지한다. 개인이 몇 번 물어보고 “더 멍청해졌다”고 결론 내리는 것은 이 감도에서 수십 배 모자란다. 반드시 분포 비교로 판정한다. 평가 세트 설계 자체의 원칙은 AI Evals 실무 가이드를 참고한다.

temperature 0으로 하면 재현되지 않나?

완전하지 않다. 서버 측 배치·라우팅·캐싱 상태에 따라 미세하게 달라질 수 있고, 최신 모델은 thinking을 비활성화할 수 없어 변동성이 남는다. 그래서 “완전한 결정성”이 아니라 “결정적인 것은 전부 동결”이 현실적인 목표다.

벤치마크 점수가 그대로면 너프가 아닌가?

그렇다고 단정할 수 없다. 공개 벤치마크는 운영사가 식별해 특별 취급할 수 있고(livenerf도 이 한계를 명시한다), 실사용 품질과 벤치마크 점수가 항상 일치하지 않는다. 반대로 벤치마크가 나빠졌다고 반드시 의도적 너프인 것도 아니다. 인시던트인지 의도인지는 운영사 투명성 없이는 구분 불가능하다.

그냥 다운그레이드 모델이 섞여 들어오는 건 아닐까?

같은 이름 뒤에 여러 버전이 롤아웃되는 것은 업계에서 실제로 있는 운영 방식이다. 다만 livenerf 검증에서 보았듯 동급 모델 스왑은 개인 규모 측정으로 잡기 어렵다. 의심되면 API 직접 호출과 구독 경로를 비교하는 편이 실용적이다.

정리

“모델이 나빠졌다”는 느낌은 무시할 신호도 아니지만 그 자체로 결론도 아니다. 실제 품질 저하 사례는 존재했고, 그 원인은 측정 가능한 변경이었다. 개인이 할 수 있는 가성비 최고의 대응은 (1) 고정 과제와 프롬프트 동결, (2) 출력 토큰 중앙값 추적, (3) API/구독 경로 분리 비교다. 그리고 커뮤니티 주장은 어디까지나 발견의 단서로 쓰고, 판정은 재현 가능한 측정과 공식 자료로 한다.

참고자료

• ninjahawk/livenerf — Opus 5.5 출시일 기준 30일 너프 추적 벤치마크 (GitHub)
• An update on recent Claude Code quality reports — Anthropic Engineering, 2026-04-23
• Adding Error Bars to Evals — Anthropic, arXiv:2411.00640
• Claude Opus 5.5 문서 — 기본 effort medium, 컨텍스트 1M, $4/$20 (Anthropic Platform Docs, 2026-10-02 확인)
• Opus 5.5 nerfing 논의 — r/ClaudeAI 커뮤니티 스레드 (2026-10-01~02), Hacker News “Livenerf: Has Opus 5.5 been nerfed yet?” (914 포인트)

The post LLM 너프 의심, 체감 대신 데이터로 확인하는 법 appeared first on .

30초 요약

• 하드 스탑(429 오류로 트래픽 중단)은 OpenAI API 계정에서 Settings → Organization limits → Enforce a hard limit 켜기로 즉시 적용된다. 알림(alert)만으로는 지출이 멈추지 않는다.
• Claude API(Console)는 워크스페이스별 월 지출 한도가 있고, Claude Code 구독(Pro/Max)은 claude.ai 설정에서 월 지출 한도를 설정한다. 사용량 크레딧을 켜지 않으면 한도가 무제한(Unlimited)으로 표시된다.
• Gemini CLI는 무료로 시작할 수 있지만 Google 계정 로그인 기준 1,000회/일, API 키 무료 티어는 250회/일·Flash 모델 전용이다. 무료 한도를 넘는 순간 과금 또는 차단이 발생한다.
• 예산 상한은 “실행 후 확인”이 아니라 “실행 전 설정”이 원칙이다. 실제 사건들(Codex 826개 하위 태스크 병렬 실행 등)은 상한 부재 상태에서 발생했다.
• 비용 절감은 상한 설정 이후에 적용한다: /clear, /compact(컨텍스트 관리), MAX_THINKING_TOKENS 환경변수(추론 예산 하한), CLI 도구 우선(MCP 서버 최소화) 순서가 공식 문서 권장 순서다.

코딩 에이전트 요금은 왜 순식간에 커지나

챗봇은 질문 1번에 응답 1번이다. 코딩 에이전트는 다르다. 목표를 달성하기 위해 계획을 세우고, 도구를 호출하고, 결과를 검토한 뒤 다시 판단하는 루프를 돈다. 이 과정이 몇 번 반복될지는 미리 알기 어렵고, 하위 에이전트가 파생되면 호출 수는 곱셈으로 늘어난다.

2026년 9월 26일 공개된 한 사례는 이 구조의 극단을 보여준다. VS Code에서 시작한 단순한 UI/UX 검토 요청이 Codex 계정에서 826개의 하위 태스크로 병렐 실행됐고, 요청자는 승인한 적 없는 약 7만 8천 달러 규모 사용량과 기록 삭제를 발견했다. OpenAI에 2주 넘게 티켓을 열어도 인간 응답을 받지 못했다는 게 이 사례의 두 번째 문제다. 이 사용자 계정에 하드 스탑 지출 한도가 설정돼 있었다면, 첫 429 오류 시점에 실행이 멈췄을 것이다.

같은 시기 국내에서도 유사한 이슈가 보도됐다. 국내 대학생 Claude 이용자의 카드에 약 25억 원, 이후 약 250억 원 결제 시도가 반복됐고, Anthropic은 “자동 충전 금액이 비정상적으로 높게 설정된 오류”라고 설명했지만 당사자는 자동 충전을 설정한 적이 없다고 밝혔다. 다행히 카드 한도로 실제 출금은 없었지만, 비정상 금액이 카드 승인 단계까지 전달됐다는 점이 사건의 무게를 달리 한다.

조직 차원에서는 Uber가 2026년 연간 AI 예산을 Claude Code 사용으로 4개월 만에 소진했다는 보도(Fortune, 2026년 5월), 이후 도구 사용량 상한을 두겠다는 후속 보도(Bloomberg, 2026년 6월)가 이어졌다. Anthropic 자체도 Claude Code의 엔터프라이즈 평균 비용으로 개발자당 활성 사용일 $13, 월 $150~250을 공식 제시하며 비용 관리 가이드를 운영 중이다. 즉 “에이전트가 비싸다”가 아니라 “경계 없는 자동 실행은 통제 불능이 된다”가 실제 문제다.

도구별 예산 상한 설정법 — 공식 문서 기준

OpenAI API / Codex: 하드 스탑이 핵심

OpenAI API 플랫폼은 두 가지 지출 통제를 제공한다.

설정 순서는 다음과 같다.

1. platform.openai.com/settings/organization/limits 접근 (또는 프로젝트별 Settings → Limits)
2. Spend → Edit spend limit 클릭
3. Monthly spend limit 금액 입력
4. Enforce a hard limit 토글 켜기 — 이 토글이 핵심이다. 꺼져 있으면 한도는 알림 역할만 한다.
5. 저장

주의할 점 두 가지. 첫째, 하드 한도 적용은 즉각적이지 않아서 기록된 지출이 설정 금액을 소액 초과할 수 있다(공식 문서 명시). 둘째, 한도 도달 시 오류 코드가 organization_spend_limit_exceeded(조직 전체) 또는 project_spend_limit_exceeded(프로젝트별)로 구분되므로, 에이전트의 재시도 로직이 이 오류를 “일시 오류”로 분류해 재시도 폭주를 일으키지 않도록 처리해야 한다.

Codex가 ChatGPT 구독 크레딧으로 과금되는 조직이라면 관리 콘솔의 사용량 한도(Usage limits)를 별도로 설정한다. 워크스페이스 기본값 → 그룹 기본값 → 사용자 예외 순서로 적용되며, 사용자 한도는 공유 크레딧 풀이 남아 있어도 개인 사용을 먼저 멈춘다. 토큰 기반 과금 조직은 워크스페이스 월 예산(USD)이 별도 상한이다.

Claude Code: 어디서 과금되는지 먼저 확인

Claude Code 비용은 인증 방식에 따라 상한 설정 위치가 완전히 달라진다.

개인 Pro/Max 사용자가 가장 흔히 빠뜨리는 단계가 사용량 크레딧(usage credits) 활성화다. 이 기능을 켜야 월 지출 한도 설정이 노출되고, /usage 화면의 사용량 크레딧 행에서 현재 월 지출을 한도 대비로 볼 수 있다. 켜져 있지 않으면 행이 Unlimited로 표시된다. Claude Code 내부에서 /usage를 실행하면 세션 토큰 사용량, 모델별 귀속, MCP 서버별 점유율, 동작 플래그(긴 컨텍스트·캐시 미스 등)를 로컬에서 바로 확인할 수 있다.

Console(API) 사용자는 워크스페이스 단위로 월 지출 한도와 요청/분, 입력·출력 토큰/분 제한을 함께 걸 수 있다. 주의점: 기본 워크스페이스에는 한도를 설정할 수 없고, 워크스페이스 한도는 조직 한도보다 낮게만 설정 가능하다.

Gemini CLI: 무료 한도의 정확한 경계

Gemini CLI는 인증 방식별로 일일 요청 한도가 갈린다.

핵심은 API 키 무료 티어는 Flash 모델만 호출 가능하고 250회/일이라는 점이다. 코딩 에이전트를 무료 API 키로 돌리면 하루 몇 시간 만에 한도에 닿고, 이후 429 오류 또는 과금 전환이 발생한다. 개인 Google 계정 로그인(1,000회/일)이 무료로 쓸 수 있는 상한이 가장 높다. 무료 한도를 넘어 장시간 작업이 필요하면 종량제 전환 또는 Google AI Pro 구독이 공식 권장 경로다.

예산이 이미 폭주했을 때: 확인 → 차단 → 원인 순서

요금 폭주를 발견한 직후의 대응은 다음 순서로 한다.

1. 현재 지출 확인: OpenAI는 platform.openai.com/settings/organization/usage, Claude는 /usage(Claude Code) 또는 Console 사용량 페이지에서 확인한다.
2. 즉시 차단: 하드 한도가 꺼져 있으면 즉시 설정(또는 프로젝트별 한도를 소액으로 조정)해 다음 요청부터 429로 멈춘다. 구독 크레딧 사용 중이면 사용량 크레딧을 끄거나 한도를 낮춘다.
3. 원인 파악: 재시도 루프(429를 일시 오류로 오분류한 에이전트), 하위 에이전트 폭주, MCP 서버 오버헤드, 컨텍스트 누적 중 무엇인지 /usage의 귀속 표와 동작 플래그로 식별한다.
4. 재발 방지: 429 *_spend_limit_exceeded 오류를 재시도 대상에서 제외하고, 장기 작업은 세션 예산 단위로 분할한다.

비용 절감은 상한 설정 이후에 — 공식 권장 순서

상한은 사고를 막는 장치고, 절감은 평소 운영 기술이다. Anthropic 공식 문서가 권장하는 절감 순서를 요약하면 다음과 같다.

• 컨텍스트 관리 먼저: 작업 전환 시 /clear, 장기 세션은 /compact(보존할 내용 지정 가능)로 컨텍스트를 줄인다. 오래된 컨텍스트는 이후 모든 요청에 토큰 낭비를 반복한다.
• 모델 선택: 단순 작업은 경량 모델로. 고정 추론 예산 모델은 MAX_THINKING_TOKENS=8000 같은 환경변수로 사고 예산을 낮출 수 있다(적응형 추론 모델은 예산 대신 노력 수준 사용).
• MCP 서버 최소화: gh, aws 등 CLI 도구가 MCP 서버보다 컨텍스트 효율적이다. /mcp로 사용하지 않는 서버를 비활성화한다.
• 세션 단위 위임: 문서 처리·테스트 실행 같은 무거운 작업은 하위 에이전트(subagent)로 위임해 메인 컨텍스트를 보호한다.

실전 체크리스트 — 오늘 10분에 끝내는 예산 설정

• ☐ OpenAI API: Organization limits에서 Enforce a hard limit 켰는가
• ☐ OpenAI API: 지출 알림을 하드 한도보다 낮은 임계(예: 80%)로 설정했는가
• ☐ Codex(구독 크레딧): 관리 콘솔 사용량 한도에서 워크스페이스 기본값·그룹·사용자 예외를 점검했는가
• ☐ Claude Code 구독: 사용량 크레딧을 켜고 월 지출 한도를 설정했는가 (Unlimited가 아니어야 한다)
• ☐ Claude API(Console): 워크스페이스 지출 한도 + 분당 요청/토큰 한도를 같이 걸었는가
• ☐ Gemini CLI: 무료 API 키(250회/일·Flash 전용)로 코딩 에이전트를 돌리지 않는가 — 개인 계정 로그인(1,000회/일)으로 시작하는가
• ☐ 에이전트 재시도 로직이 429 spend_limit_exceeded를 재시도 대상에서 제외하는가
• ☐ 장기 작업에 세션/태스크 단위 예산(Anthropic Managed Agents 세션 예산 등)을 적용했는가

자주 묻는 질문

하드 지출 한도를 걸면 진행 중인 작업은 어떻게 되나?

OpenAI는 “적용이 즉각적이지 않아 기록 지출이 설정 금액을 소액 초과할 수 있다”고 명시한다. 진행 중 요청은 마무리될 수 있고, 그만큼 한도를 살짝 넘을 수 있다. Anthropic Managed Agents의 세션 예산도 같은 구조다 — 상한 도달 시 새 모델 요청을 시작하지 않고 budget_reached로 일시 정지하며, 진행 중이던 요청은 끝까지 실행된다.

지출 알림만 설정해도 되나?

안 된다. OpenAI 공식 문서 기준 알림은 “트래픽을 중단하지 않는다”고 명시돼 있다. 알림은 하드 한도 이전의 경고용으로만 조합하라. 국내 250억 원 결제 시도 사례도 알림이 아니라 카드 한도가 유일한 방어선이었다.

무료 티어만 쓰면 폭주 위험이 없지 않나?

있다. Gemini API 무료 티어는 250회/일·Flash 전용이다. 코딩 에이전트의 루프 구조상 하루 한도는 몇 시간 만에 소진되고, 이후 429 차단으로 작업이 중단된다. “폭주 요금”은 아니지만 “작업 중단”이라는 다른 형태의 실패가 발생한다. 종량제 키를 무료 티어 키로 착각해 설정하면 과금 폭주로 이어진다.

Claude Code 구독(Pro/Max)은 정액제 아닌가?

정액제 안에서도 사용량 기반 제한이 있다. 사용량 크레딧을 켜면 정가 기준 토큰 비용이 측정되고 월 지출 한도를 초과하면 사용이 멈춘다. 구독 요금 외 추가 과금을 막으려면 이 한도를 명시적으로 설정해야 한다. Anthropic이 제시하는 엔터프라이즈 평균(활성일 $13, 월 $150~250)은 팀 규모 산정의 기준선이 된다.

세션 예산과 지출 한도는 어떻게 다르게 쓰나?

지출 한도는 계정/워크스페이스 단위의 월 상한이고, 세션 예산은 개별 장기 작업 단위의 상한이다. 장시간 실행되는 에이전트 작업이 많다면 세션 예산으로 작업별 손실 한계를 정하고, 계정 전체는 지출 한도로 최종 방어선을 만드는 이중 구조가 안전하다. Anthropic Managed Agents는 세션 생성 시 budget 필드로 공개 정가 기준 상한(max_list_cost)을 지정하며, 상한 도달 시 일시 정지 후 사람이 상한을 올리거나 제거하면 재개된다.

결론: 설정은 실행 전에, 점검은 주 단위로

에이전트 요금 폭주는 모델이 아니라 설정 부재에서 온다. OpenAI의 하드 한도 토글 하나, Claude의 월 지출 한도 하나, Gemini의 올바른 인증 방식 선택이면 개인 개발자도 오늘 10분 안에 방어선을 만들 수 있다. 이미 여러 사건이 보여줬듯, 사후 대응(지원 티켓, 카드사 문의)은 느리고 불확실하다. 지출이 멈추는 지점을 먼저 정하는 것 — 그것이 코딩 에이전트를 “맡겨도 되는 도구”로 만드는 유일한 방법이다.

참고자료

• Anthropic, “비용을 효과적으로 관리하기” (Claude Code 공식 문서, 2026-09-29 확인) — https://code.claude.com/docs/ko/costs
• OpenAI, “Spend limits” (API 공식 문서) — https://developers.openai.com/api/docs/guides/spend-limits
• OpenAI Help Center, “Manage usage limits and overages in ChatGPT Enterprise and Edu” — https://help.openai.com/en/articles/20001001
• Google, “Gemini CLI: Quotas and pricing” (공식 문서) — https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/resources/quota-and-pricing.md
• Anthropic, “Session budgets” (Managed Agents 공식 문서) — https://platform.claude.com/docs/en/managed-agents/budgets
• Anthropic, “Workspace limits” — https://platform.claude.com/docs/en/build-with-claude/workspaces
• Hacker News, “OpenAI Codex agents go rogue and consumes USD 78,000 without authorization” (2026-09-26) — https://news.ycombinator.com/item?id=49861047
• Fortune, “Uber blows through its AI budget in 1 quarter” (2026-05-26) — https://fortune.com/2026/05/26/uber-coo-ai-spending-tokens-claude-code/
• Bloomberg, “Uber Caps Usage of AI Tools Like Claude Code to Cut Costs” (2026-06-02) — https://www.bloomberg.com/news/articles/2026-06-02/uber-caps-usage-of-ai-tools-like-claude-code-to-cut-costs
• 디지털투데이, “클로드 코드 비용 ‘2배 폭등’…개인 개발자, 감당할 수 있나” — https://www.digitaltoday.co.kr/news/articleView.html?idxno=661191
• 내부 링크: 코딩 AI 구독, API로 바꾸면 진짜 쌀까? — 조합별 월 비용 손익분기 계산법 — https://blog.kwt.co.kr/coding-ai-subscription-vs-api-cost-breakeven-2026/
• 내부 링크: AI 코딩 에이전트 비교 — https://blog.kwt.co.kr/ai-%EC%BD%94%EB%94%A9-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8-%EB%B9%84%EA%B5%90-claude-code-vs-codex-vs-gemini-cli-%EB%AD%90%EA%B0%80-%EB%8B%A4%EB%A5%B8%EA%B9%8C/

The post 코딩 에이전트 요금 폭주, 실행 전에 막는 법 — Claude Code·Codex·Gemini CLI 예산 설정 총정리 appeared first on .

핵심 요약

• 이름·유형: GoLive (golive) — Agent Skills 표준 배포 스킬 + 무의존성 Node CLI
• 공식 저장소: https://github.com/mikehasa/golive-skill (MIT)
• 공식 문서: README 7개 언어(한국어 포함), TRUST.md·RECOVERY.md·VALIDATION.md·PROVIDERS.md
• 생성일: 2026-09-23 · 최근 릴리스: 0.1.0-alpha.4 (2026-09-26) · 최근 커밋: 2026-09-26
• stars/forks: 978★ / 67 forks (2026-09-27 실측, 생성 4일 만 — provisional)
• 증가 속도: GitHub Events WatchEvent 실측 09-25 +32★, 09-26 +30★. npm golive 패키지 실측 09-24 387다운로드, 09-25 52, 09-26 0 — 단발 노출 스파이크 후 감쇠
• 지원 에이전트: Claude Code, Codex 공식 명시·설치 확인. 그 외 Agent Skills 호환 클라이언트는 미검증
• 검증 시각: 2026-09-27, 임시 HOME에서 설치·진단·제거 직접 실행

무엇이 다른가 — 기존 도구와 비교

“에이전트가 만든 앱을 배포”는 GoLive 혼자 하는 일이 아니다. 차이는 누구의 계정으로, 무엇을 승인받아, 어떤 증거를 남기는가에 있다.

Vercel 공식 스킬은 배포 한 조각만을 자동화한다. GoLive는 배포 전후의 DB 프로비저닝, 환경변수 전달, DNS 레코드, 가입 이메일 여정, 계정 격리 검증까지 하나의 승인 워크플로로 묶는다. v0·Lovable은 아예 플랫폼 안에서 만들고 배포하는 다른 범주다. 내 계정·내 코드 통제가 필요하면 GoLive, Vercel 배포만 빠르게 하면 공식 스킬, 만들면서 바로 게시가 목표면 호스팅형이 맞다.

유용한 경우 / 추천하지 않는 경우

유용한 경우

• Claude Code·Codex로 만든 토이 프로젝트를 실제 사용자에게 열어보고 싶은 개발자
• 배포는 커맨드로 치더라도 DB 생성, 환경변수 매핑, DNS 레코드를 매번 문서 찾아가며 하고 있는 사람
• 혼자 사이드 프로젝트를 돌리며 “운영” 부담을 최소화하려는 1인 개발자

추천하지 않는 경우

• 이미 Kubernetes·Terraform 등 IaC로 배포 파이프라인이 잡힌 팀 — 기존 자산이 더 견고하다
• 운영 프로덕션 배포 관리 — 알파 단계이며 프로모션/롤백은 목업 테스트만 거쳤다(라이브 검증 안 됨, VALIDATION.md 참조)
• 실 결제 연동이 당장 필요한 경우 — Stripe는 테스트 모드만 지원

설치 방법 (Claude Code / Codex)

Node.js 20+가 필요하다. 설치는 임시 홈이 아닌 평소 환경에서 하면 된다.

# 공식 저장소 경로(권장) — Codex
npx skills add https://github.com/mikehasa/golive-skill --skill golive --global --agent codex --yes

# Claude Code
npx skills add https://github.com/mikehasa/golive-skill --skill golive --global --agent claude-code --yes

# npm 오프라인 설치(동일 릴리스)
npx golive@alpha install --agent claude

--global을 붙이면 ~/.claude/skills/golive(Claude Code) 또는 ~/.agents/skills/golive(Codex)에 설치된다. 프로젝트 단위 설치는 --global을 빼고 해당 저장소 안에서 실행한다.

설치 확인:

node ~/.claude/skills/golive/scripts/golive.mjs version --json

version, bundleDigest가 포함된 JSON이 나오면 정상이다. 설치만으로 계정 연결이나 배포는 일어나지 않는다.

에이전트에서 사용할 때는 Claude Code /golive ..., Codex $golive ... 또는 “Use the golive skill to take this app live”처럼 자연어로 지시한다.

설치 검증 — 직접 실행한 명령과 결과

이 글은 임시 HOME에서 실제로 설치·제거를 실행한 결과다(2026-09-27).

• 설치: env HOME=<임시홈> npx -y golive@0.1.0-alpha.4 install --agent claude-code --global → "installed": true, "version": "0.1.0-alpha.4", "location": ".../.claude/skills/golive" JSON 반환. 설치 결과물은 SKILL.md, references/ 9개 provider 문서, scripts/golive.mjs(단일 번들, 1.1MB), release.json(sha-256 bundleDigest 포함)
• 무결성 검증: golive.mjs version --json → bundleDigest: 49441926...4d19a 정상 출력. update-check --json → "status": "current"
• 진단: doctor --json → golive.yaml 없음 오류 정상 동작(초기화 전 상태)
• 구조: ~/.claude/skills/golive는 .golive-owned/versions/<uuid>/bundle를 가리키는 심볼릭 링크다. npm 채널 설치물은 자체 롤백 관리자를 가진다
• 제거: 심볼릭 링크와 .golive-owned/ 디렉터리 삭제로 완전 제거 확인. ~/.config/golive 자격증명 파일은 계정 연결 전에는 생성되지 않는다
• 실제 사용 홈은 변경되지 않았다(검증 전후 미설치 상태 동일)

검증하지 못한 것: 실제 provider 계정 연결, 실제 배포, 결제·DNS 쓰기 동작. 비용 결제·자격증명 입력이 필요한 작업이라 이 글의 검증 범위에서 제외했다.

보안·권한 — 숨기지 않는 한계

• 자격증명 저장: ~/.config/golive/credentials에 평문(0600)으로 저장된다. 키체인이 아니다. 공식 문서가 이 점을 스스로 명시한다
• 네트워크: 소스 스캔(1.1MB 번들 전수 URL 추출)에서 외부 엔드포인트는 Vercel·Supabase·Neon·Netlify·Porkbun·GoDaddy·Resend·Stripe·Cloudflare DNS 공식 API와 npm/GitHub 업데이트 확인뿐이었다. 텔레메트리 전송 코드는 없다
• 승인 우회 가능성: --confirm-live 등 확인 플래그는 CLI 인자라, 이미 provider에 로그인된 에이전트는 golive 계획 없이도 쓸 수 있다. TRUST.md가 코드 강제와 지침 준수의 경계를 구분해 공개한다
• 롤백 한계: 실패해도 자동 롤백은 없다. Netlify 리포인트만 구현됐고 라이브 검증은 안 됐다
• 공급망: npm 게시물은 저장소와 동일 릴리스. 릴리스 체인은 GitHub Actions. 단일 개발자 프로젝트라 버스 팩터는 1이다

제거 방법

# Claude Code 전역 설치 제거
rm ~/.claude/skills/golive ~/.claude/skills/.golive-owned -rf   # 심볼릭 링크 + 실체

# Codex
rm ~/.agents/skills/golive ~/.agents/skills/.golive-owned -rf

# 저장된 자격증명까지 지우려면(값은 백업 후)
rm -f ~/.config/golive/credentials

Skills CLI로 설치했다면 npx skills remove golive도 가능하다. provider 쪽 토큰 폐기는 각 대시보드에서 해야 로컬 삭제와 별개로 완료된다.

붙여넣기 프롬프트 (안전 설치 요청)

이 글의 URL을 Claude Code나 Codex에 붙여넣어 그대로 설치를 요청할 수 있다:

https://blog.kwt.co.kr/golive-agent-skill-deploy-install-security 글을 읽고 GoLive 스킬을 설치해줘.
버전은 0.1.0-alpha.4로 고정하고(npx golive@0.1.0-alpha.4 또는 skills add --skill golive),
설치 후 node <스킬경로>/scripts/golive.mjs version --json 로 bundleDigest를 확인해줘.
계정 연결·배포·결제는 하지 말고 설치와 버전 확인까지만. 내 기존 스킬·설정은 건드리지 마.
제거 방법(심볼릭 링크 + .golive-owned 삭제)도 같이 알려줘.

FAQ

GoLive 스킬은 무료인가?

MIT 라이선스 오픈소스고 GoLive 계정·호스팅 백엔드가 없다. 비용은 연결하는 provider(Vercel·Supabase 등) 사용료만 발생한다.

4일 된 프로젝트인데 써도 되나?

기능 검증은 6개 여정(호스팅 2, DB 2, DNS 2, 이메일, Stripe 테스트, Supabase 인증)이 라이브 테스트를 거쳤다고 공식 문서가 밝힌다. 그러나 프로모션·롤백은 목업 커버리지만 있고 전체 로드맵이 미완성이다. 실 서비스가 아니라 테스트 자원부터 다루는 것이 맞다.

Claude Code 외에 어떤 에이전트에서 되나?

공식 설치 확인은 Codex와 Claude Code다. Hermes·기타 Agent Skills 호환 클라이언트에서의 설치는 이 글에서 검증하지 않았다.

stars 증가는 신뢰할 만한 신호인가?

생성 4일 만 978★는 단발 노출 효과 가능성이 크다. npm 다운로드가 이미 감쇠하는 양상이라 지속 성장 여부는 2~4주 관찰이 필요하다. 이 글은 그 지점을 명시하고 간다.

참고 자료

• GoLive 공식 저장소 — https://github.com/mikehasa/golive-skill
• 신뢰·접근 통제 문서 — https://github.com/mikehasa/golive-skill/blob/main/docs/TRUST.md
• 검증 기록(라이브 vs 목업) — https://github.com/mikehasa/golive-skill/blob/main/docs/VALIDATION.md
• 한국어 README — https://github.com/mikehasa/golive-skill/blob/main/README.ko.md
• Vercel 공식 agent-skills(비교 대상) — https://github.com/vercel-labs/agent-skills

관련 글: 바이브코딩 앱을 프로덕션으로 · 피그마 연결 Figwright 검증 · 코딩 AI 구독 vs API 비용 · AGENTS.md 통합 가이드

The post 에이전트가 만든 앱, 배포까지 맡기는 법: GoLive 스킬 설치·보안·제거 직접 검증 appeared first on .

왜 지금 GPU 가격이 또 뛰었나 — 램 대란의 다음 판

2026년 램 가격 대란을 겪은 사람이라면 구조가 익숙할 것이다. AI 데이터센터가 HBM에 이어 일반 DRAM·GDDR까지 흡수하면서 메모리 가격이 올랐고, SSD에 이어 그래픽카드로 불똥이 옮겨 붙었다.

그래픽카드가 특히 타격받는 이유는 공급 구조에 있다. 엔비디아는 RTX 50 시리즈 GPU와 GDDR7 메모리를 하나의 키트로 묶어서 제조사(ASUS·MSI·GIGABYTE 등)에 공급한다. ZDNet 코리아 보도에 따르면 GDDR7 2GB 모듈 가격이 개당 20달러 초반까지 상승했고, 엔비디아가 키트 가격 인상을 제조사에 통보하면서 8월부터 국내 RTX 50 시리즈 가격이 최대 30% 올랐다. 32GB GDDR7을 탑재한 RTX 5090은 메모리를 16모듈이나 쓰기 때문에 인상 폭이 가장 크다.

여기에 수요 측 충격이 겹쳤다. 9월 들어 미국 주요 리테일에서 RTX 5090 재고가 1주일 만에 소진됐고, AI 서버용 고대역폭 메모리를 일반 소비자 카드로 대수요하려는 움직임까지 겹치면서 리셀 호가가 1,280만 원까지 붙은 상태다.

실측: 다나와 최저가 12개월 추이

말보다 데이터다. 다나와 가격비교의 주간 최저가 이력을 12개월치 가져와서, 마지막 지점만 9월 26일 조회 현재 최저가로 갱신했다.

몇 가지가 그래프에서 바로 읽힌다.

• 5090은 완만한 상승 후 8~9월에 급등했다. 530만~540만 원대를 유지하다가 7월 680만, 8월 720만, 9월 910만 원. 마지막 구간 상승 폭이 가장 크다.
• 5070 Ti는 9월 첫째 주에 계단을 올랐다. 3개월 구간을 주간으로 보면 9/1 117만4,320원 → 9/8 183만170원(+56%) 이후 4주째 183만~189만 원 횡보다.

VRAM별 판정: 지금 살 것, 기다릴 것, 돌릴 것

로컬 LLM에서 그래픽카드 선택은 게임과 다르다. 연산 속도보다 VRAM 용량이 모델 선택권을 결정한다. 로컬 LLM 메모리 계산법 글에서 정리한 기준으로, 2026년 9월 26일 최저가를 얹어 판정표를 다시 계산했다.

판정 기준은 단순하다. 가격이 왜 올랐는지, 언제부터 올랐는지, 지금 꺾였는지다. 5060 Ti급은 인상 폭이 작고 이미 안정됐다. 5070 Ti는 9월 인상 직후라 유통가가 공급가를 아직 덜 반영했을 수 있다. 5090은 수요(AI 서버 전용 구매)가 공급(GDDR7 부족)보다 강해서 단기 반등 근거가 없다.

기다린다면 무엇을 관찰해야 하나

가격 반등의 신호는 감이 아니라 지표로 본다.

1. GDDR7 모듈 현황: 트렌드포스 등 메모리 시장 조사의 GDDR7 2GB 모듈 거래가가 20달러대에서 꺾이는지. 램 가격 대란 때 DDR5 거래가 선행 지표였던 것과 같은 구조다.
2. 다나와 최저가 주간 추이: 5070 Ti가 183만 원 횡보를 깨고 어느 방향으로 움직이는지. 인상 직후 4주 횡보는 유통 재고 소진 단계다. 신규 입고 물량의 공급가가 반영되는 10월이 첫 분기점이다.
3. 중고 시세 괴리: 중고 3090 가격이 신형 5070 Ti에 근접하게 따라오면 24GB 수요가 몰리는 신호다. 그 전에 사는 게 유리하다.

자주 묻는 질문

RTX 5090 가격이 다시 내려갈 가능성은?

단기(2026년 4분기)에는 낮다고 본다. MSRP 1,999달러는 그대로지만 이는 권장소비자가일 뿐 실거래가 결정 요인은 GDDR7 공급과 AI 수요다. 메모리 업체(Samsung·SK하이닉스·Micron)가 HBM 생산에 용량을 배정하는 동안 GDDR7 공급이 풀리기 어렵다는 것이 다수 관측의 전제다. 다만 2027년 GDDR7 신규 라인 가동 여부가 확인되면 구도가 바뀔 수 있으니, 그때 재판정한다.

중고 RTX 3090 24GB는 아직 유효한가?

채택 상태에서는 유효하다. 32B급 양자화 모델이 24GB에 올라가고, 신형 대비 절반 이하 가격에 VRAM만 보면 오히려 우위다. 단 3090은 2020년 출시 카드라 소비전력 350W·발열·케이블 마모 리스크를 중고 매물 상태와 함께 확인해야 한다. 3~4년 사용 매물은 서멀 구리스 재도급 여부를 판매자에게 물어보자.

16GB 5070 Ti를 기다리는 동안 로컬 LLM은 어떻게?

CPU 추론으로 버틸 수 있다. 7~8B Q4 모델은 일반 데스크톱 CPU(CUDA 없이 llama.cpp)에서 초당 수 토큰 수준으로 동작한다. 품질이 아쉬우면 구독형 클라우드 모델을 보조로 쓰는 조합이 하드웨어 189만 원보다 싸다. 구체적인 손익 계산은 코딩 AI 구독 vs API 비용 비교 글을 참고한다.

맥미니 통합메모리는 GPU 대안이 될까?

조건부다. M6 Pro 64GB는 LLM 가속에는 GPU 대비 느리지만, VRAM 32GB 최상위 카드가 910만 원인 지금 메모리 용량당 가격으로는 압도적이다. 속도보다 큰 모델 우선순위라면 유효한 경로다. 메모리별 모델 선택 기준은 맥미니 로컬 LLM 가이드 글에 정리해 두었다.

결론: 구매 결정은 숫자로

• 8~12GB 필요 → 5060 Ti급, 지금 구매 가능. 인상의 핵심은 16GB+ 모델이다.
• 16GB 필요 → 5070 Ti는 반등 관찰. 급하면 중고 3090 24GB가 가격 대비 낫다.
• 32GB 필요 + 예산 900만 → 5090 구매. 단 이 가격이 ‘원가 인상’의 전부가 아닐 수 있음을 감안한다.
• 그 외 대부분 → 구매 유보 + CPU 추론·클라우드 병행. 다나와 주간 최저가로 10월에 재판정한다.

가격 출처는 전부 2026년 9월 26일 다나와 가격비교 조회다. 그래픽카드 가격은 판매처·시점에 따라 달라질 수 있으니 결제 직전 다시 확인해야 한다.

참고자료

• 다나와 가격비교 — RTX 5090·5070 Ti 최저가 이력 (2026-09-26 조회)
• ZDNet Korea — 엔비디아 ‘지포스 RTX 50’ 그래픽카드, 이달부터 최대 30% 가격 인상 (2026-08-03)
• VideoCardz — NVIDIA reportedly raises RTX 5090/5090D V2 board prices due to GDDR7 cost increase
• 지엔뉴스 — “AI 서버 맞추자” 美 RTX 5090 품귀… 암시장 호가 1,280만원 (2026-09-15)
• 관련 글: 로컬 LLM 메모리 계산법 (RAM·VRAM 가이드) · 맥미니 로컬 LLM 모델 선택 기준 · 코딩 AI 구독 vs API 손익분기 · DDR4→DDR5 업그레이드 판정

The post 로컬 LLM용 GPU 지금 사도 될까? — 5090·5070 Ti 가격 2배 급등 실측과 VRAM별 구매 판정 appeared first on .

왜 지금 확인해야 하나

9월 18일 이전에는 Codex·Cursor용으로 AGENTS.md를 쓰는 팀도 Claude Code를 위해 CLAUDE.md를 옆에 두어야 했다. 내용을 복제하거나, @AGENTS.md import 한 줄을 넣거나, 심볼릭 링크를 거는 식이었다. 이 발표 관련 해커뉴스 스레드는 739포인트·286댓글에 달했고, 토론의 대부분은 “각자 어떤 우회책을 써 왔는가”였다.

문제는 검색해서 나오는 한국어 가이드 상당수가 아직 우회책 시대 정보라는 점이다. 8월 30일자 글은 “Claude Code는 CLAUDE.md만 읽고 AGENTS.md는 읽지 않는다(공식 문서)”라고 안내한다 — 9월 18일에 뒤집힌 내용이다. 2025년 11월자 글은 이제 불필요해진 Gemini CLI·Codex 설정 파일 세팅을 여전히 권고한다. 이 글은 실행 당일 기준으로 공식 문서를 다시 읽고 정리했다.

5개 도구가 실제로 읽는 파일 — 공식 문서 기준

각 도구의 공식 문서를 2026년 9월 23일에 다시 확인했다. 표의 내용은 모두 1차 자료(공식 문서·공식 changelog) 기반이다.

여기서 눈여겨볼 두 가지.

Codex는 CLAUDE.md를 전혀 읽지 않는다. CLAUDE.md에만 있는 규칙은 Codex에게 보이지 않는다. 같은 저장소에서 Codex와 Claude Code를 함께 썼다면 두 도구가 공통으로 보는 파일은 AGENTS.md뿐이었다. 이번 지원 added로 드디어 Claude Code도 그 파일을 기본으로 읽게 된 것이다.

OpenCode는 Claude Code와 정반대다. OpenCode는 AGENTS.md를 먼저 읽고, AGENTS.md가 없을 때만 CLAUDE.md를 폴백으로 읽는다. 두 파일이 모두 있는 저장소에서 Claude Code는 CLAUDE.md를, OpenCode는 AGENTS.md를 읽는다. 내용이 다르면 두 에이전트가 서로 다른 규칙을 따르는데 어느 쪽도 그 사실을 알려주지 않는다.

Claude Code의 우선순위 규칙 — 어떤 파일이 ‘존재한다’로 세는가

Claude Code 공식 memory 문서가 정의하는 판정 규칙이다.

CLAUDE.md가 존재한다고 세는 파일 (이 중 하나라도 있으면 AGENTS.md를 읽지 않는다):

• 작업 디렉터리와 모든 상위 디렉터리의 CLAUDE.md
• 같은 위치의 .claude/CLAUDE.md
• 같은 위치의 CLAUDE.local.md

세지 않는 파일 (AGENTS.md와 함께 계속 로드된다):

• 개인용 ~/.claude/CLAUDE.md
• 조직의 managed CLAUDE.md
• .claude/rules/ 파일

이 구분이 중요한 이유는 “개인 전역 설정을 쓰고 있으면 AGENTS.md가 안 읽히는 것 아닌가” 하는 오해 때문이다. 그렇지 않다. ~/.claude/CLAUDE.md는 프로젝트 판정에 영향을 주지 않는다. 프로젝트 경로 안의 파일만 판정에 개입한다.

AGENTS.md가 읽혔는지 확인하는 가장 빠른 방법은 대화 상단의 안내 줄이다. agents-md: no CLAUDE.md found; AGENTS.md loaded: /path/to/repo/AGENTS.md 형태로 뜬다. 직접 로드된 AGENTS.md는 /memory나 /context의 Memory files 목록에 표시되지 않으므로, 이 줄이 없으면 읽히지 않은 것이다.

4가지 Project instructions 모드

/config의 Project instructions 설정으로 동작을 바꿀 수 있다. 프로젝트·로컬 설정 파일에서는 이 키가 무시되고 사용자(~/.claude/settings.json)·managed 설정에서만 적용된다는 점에 주의한다.

설정 파일 형태는 다음과 같다.

{
  "pluginConfigs": {
    "agents-md@builtin": {
      "options": {
        "instructionFiles": "claude-md-and-agents-md"
      }
    }
  }
}

Claude 전용 규칙이 정말 필요한 게 아니라면 claude-md-and-agents-md를 쓰기보다 기본값 그대로 두고 CLAUDE.md를 정리하는 쪽이 깔끔하다. 파일이 둘이면 언젠가 내용이 갈라진다.

직접 로드된 AGENTS.md가 CLAUDE.md와 다른 점

설정으로 읽힌 AGENTS.md는 CLAUDE.md를 완전히 대체하지 않는다. 공식 문서가 밝히는 차이는 세 가지다.

• InstructionsLoaded 훅: CLAUDE.md에서는 발생, 설정으로 직접 읽은 AGENTS.md에서는 발생하지 않는다. CLAUDE.md가 import한 AGENTS.md에 대해서는 발생한다.
• --add-dir 추가 디렉터리: CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD 환경 변수와 함께 쓰면 추가 디렉터리의 CLAUDE.md는 로드되고 AGENTS.md는 로드되지 않는다.
• 외부 @path import: CLAUDE.md는 저장소 밖 파일 import 시 승인을 요청하지만, AGENTS.md는 이미 승인된 경우에만 로드하고 프롬프트하지 않는다.

훅을 쓰는 자동화가 있다면 이 차이가 실질적으로 영향을 준다. 해당 없으면 체감 차이는 없다.

마이그레이션 판정 — CLAUDE.md를 삭제할지 import로 남길지

기존 상태별로 공식 문서가 권하는 처리 방법이 다르다. 3분기 매트릭스로 정리했다.

과거 우회책을 쓰고 있었다면 이렇게 정리한다. CLAUDE.md에 @AGENTS.md import가 들어 있으면 그대로 둬도 된다 — 어떤 모드에서든 파일을 두 번 읽지 않는다. “AGENTS.md를 읽으라”는 문장만 있는 CLAUDE.md는 삭제하거나 import 구문으로 바꾼다. AGENTS.md를 심볼릭 링크한 CLAUDE.md는 링크를 삭제해도 내용은 한 번만 읽힌다. SessionStart 훅으로 AGENTS.md를 출력하고 있었다면 훅을 제거한다 — 직접 로드가 되면 컨텍스트에 사본이 하나 더 생긴다.

권장 최종 구성

# AGENTS.md (저장소 루트)

## 공통 규칙
- 커밋 메시지는 Conventional Commits 형식
- PR 전에 npm test 실행

## Claude Code 전용 (필요할 때만 CLAUDE.md로 분리)

Claude 전용 규칙이 필요할 때만 CLAUDE.md를 이렇게 만든다.

@AGENTS.md

## Claude Code
- src/billing/ 변경은 plan mode 사용

import 아래에 Claude 전용 내용을 적으면 import된 파일이 먼저, 나머지가 그 뒤에 로드된다.

Gemini CLI — AGENTS.md를 읽게 하는 설정 한 줄

Gemini CLI는 소스 코드 수준에서 기본 컨텍스트 파일명이 GEMINI.md로 정의되어 있다. AGENTS.md를 읽게 하려면 .gemini/settings.json에 컨텍스트 파일명 배열을 지정한다.

{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

배열로 지정하면 두 파일을 모두 로드하고, 파일명 우선순위대로 찾는다. 전역 ~/.gemini/GEMINI.md는 그대로 살아 있으니 개인 기본값을 유지하면서 프로젝트 단위로 AGENTS.md를 붙일 수 있다. Gemini CLI는 @file.md import도 지원하므로, GEMINI.md 하나만 쓰고 싶다면 @AGENTS.md import로 공용 규칙을 가져오는 방법도 있다.

Codex — 전역과 32KiB 제한

Codex의 지침 체인은 두 층이다. 전역은 ~/.codex/AGENTS.override.md가 있으면 그것만, 없으면 ~/.codex/AGENTS.md를 읽는다. 프로젝트에서는 저장소 루트부터 작업 디렉터리까지 내려가며 디렉터리당 최대 한 파일(AGENTS.override.md → AGENTS.md → fallback 파일명 순)을 읽고, 루트부터 순서대로 이어 붙인다. 나중에 오는 파일(작업 디렉터리에 가까운 파일)이 앞선 지침을 덮어쓴다.

합산 크기 제한이 project_doc_max_bytes로 32KiB 기본값이다. 모노레포에서 지침이 길어지면 잘리므로, 제한을 올리거나 중첩 디렉터리로 분할한다.

# ~/.codex/config.toml
project_doc_fallback_filenames = ["TEAM_GUIDE.md"]
project_doc_max_bytes = 65536

지침을 어디서 로드했는지 감사하려면 codex -c log_dir=./.codex-log으로 TUI 로그를 남기거나 세션 로그의 jsonl 파일을 확인한다.

AGENTS.md가 읽히지 않을 때 — 순서대로 확인하는 체크리스트

1. 버전: claude --version으로 2.1.277 이상인지 확인한다. 낮으면 claude update다.
2. 상위 디렉터리 스캔: 작업 디렉터리 위 어딘가에 CLAUDE.md 계열 파일이 숨어 있으면 그것이 이긴다. 다음으로 찾는다.
3. 업그레이드 직후라면: 두 번째 세션부터 판단한다. 첫 세션은 feature flag가 내려오지 않았을 수 있다.
4. 세션 유형: /config에 Project instructions 항목 자체가 없으면 그 세션은 AGENTS.md를 로드할 수 없는 유형이다(Bedrock, 텔레메트리 비활성화 등). @AGENTS.md import로 우회한다.
5. 읽히지 않는 파일명: AGENTS.local.md, AGENTS.override.md, .agents/ 디렉터리 안의 파일은 Claude Code가 읽지 않는다. AGENTS.override.md는 Codex 전용 규칙이다.
6. /memory로 확인하지 말 것: 직접 로드된 AGENTS.md는 거기 표시되지 않는다. 대화 상단의 AGENTS.md loaded 줄이나 에이전트에 대한 지침 인용 질문으로 확인한다.

AGENTS.md에 무엇을 쓸 것인가

공식 문서의 기준은 “매번 다시 설명하게 되는 것”이다.

• 같은 실수를 두 번째 저질렀을 때
• 코드 리뷰에서 Claude가 알았어야 할 것이 걸렸을 때
• 지난 세션에 쳤던 교정을 또 치고 있을 때
• 새 팀원이 생산성을 내려면 같은 맥락이 필요할 때

빌드 명령, 컨벤션, 프로젝트 구조, “항상 X를 하라”류 규칙 같은 매 세션 필요한 사실만 담는다. 다단계 절차나 코드베이스 일부에서만 중요한 내용은 스킬이나 경로 스코프트 규칙으로 옮긴다. 지침은 구체적이고 간결할수록 일관되게 따른다.

FAQ

AGENTS.md와 CLAUDE.md를 둘 다 두면 어떻게 되나?

기본값에서는 CLAUDE.md만 읽히고 AGENTS.md는 무시된다. 둘 다 읽게 하려면 Project instructions를 claude-md-and-agents-md로 바꾼다.

Claude Code만 쓰는데 바꿔야 하나?

아니다. CLAUDE.md를 그대로 쓰면 된다. 바꿀 이유가 없다. 다른 도구를 같이 쓰게 되는 순간부터 AGENTS.md가 의미를 갖는다.

하위 폴더의 AGENTS.md도 읽나?

Claude가 그 폴더의 파일을 Read 도구로 열 때 읽는다. 단, 그 하위 폴더에 CLAUDE.md 계열 파일이 없을 때만이다. Cursor는 하위 폴더 작업 전반에 적용되고, Codex는 작업 디렉터리까지의 경로 전체를 미리 읽는다 — 도구마다 시점이 다르다.

Codex는 CLAUDE.md를 읽나?

아니요, 전혀 읽지 않는다. Codex와 Claude Code가 같은 규칙을 보게 하는 유일한 방법은 AGENTS.md 한 곳에 규칙을 두는 것이다.

/init을 돌리면 어떻게 되나?

Claude Code의 /init은 기본적으로 CLAUDE.md를 생성한다. CLAUDE_CODE_NEW_INIT=1을 켜면 기존 AGENTS.md를 CLAUDE.md에 합치고 이후 CLAUDE.md가 우선한다. AGENTS.md를 단일 소스로 유지하려면 /init을 건너뛰거나 생성된 파일을 삭제한다. Codex와 OpenCode의 /init은 AGENTS.md를 생성·갱신하므로 충돌하지 않는다.

마이그레이션 후 검증은 어떻게 하나?

Claude Code는 다음 세션에서 /context를 실행해 CLAUDE.md가 Memory files에 나타나는지 확인한다(import 방식의 경우). AGENTS.md 직접 로드는 대화 상단 줄로 확인한다. Codex는 codex --ask-for-approval never "Summarize the current instructions."를 저장소 루트에서 실행해 전역→프로젝트 순서로 인용되는지 확인한다.

참고자료

• Claude Code 공식 문서 — Memory (CLAUDE.md / AGENTS.md): https://code.claude.com/docs/en/memory
• Claude Code Changelog v2.1.277: https://code.claude.com/docs/en/changelog
• OpenAI Codex — Custom instructions with AGENTS.md: https://learn.chatgpt.com/docs/agent-configuration/agents-md
• Gemini CLI — Provide context with GEMINI.md files: https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/cli/gemini-md.md
• Cursor Docs — Rules: https://cursor.com/docs/rules
• GitHub Docs — Repository custom instructions for Copilot: https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot
• OpenCode Docs — Rules: https://opencode.ai/docs/rules/
• AGENTS.md 공식 사이트: https://agents.md/
• 해커뉴스 토론 (2026-09-19, 739pts): https://news.ycombinator.com/item?id=49760187

The post CLAUDE.md와 AGENTS.md, 이제 하나로 쓴다 — 5개 도구 우선순위와 통합 마이그레이션 판정 appeared first on .