Claude Code 구독, OpenClaw·Hermes에서 다시 사용할 수 있을까?


2026년 초, Anthropic이 Claude Code의 인증 방식을 변경하면서 Claude Pro/Max 구독을 OpenClaw나 Hermes 같은 서드파티 도구에서 사용하는 것이 차단되는 일이 있었습니다.

당시에는 Claude Code의 OAuth 인증 정보를 가져와 다른 프로그램에서 Anthropic API를 호출하면 다음과 같은 형태의 오류가 발생했습니다.

This credential is only authorized for use with Claude Code and cannot be used for other API requests.

즉, 당시에는 사실상 다음과 같은 구조였습니다.

Claude Pro / Max
       │
       ▼
 Claude Code
       │
       ├── Claude Code → 사용 가능
       │
       └── OpenClaw / Hermes → 차단

그렇다면 현재는 어떨까요?

결론부터 말하면 상황이 다시 변경됐습니다.

다만 "이제 모든 서드파티 프로그램에서 Claude 구독을 자유롭게 사용할 수 있다"라고 이해하면 정확하지 않습니다.


1. Anthropic의 정책이 다시 변경됐다

Anthropic은 당초 2026년 중반부터 Claude Agent SDK 등의 사용에 별도의 과금 체계를 적용하려고 했습니다.

예를 들어 Claude Pro/Max 사용자가 Agent SDK 기반 프로그램을 사용하면 별도의 Agent SDK 사용량을 적용하는 방향이었습니다.

하지만 Anthropic은 2026년 6월 15일 이 변경을 일단 중단했습니다.

현재 Anthropic 공식 문서에서는 다음과 같은 사용 방식이 Claude 구독의 사용량 한도를 이용한다고 안내하고 있습니다.

  • Claude Code
  • claude -p
  • Claude Agent SDK
  • 일부 서드파티 애플리케이션

따라서 현재는 다시 다음과 같은 구조가 가능합니다.

Claude Pro / Max
       │
       ├── Claude Code
       │
       ├── claude -p
       │
       ├── Agent SDK
       │
       └── 일부 Third-party App
                │
                ▼
         Claude 구독 사용량

중요한 것은 서드파티 프로그램이 Claude에 어떤 방식으로 연결하느냐입니다.


2. "서드파티 사용 가능"과 "OAuth 토큰 직접 사용 가능"은 다르다

여기서 가장 많이 혼동하는 부분입니다.

Anthropic이 현재 Agent SDK나 claude -p 등의 사용을 허용한다고 해서,

Claude Code OAuth 토큰을 아무 프로그램이나 가져다가 Anthropic API에 직접 전달해도 된다.

는 의미는 아닙니다.

현재는 대략 다음과 같이 구분해서 보는 것이 좋습니다.

사용 방법 현재 상황 Claude 구독 사용
Claude Code 직접 사용 가능 가능
claude -p 가능 가능
Claude Agent SDK 가능 가능
Agent SDK 기반 서드파티 앱 가능 가능
OpenClaw → claude -p 가능 가능
OpenClaw → OAuth 토큰으로 API 직접 호출 주의 필요 불안정 가능
Hermes → Anthropic OAuth 직접 연결 주의 필요 오류 사례 존재
Anthropic API Key 사용 가능 별도 API 과금

따라서 단순히 "Anthropic이 다시 허용했다"라고 표현하기보다는,

"공식 Claude Code 실행 경로와 Agent SDK를 통한 사용은 다시 구독 사용량에 포함되지만, OAuth 인증 정보를 서드파티가 직접 이용하는 방식은 여전히 별개의 문제다."

라고 이해하는 것이 정확합니다.


3. OpenClaw는 현재 상당히 유리한 구조다

현재 OpenClaw의 Claude 연동 방식에서 중요한 부분은 claude -p 경로를 사용할 수 있다는 것입니다.

구조를 단순화하면 다음과 같습니다.

OpenClaw
   │
   ▼
claude -p
   │
   ▼
Claude Code CLI
   │
   ▼
Anthropic
   │
   ▼
Claude Pro / Max 구독

이 방식이라면 OpenClaw가 Claude Code의 인증 정보를 직접 가져다가 Anthropic API를 호출하는 것이 아니라, 공식 Claude Code CLI를 통해 Claude를 사용하는 구조가 됩니다.

따라서 현재 Anthropic이 허용하고 있는 사용 방식과 훨씬 잘 맞습니다.

OpenClaw를 Claude Max와 함께 사용한다면 현재 기준으로는 이 방식이 가장 합리적입니다.


4. Hermes는 조금 더 주의해야 한다

Hermes는 상황이 조금 다릅니다.

Hermes는 Claude Code의 credential을 인식하고 Anthropic과 연결할 수 있는 기능을 제공합니다.

문제는 Hermes가 해당 인증 정보를 이용해 Anthropic API를 직접 호출하는 경우입니다.

2026년에도 Hermes에서 Claude Code OAuth 인증을 사용했을 때 다음과 같은 문제가 발생했다는 사례들이 보고되고 있습니다.

  • 429 오류
  • 400 오류
  • third-party 사용으로 인식되는 문제
  • subscription usage가 아닌 extra usage로 분류되는 문제

즉,

Claude Max
   │
   ▼
Claude Code OAuth
   │
   ├── Claude Code → 정상
   │
   └── Hermes Anthropic adapter
             │
             └── 오류 가능

같은 상황이 발생할 수 있습니다.

따라서 Hermes에서 Claude Max를 사용한다고 해서 무조건 Claude Max의 구독 사용량으로 처리된다고 단정하면 안 됩니다.


5. 현재 가장 안전한 구성

Claude Max를 가지고 OpenClaw와 Hermes를 함께 사용한다면 다음과 같은 구성이 가장 깔끔합니다.

Claude Pro / Max
                          │
                          ▼
                   Claude Code CLI
                    ┌─────┴─────┐
                    │           │
              Claude Code    claude -p
                                │
                                ▼
                             OpenClaw

그리고 Hermes는 여러 LLM을 역할에 따라 분리하는 방법이 좋습니다.

Hermes
 │
 ├── OpenAI
 │
 ├── Gemini
 │
 ├── GLM
 │
 ├── MiniMax
 │
 └── Claude
       │
       └── 가능하면 Claude Code CLI 경유

특히 Hermes에서 Claude를 사용할 때는 Claude Code OAuth token을 Hermes가 직접 Anthropic API에 전달하는 방식보다는 공식 Claude Code CLI를 이용하는 방식을 우선적으로 검토하는 것이 좋습니다.


6. Claude Max + OpenClaw 조합은 현재 상당히 매력적이다

현재 정책을 기준으로 보면 Claude Max를 단순히 Claude Code에서만 사용하는 것이 아니라,

Claude Code를 에이전트 실행 엔진처럼 활용하는 방법이 상당히 매력적입니다.

예를 들어:

Claude Max
     │
     ▼
Claude Code
     │
     ├── 직접 코딩
     │
     ├── claude -p
     │
     └── OpenClaw
             │
             ├── 파일 작업
             ├── Shell
             ├── Git
             ├── 자동화
             ├── 웹 작업
             └── Agent 작업

이렇게 구성하면 Claude Max 구독을 단순한 채팅 서비스가 아니라 개발 및 에이전트 작업을 위한 Claude 실행 환경으로 활용할 수 있습니다.


7. 그렇다면 2026년 1월의 차단은 완전히 없어진 것인가?

완전히 없어진 것으로 보는 것은 위험합니다.

정확히는 Anthropic이 정책을 다시 완화했지만,

"모든 서드파티 프로그램에서 Claude Code 인증을 직접 사용해도 된다"는 정책으로 돌아간 것은 아닙니다.

현재는 다음과 같이 이해하는 것이 가장 정확합니다.

2026년 초

Claude Code OAuth
       │
       ├── Claude Code → OK
       │
       └── 서드파티 직접 API 호출 → 차단

현재

Claude Pro / Max
       │
       ├── Claude Code → OK
       │
       ├── claude -p → OK
       │
       ├── Agent SDK → OK
       │
       └── 일부 Third-party App → OK

하지만,

Claude Code OAuth
       │
       ▼
서드파티가 직접 Anthropic API 호출
       │
       └── 여전히 문제 발생 가능

이라는 차이가 있습니다.


8. 결론

2026년 8월 현재 기준으로 보면 2026년 1월의 "Claude Code 구독을 서드파티에서 사용하는 것이 전부 차단됐다"는 상태는 아닙니다.

Anthropic은 이후 정책을 다시 변경했고, 현재는 Claude Code, claude -p, Agent SDK 및 일부 서드파티 앱에서 Claude Pro/Max의 구독 사용량을 사용할 수 있습니다.

다만 다음 두 가지를 구분해야 합니다.

첫 번째, 공식 Claude Code 실행 경로를 이용하는 경우

OpenClaw
   ↓
claude -p
   ↓
Claude Code
   ↓
Claude Max

현재 정책과 잘 맞습니다.

두 번째, 서드파티 프로그램이 Claude Code OAuth credential을 직접 가져와 Anthropic API를 호출하는 경우

Hermes
   ↓
Claude Code OAuth
   ↓
Anthropic API

여전히 오류나 사용량 분류 문제가 발생할 가능성이 있습니다.

따라서 현재 시점에서 Claude Max + OpenClaw 조합은 상당히 안정적인 선택으로 볼 수 있지만, Claude Max + Hermes의 native Anthropic OAuth 방식은 아직 주의가 필요합니다.

그리고 Anthropic은 앞으로 이 정책을 다시 변경할 가능성이 있기 때문에, Claude Max를 에이전트용으로 장기간 활용한다면 Claude Code CLI / claude -p를 중심으로 구성하는 것이 가장 안전한 방향입니다.


참고

Anthropic 공식 문서에서는 현재 Claude Agent SDK와 Claude 구독 사용량에 대한 정책을 확인할 수 있습니다.

  • Anthropic — Claude Agent SDK와 Pro/Max 구독 사용
  • Anthropic — Claude Code와 Pro/Max 요금제 사용
  • OpenClaw — Anthropic / Claude Code 연동
  • Hermes — Anthropic Provider 및 Claude Code 인증 관련 문서
  • Hermes / OpenClaw GitHub 이슈 — OAuth 및 third-party 사용 관련 실제 오류 사례

핵심만 한 문장으로 정리하면:

"Anthropic이 서드파티 사용을 다시 허용한 것은 맞지만, Claude Code OAuth를 서드파티가 직접 사용하는 것까지 전면 허용한 것은 아니다. 현재는 claude -p와 Agent SDK 같은 공식 실행 경로를 이용하는 방식이 가장 안전하다." 



댓글 쓰기 · 수정

0 댓글