2026년 에디터 차단의 배경이 된 용량 논리
2026년 초 어느 시점부터 OpenCode, Cline, RooCode 설정에서 Claude와의 연결이 끊겼다면, 버그가 아니라 정책 때문이었다. Anthropic은 서드파티 도구의 구독 OAuth 사용을 의도적으로 막았고, 이를 단계적으로 진행했다.
첫 단계는 조용히 진행됐다. 2026년 1월 9일, Anthropic은 서버 측 강제를 배포했고 OpenCode, Cline, RooCode의 OAuth 흐름은 별다른 안내 없이 실패하기 시작했다. 지원 중단 공지도, 유예 기간도 없었다. 이어 2026년 2월 19일 서비스 약관 업데이트에는 Free/Pro/Max OAuth 토큰을 서드파티 도구와 Agent SDK에서 쓰지 못하게 하는 명시 조항이 추가됐고, 전체 차단은 2026년 4월 4일 전후 적용됐다.
Claude Code 책임자인 Boris Cherny는 이를 용량 우선순위 문제로 설명했다. 구독 용량은 공식 CLI용으로 책정된 것이지, 서드파티 OAuth 소비용이 아니라는 것이다 . Anthropic이 제시한 전환 혜택은 하나뿐이었다. Max 구독자에게 2026년 4월 17일까지만 사용할 수 있는 1회성 200달러 크레딧을 제공했지만, 이월도 기존 사용자 예외도 없었다.
OpenCode, Cline, RooCode를 다시 설정하기 전에 준비할 것
에디터 설정을 건드리기 전에 결제 경로부터 확보해야 한다. console.anthropic.com에서 Anthropic API 키를 생성하라. 2분도 걸리지 않으며, 구독 OAuth가 차단된 지금 서드파티 에디터에서 직접 토큰 단위 과금을 쓰기 위한 필수 자격 증명이다 . 엔터프라이즈 팀에는 대안도 있다. AWS Bedrock 또는 GCP Vertex AI를 쓸 수 있으며, 각 에디터는 원시 API 키 경로와 함께 이를 설정 패널의 별도 제공자 옵션으로 노출한다 .
공식 Claude Code CLI(anthropics/claude-code, GitHub 스타 약 13.8만 개)만 사용한다면 이 문제는 해당되지 않는다. 해당 인터페이스는 영향을 받은 적이 없고 재설정도 필요 없다 .
마지막으로, 전환을 확정하기 전에 예상 일일 토큰 사용량을 계산해 보라. 큰 코드베이스에서 무거운 에이전트 세션을 돌리면 토큰 단위 과금이 하루 30~50달러 이상까지 올라갈 수 있고, 이는 정액 Max 플랜보다 비쌀 수 있다 .
차단 이후 OpenCode, Cline, RooCode 재설정 방법
각 에디터의 재설정은 구독 OAuth를 직접 API 키로 바꾼 뒤, 클라이언트가 실제로 경로를 전환했는지 확인하는 과정이다. 도구마다 세부 방식은 다르지만 구조는 같다. 제공자를 ANTHROPIC_API_KEY로 지정하고, 재시작한 뒤, 과금이 기록되는지 확인한다. Pro/Max OAuth 토큰의 서버 측 차단은 2026년 4월 4일 전후 완료됐다 . 따라서 OAuth 경로는 더 이상 쓸 수 없고, API 키, Bedrock, Vertex가 동작하는 선택지다.
| 도구 | 재설정 경로 |
|---|---|
| OpenCode | env 파일에서 ANTHROPIC_AUTH_TOKEN(OAuth 값)을 ANTHROPIC_API_KEY로 바꾸고, 데몬을 재시작한 뒤 상태 표시줄을 확인한다. 'Subscription'에서 'API'로 바뀌어야 한다. |
| Cline (VS Code) | Settings를 열고 'Use Anthropic Account'를 비활성화한 다음 'Anthropic API'를 활성화하고 키를 붙여넣는다. Bedrock과 Vertex는 같은 패널에서 별도 제공자 옵션으로 표시된다. |
| RooCode (VS Code Cline fork) | 동일한 제공자 패널 흐름을 따른다. Roo 설정을 열고 provider switcher를 찾은 뒤 'Anthropic API'를 선택하고 키를 입력한다. |
OpenCode, Cline, RooCode는 2026년 1월 9일 서버 측 검사가 처음 적용됐을 때 영향을 받은 클라이언트에 포함됐다 . 따라서 각각 전환이 필요하다. 확인하려면 테스트 프롬프트를 보내고 60초 안에 console.anthropic.com 사용량 대시보드에 요금이 표시되는지 확인한다. 아무것도 나타나지 않으면 캐시된 OAuth 토큰이 아직 사용 중일 가능성이 높다. 명시적으로 지우고 재시작한 뒤 다시 시도하라.
요청 단위 과금으로 옮긴 뒤 피해야 할 실수
가장 비용이 큰 실수는 API 세션을 예전 Max 플랜처럼 다루는 것이다. 긴 에이전트 실행은 매 턴마다 전체 컨텍스트 창을 다시 보내므로, 입력 토큰이 조용히 쌓이고 정액 구독에서는 청구되지 않던 방식으로 비용의 대부분을 차지한다. 긴 세션에서는 /compact를 실행해 입력 수가 불어나기 전에 컨텍스트 팽창을 줄이고, 클라이언트가 제공한다면 에디터 설정에서 max_tokens 상한을 지정하라. 확정하기 전에 측정부터 해야 한다. ccusage (GitHub 스타 1.72만 개)는 Claude Code, Codex, OpenCode, Amp, Goose, Gemini CLI 전반의 세션별, 일별, 청구 기간별 내역을 제공한다. 새 방식으로 고정하기 전에 대표 워크로드에 대해 실행해 보라. 사용량 기준으로 Claude 토큰 과금이 부담스럽다면, OpenAI가 Cline, RooCode, OpenHands에 Codex 구독 접근을 확대했다는 점도 참고할 만하다 (GitHub 스타 약 8만 개). 보조금을 붙인 대응책에 가까우므로 나란히 테스트해 볼 가치가 있다.
재설정 후 살펴볼 것: 커뮤니티 확장 도구와 생태계 선택지
결제 경로가 안정되면 커뮤니티 레이어는 필수가 아니라 선택적으로 더해 볼 깊이로 다루는 것이 좋습니다. 표준 출발점은 hesreallyhim/awesome-claude-code(별 약 5만 개 )입니다. 스킬, 서브에이전트, MCP 서버, 상태 표시줄, 비용 모니터를 큐레이션한 목록입니다. 제공자 선택지를 넓히고 싶다면 Claude Code Router(musistudio, 별 35.8k개 )가 폴백 체인과 자격 증명 풀을 관리하는 로컬 컨트롤 플레인 역할을 합니다. 데스크톱 아티팩트나 npm install -g @musistudio/claude-code-router로 설치할 수 있습니다(게이트웨이는 127.0.0.1:3456, 관리 UI는 127.0.0.1:3458). 그리고 Superpowers는 2026년 1월 15일 Anthropic 공식 플러그인 마켓플레이스에 등록되었고 , 공식 CLI에서 /plugin install superpowers로 실행되므로 OAuth 차단의 영향을 전혀 받지 않습니다.
이들 중 무엇이든 본격적으로 쓰기 전에는 일회용 저장소에서 검증하고, 생성된 .claude/settings.json을 확인한 뒤, ccusage로 실제 비용 차이를 확인하세요. 확장은 한 번에 한 범주씩 신중하게 진행하고, 무엇을 남길지는 별 개수가 아니라 측정된 지출을 기준으로 판단하는 편이 좋습니다.
자주 묻는 질문
2026년 4월 이후에도 공식 Claude Code CLI에서 Pro 또는 Max 구독을 계속 사용할 수 있나요?
네. 공식 CLI(anthropics/claude-code)는 OAuth 차단의 영향을 받은 적이 없으며, 이전처럼 Pro 또는 Max 구독 용량을 계속 사용합니다. 2026년 1월 9일 적용된 서버 측 검사와 2026년 4월 4일 전후의 전면 차단은 구독 OAuth 토큰으로 인증하던 서드파티 도구만 대상으로 했습니다. 공식 CLI 사용자는 별도 재설정이 필요 없습니다.
2026년 4월 차단 이후에도 Cline이나 RooCode에서 Claude를 쓸 수 있나요?
네. 다만 구독 OAuth를 통해서는 사용할 수 없습니다. Cline과 RooCode는 Anthropic API 키(토큰 단위 과금)를 쓰거나 AWS Bedrock 또는 GCP Vertex를 경유해 Claude 모델에 계속 접근할 수 있습니다 . 직접 API 접근은 정상적으로 동작합니다. 제거된 것은 이 도구들이 Pro/Max 포함 용량을 쓰게 해 주던 지름길뿐입니다. 별도의 API 키를 생성해 설정해야 합니다.
Anthropic은 왜 서드파티 OAuth 접근을 차단했나요?
Claude Code 책임자인 Boris Cherny는 이 변경을 용량 우선순위 조정으로 설명했습니다. Pro와 Max 구독 용량은 공식 CLI용으로 마련된 것이지, OAuth 토큰을 통한 서드파티 사용을 위한 것이 아니라는 입장입니다 . 2026년 2월 19일 서비스 약관 업데이트에는 Free/Pro/Max OAuth 토큰을 서드파티 도구와 Agent SDK에서 사용하는 것을 명시적으로 금지하는 조항이 추가되었습니다. 2026년 4월 17일까지 사용할 수 있는 일회성 크레딧 외에는 환불이나 기존 사용자 예외 조항이 제공되지 않았습니다.
Cline과 RooCode에서 Anthropic API 과금보다 저렴한 대안이 있나요?
실용적인 선택지는 두 가지입니다. OpenAI는 맞대응으로 Codex 구독 접근을 Cline, RooCode, OpenHands까지 확대해, 해당 도구들에서 구독 모델을 유지할 수 있게 했습니다 . 또는 기존 클라우드 계약이 있는 팀은 협의된 요율로 AWS Bedrock이나 GCP Vertex를 통해 Claude를 라우팅할 수 있습니다. 어느 쪽이 더 저렴한지는 사용량과 이미 할인된 클라우드 계약을 보유하고 있는지에 따라 달라집니다.
OAuth 구독 과금과 API 키 과금의 실질적인 차이는 무엇인가요?
OAuth는 서드파티 도구가 Pro 또는 Max 포함 용량을 함께 쓰게 해 주었고, 프롬프트마다 추가 비용이 붙지 않았습니다. 사용자는 월 정액만 냈습니다. 반면 console.anthropic.com에서 관리되는 API 키 과금은 월 최소 비용 없이 토큰 단위로 청구됩니다. 이 차이는 무거운 에이전트 세션에서 중요합니다. 구독에서는 무료처럼 느껴졌던 작업이 종량제에서는 체감될 만큼 더 비싸질 수 있으므로, 워크플로에 정착하기 전에 실제 토큰 지출을 측정해야 합니다.
이 글이 도움이 되셨다면, 새 글이 올라올 때마다 이메일로 받아보세요.
