TL;DR

Claude2api는 Go(Gin)로 구현된 로컬 프록시 서버로 claude.ai 웹 세션을 OpenAI/Anthropic 호환 API로 변환해주는 기능을 제공합니다. Bearer sessionKey와 전체 브라우저 Cookie를 모두 지원하고 accounts.txt 기반 다계정 풀, 계정별 TLS·Cookie 재사용, SSE 스트리밍 같은 운영 편의 기능을 갖추고 있어 기존 OpenAI/Anthropic 클라이언트를 Claude에 연결하려는 환경에 적합합니다. 사용 조건으로는 유효한 claude.ai 브라우저 세션이 반드시 필요하며 upstream 속도 제한(429)과 인증 정보 노출에 유의해야 합니다. Docker 이미지와 로컬 바이너리 실행 예제가 제공되어 빠른 배포와 테스트가 가능합니다.

핵심 포인트

• 이 레포지토리는 claude.ai 웹 세션을 OpenAI/Anthropic 호환 HTTP API로 래핑하는 독립 실행형 프록시 서버입니다. 구현 언어는 Go이며 Gin을 웹 프레임워크로 사용해 로컬에 /v1 기반 엔드포인트를 노출하고 클라이언트 요청을 claude.ai 웹 인터페이스로 전달합니다. 특정 에코시스템 플러그인이 아니라 바이너리와 Docker 이미지로 배포해 로컬 서비스로 운영할 수 있습니다.
• 인증은 Bearer sessionKey 모드와 전체 브라우저 Cookie 모드 두 가지를 지원하며 Bearer 모드에서는 서비스가 sessionKeyLC, anthropic-device-id, traceparent 등 일부 브라우저 환경값을 자동 생성합니다. accounts.txt 방식으로 다계정 풀을 구성할 수 있고 활성 요청 수 기준의 최소 부하 분배를 수행해 계정별 TLS client·CookieJar·브라우저 신원 정보를 재사용합니다. 동일 conversation_id에 대한 동시 요청은 직렬화해 세션 간섭을 방지하며 upstream 429 응답은 해당 계정의 속도 제한 발생을 의미합니다.
• 공개된 엔드포인트로는 OpenAI Chat Completions 호환 POST /v1/chat/completions, Anthropic Messages 호환 POST /v1/messages, OpenAI Responses 호환 POST /v1/responses, 그리고 GET /v1/models가 있으며 스트리밍은 SSE와 비스트리밍 JSON을 모두 지원합니다. /v1/models는 README에 열거된 claude-fable-5, claude-opus-4-8, claude-haiku-4-5, claude-opus-4-7, claude-opus-4-6, claude-opus-3, claude-sonnet-4-6, claude-sonnet-5 만큼만 반환하고 그 외 모델 요청은 invalid_request_error를 돌려줍니다. completion 요청에는 웹에서 역공학한 claude.ai의 tools 필드와 단계별 Referer, Datadog/RUM Cookie·trace headers 구조를 반영해 upstream 요청을 구성하고 usage 토큰 수는 출력 길이 기반의 근사치로 제공됩니다.
• 환경 요구는 Go 1.26.4 이상과 유효한 claude.ai 브라우저 세션이며 Docker·Docker Compose로도 배포가 가능합니다. GitHub Actions로 ghcr.io/aurora-develop/claude2api 이미지가 자동 빌드되어 있고 README에 로컬 빌드·실행, Docker pull/run, Docker Compose 예제가 포함되어 있습니다. Windows·Linux·macOS용 바이너리 빌드 명령과 sessionKey 또는 전체 Cookie를 환경변수로 넘기는 실행 예시가 제공되어 초기 테스트와 운영 배포를 빠르게 시작할 수 있습니다.