feat(cli): Claude Code 구독 OAuth 지원 (--use-claude-code-auth)

[4entrepreneur]

변경 요약

openclone chat <slug> --use-claude-code-auth 한 줄로 Claude Pro/Max 구독자가 별도 Anthropic API 키 없이 standalone CLI 를 쓸 수 있게 했습니다. macOS 키체인 항목 Claude Code-credentials 또는 ~/.claude/.credentials.json 의 OAuth 토큰을 그대로 재사용하고, 만료 임박 시 console.anthropic.com 으로 자동 갱신해 같은 위치에 다시 씁니다. 별도 OAuth wrapper 패키지 없이 @ai-sdk/anthropic 의 authToken/headers/fetch first-class 옵션 위에 얇은 셰임만 추가했습니다. --use-claude-auth alias 와 OPENCLONE_USE_CLAUDE_CODE_AUTH=1 env 도 함께 지원.

핵심 invariant: 커스텀 fetch 가 User-Agent 를 claude-cli/2.1.87 (external, cli) 로 강제 덮어쓰고, anthropic-beta 를 oauth-2025-04-20,interleaved-thinking-2025-05-14 로 완전 교체하며 (SDK 가 자동 추가하는 structured-outputs-* 등은 strip), system 을 두 블록 [{identity}, {persona}] 로 분리하고, /v1/messages 에 ?beta=true 를 붙입니다 — 이 네 가지 중 하나라도 빠지면 Anthropic 이 generic 429 rate_limit_error 로 차단합니다 (계정 cap 무관).

변경 유형

• 새 레퍼런스 (references/*.md) — skills/openclone-cli/references/claude-code-oauth.md
• 문서 (README·CONTRIBUTING·docs·등) — README.md, CLAUDE.md, skills/openclone-cli/SKILL.md
• 그 외: standalone CLI 의 provider 경로 추가 (src/cli/, src/lib/)

테스트 방법

npm install && npm run build && npm test     # 101/101 통과
node dist/cli/index.js chat douglas --use-claude-code-auth --prompt "1+1?"
node dist/cli/index.js chat douglas --use-claude-auth --model claude-opus-4-7   # alias + 모델 변경
OPENCLONE_DEBUG_HTTP=1 node dist/cli/index.js chat douglas --use-claude-code-auth --prompt "test" 2>&1 | head -40

라이브 검증: 200 응답 + 페르소나 voice 유지된 답변 (파랑.). 응답 헤더에서 anthropic-ratelimit-unified-{5h,7d}-status: allowed (utilization 0.34/0.22) — 계정 cap 과 무관하게 OAuth 검증 통과 확인.

--use-claude-code-auth 명시 안 하면 Claude 자격증명을 절대 읽지 않음 (가드 테스트 포함). macOS 첫 실행 시 키체인 권한 다이얼로그가 1회 뜨는 건 정상.

체크리스트

• 추가·수정한 텍스트에 이모지가 포함되지 않았음을 확인
• 내장 클론(clones/)을 수정하지 않았음을 확인
• CI(.github/workflows/validate.yml) — 로컬에서 typecheck + 101/101 tests + smoke-hook + markdownlint 통과
• 관련 문서(README/CLAUDE.md/skills 레퍼런스) 갱신

🤖 Generated with Claude Code

[vkehfdl1]

Thanks for the contribution! 🙏

This repository's automation only reviews pull requests that target the dev branch (this PR currently targets main). Please change the base branch to dev so dani can pick it up for automated review.

GitHub UI → click "Edit" next to the PR title → change the base branch to dev, then push (or reopen) the PR.