9월 초 Spotify 엔지니어링이 Portal과 shunt로 Claude Code 토큰을 크게 줄인 사례를 공개했습니다. 같은 주 Claude Code 2.1.260·2.1.261에는 /diff/skill-doctor가 들어왔고 9월 14일부터는 주간 한도가 조정됩니다. Codex CLI 0.153.0에는 Vim 실행 취소와 플러그인 CLI가 붙었습니다.

1. Spotify Portal / shunt — Claude Code 토큰 ~90% 절감

Portal by Spotify

Portal by Spotify는 짧은 수명 런타임 위에 선언형 에이전트(AiKA Modes)를 돌립니다. Claude Code용 플러그인 shuntportal은 마켓플레이스 spotify/portal-ai-plugins에 있습니다. 공개 예시 모드 두 개는 Gemini 2.5 Flash를 씁니다. bulk-reader는 큰 파일을 요약하고 code-writer는 패턴에 맞는 보일러플레이트를 만듭니다.

Spotify 엔지니어링 글의 핵심은 이렇습니다. AI 코딩 에이전트 일의 상당수는 “생각”보다 파일 읽기·쓰기 같은 I/O라서 그 부분을 싼 모델로 넘기면 토큰이 확 줄어든다는 이야기입니다. Java 모노레포 네 시나리오 벤치마크에서 대량 읽기 평균 절감은 약 90%였습니다.

설치 순서는 아래와 같습니다.

claude plugin marketplace add spotify/portal-ai-plugins
claude plugin install portal@portal
claude plugin install shunt@portal

이어서 /portal:setup을 실행하세요.

PreToolUse 훅 check-file-size는 기본 350줄을 넘는 Read를 막습니다. check-bash-readcat·head·tail·less·more로 큰 파일을 읽는 경우도 잡습니다. 임계값은 환경 변수 SHUNT_MIN_LINES로 바꿀 수 있습니다.

한계는 분명합니다. 줄 번호가 정확해야 하는 편집은 넘기지 마세요. 추론·디버그·아키텍처·안전이 중요한 작업도 마찬가지입니다. 위임 지연은 보통 10~30초고 Portal은 30초 상한이 있습니다.

로그나 생성된 코드처럼 줄 수가 많은 파일을 Claude가 통째로 읽기 직전에 손이 갑니다. 플러그인을 깐 뒤 /portal:setup만 먼저 돌려 보세요.

큰 파일 요약·보일러플레이트만 shunt로 보내고 설계·디버그는 Claude에 남겨 두세요.

2. Claude Code 2.1.260 / 2.1.261 — /diff, /skill-doctor

Claude Code

Claude Code 2.1.260과 2.1.261은 터미널에서 쓰는 Anthropic 코딩 에이전트 업데이트입니다.

2.1.260에서는 전체 화면 모드에 diff 패널이 생겼습니다. Claude가 파일을 고치는 동안 커밋하지 않은 변경을 옆에 나란히 보여 줍니다. /diff로 켜고 끌 수 있습니다. /cost에는 프롬프트 캐시 미스가 났을 때 가능한 원인 힌트도 붙었습니다.

2.1.261에는 /skill-doctor가 추가됐습니다. 로드해 둔 스킬 중 안 쓰는 것과 컨텍스트 비용을 보여 줘서 정리할 때 편합니다. bashOutputMaxCharstaskOutputMaxChars는 인라인으로 최대 128K 문자까지 올릴 수 있습니다.

긴 리팩터 중간에 “지금 뭐가 바뀌었지”를 확인하고 싶을 때 바로 씁니다. 스킬을 많이 켠 채 컨텍스트가 빨리 차는 날에도요. Claude Code를 최신으로 올린 뒤 /diff/skill-doctor를 한 번씩 쳐 보세요.

전체 화면에서 /diff를 켜 두고 스킬이 많으면 /skill-doctor로 안 쓰는 항목부터 빼세요.

3. Claude Code 주간 한도 — 9/14 조정

Claude Code usage

Claude Code 주간 한도는 한 주에 쓸 수 있는 사용량 한도입니다. Pro·Max·Team·좌석형 Enterprise에 적용됩니다.

9월 14일부터는 예전(5월 이전) 표준 주간 한도 대비 영구적으로 +25%가 됩니다. 그전까지는 임시 +50%가 그대로입니다. 오늘 쓰는 임시 한도(기준의 150%)와 비교하면 약 17% 줄어든 수준(기준의 125%)입니다. 옛 기준보다는 늘고 지금 프로모션보다는 줄어드는 숫자입니다.

확인은 Claude Code에서 /usage 한 줄이면 끝납니다. 절대 토큰 수치는 공개되지 않았고 퍼센트만 안내됩니다.

주간 막바지에 한도 경고가 자주 뜨는 팀이라면 9월 14일 전후로 /usage 막대를 비교해 두세요. 예산 짜기가 한결 수월해집니다.

오늘 /usage로 현재 한도를 확인하고 9/14 이후에도 기준 대비 +25%가 남는다는 점과 오늘 대비 약 17% 줄어든다는 점을 같이 적어 두세요.

4. Codex CLI 0.153.0 — Vim undo, 플러그인 CLI

Codex CLI 0.153.0

Codex CLI 0.153.0은 오픈AI 코딩 에이전트 터미널의 9월 3일 릴리스입니다. 이후 0.153.x 핫픽스는 Astra 관련이 많아서 여기선 사용자 도구 쪽만 봅니다.

Vim 모드에서 실행 취소는 u 다시 실행은 Ctrl+R입니다. 붙여넣기와 첨부가 있는 초안도 유지합니다. 원격 마켓플레이스에서 플러그인을 목록·설치·제거하는 CLI가 생겼습니다. tui.auto_recap = false로 자동 요약(recap)을 끌 수 있고 수동 /recap은 그대로입니다. Plus·Team은 약 5시간 사용 창의 절반이 남기 전에 경고가 더 일찍 뜹니다.

Codex에서 초안을 자주 고치거나 플러그인을 명령으로 관리하고 싶을 때 바로 체감됩니다. 버전을 0.153.0 이상으로 올린 뒤 Vim이면 u를 한 번 써 보고 자동 recap이 거슬리면 설정을 끄세요.

Codex를 0.153.0+로 업데이트하고 플러그인 CLI와 Vim undo를 한번씩 확인하세요.

출처

인사이트

큰 파일 I/O는 Portal·shunt 몫입니다. 편집 결과는 /diff로 옆에 두고 주간 한도는 /usage로 9/14 전후를 비교하세요. Codex는 플러그인·undo로 손맛을 맞추면 됩니다.