[FEATURE] Support Anthropic API key / setup-token OAuth authentication for Remote Control

Preflight Checklist

• [x] 기존 이슈를 검색했으며 동일한 요청이 없음을 확인함 (관련 이슈: #28795, #50642는 AWS Bedrock 중심)
• [x] 단일 feature request 임

Problem Statement

Current Behavior

Remote Control 세션은 claude.ai 구독(Pro/Max/Team/Enterprise) OAuth로 로그인된 상태에서만 시작됩니다. 다음 인증 방식은 모두 거부됩니다:

1. Anthropic Console 직접 API key (ANTHROPIC_API_KEY, API Platform billing)
2. claude setup-token으로 발급한 장기 OAuth 토큰

• 공식 문서상 Pro/Max/Team/Enterprise 구독이 필요하지만, 토큰의 scope가 inference-only로 제한되어 있어 Remote Control 세션 레지스트리에 등록되지 않음

1. AWS Bedrock / GCP Vertex / Azure Foundry (별건 #28795, #50642에서 추적 중)

즉, API Platform을 통해 정당하게 과금 중인 사용자도, 비대화형 환경용 장기 토큰을 발급한 사용자도 Remote Control을 사용할 수 없습니다.

Reproduction

# Case 1 — 직접 API key
export ANTHROPIC_API_KEY=sk-ant-...
claude remote-control
# → "You must be logged in to use Remote Control. Remote Control is only
#    available with claude.ai subscriptions."

# Case 2 — setup-token OAuth
unset ANTHROPIC_API_KEY
claude setup-token                  # Pro/Max 계정에서 발급
export CLAUDE_CODE_OAUTH_TOKEN=...
claude remote-control
# → 동일한 거부 메시지 (inference-only scope로 판단)

Who Is Affected

• API Platform 단독 사용자: Claude Console 결제로만 Claude Code를 쓰는 개발자/팀. 구독을 별도로 붙이기 어렵거나 불필요한 경우
• CI/서버/헤드리스 환경 사용자: setup-token으로 장기 OAuth 토큰을 쓰는 원격 세션. 아이러니하게도 Remote Control이 가장 필요한 유스케이스
• 엔터프라이즈 SSO 계정: claude.ai 개인 구독을 만들 수 없는 보안 정책하에 있는 조직
• 다중 프로바이더 혼용 사용자: Bedrock/Vertex와 API key를 전환하며 쓰는 사용자

Proposed Solution

다음 중 하나 이상을 요청합니다.

A. API key / setup-token OAuth를 Remote Control 인증 백엔드로 지원

• Remote Control 세션 등록 시 Anthropic Console API key 또는 inference-only OAuth 토큰도 허용
• 세션 ID는 Console 조직/사용자 ID에 바인딩
• 청구는 기존 API Platform billing 경로 사용

B. 명시적 제약 문서화 + 친절한 에러 메시지

즉시 (A)가 어렵다면, 최소한:

1. Authentication 문서와 Remote Control 문서에 지원되지 않는 인증 조합 표를 추가
2. claude remote-control 거부 시 어떤 인증 방식이 현재 붙어 있는지 / 어떤 인증 방식이 필요한지를 구체적으로 출력

• 현재: "Remote Control is only available with claude.ai subscriptions."
• 개선 예시: "Remote Control requires a Claude.ai subscription OAuth session (Pro/Max/Team/Enterprise). Detected auth: ANTHROPIC_API_KEY (API Platform). Run \unset ANTHROPIC_API_KEY && /login\ to switch."

1. setup-token OAuth 토큰이 Remote Control에 쓰일 수 없다는 점을 claude setup-token --help와 문서에 명시

Alternative Solutions

| 대안 | 한계 |
|---|---|
| claude.ai 개인 구독 추가 생성 | 이중 결제, 기업 보안 정책 위반 가능성, API 기반 자동화 환경과 신원 불일치 |
| tmux + SSH로 원격 접근 | 모바일 UX 부재, always-on 연결 요구, Remote Control UI 대체 불가 |
| --print 헤드리스 모드 | 대화형 모니터링 불가 |

Related Issues

• #28795 — Bedrock + AWS SSO 지원 (인접)
• #50642 — Bedrock 인증 지원 (인접, (and API keys) 간단 언급)
• 본 이슈는 Anthropic API Platform 직접 API key 및 setup-token OAuth 케이스에 한정하여 별도 추적합니다.

Additional Context

• Claude Code version: 최신 (2.1.x)
• 기능 공개 시점: Remote Control은 2026-02 research preview로 공개
• 본 이슈의 인증 제약은 공식 문서에서는 간접적으로만 드러나며, 실제로는 "Remote Control is only available with claude.ai subscriptions" 에러를 보기 전까지 사용자가 알기 어려움