CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

anyclaude is a proxy wrapper for Claude Code that enables using alternative LLM providers (OpenAI, Google, xAI, Azure) through the Anthropic API format. It intercepts Anthropic API calls and translates them to/from the Vercel AI SDK format for the specified provider.

Architecture

The proxy works by:

Spawning a local HTTP server that mimics the Anthropic API
Intercepting /v1/messages requests containing <provider>/<model> format
Converting Anthropic message format to AI SDK format
Routing to the appropriate provider (OpenAI, Google, xAI, Azure)
Converting responses back to Anthropic format
Setting ANTHROPIC_BASE_URL to point Claude Code at the proxy

Key components:

src/main.ts: Entry point that sets up providers and spawns Claude with proxy
src/anthropic-proxy.ts: HTTP server that handles request/response translation
src/convert-anthropic-messages.ts: Bidirectional message format conversion
src/convert-to-anthropic-stream.ts: Stream response conversion
src/json-schema.ts: Schema adaptation for different providers

Development Commands

# Install dependencies
bun install

# Build the project (creates dist/main.js with shebang)
bun run build

# Run the built binary
bun run ./dist/main.js

# The build command:
# 1. Compiles TypeScript to CommonJS for Node.js compatibility
# 2. Adds Node shebang for CLI execution

Testing

Test the proxy manually:

# Run in proxy-only mode to get the URL
PROXY_ONLY=true bun run src/main.ts

# Test with a provider
OPENAI_API_KEY=your-key bun run src/main.ts --model openai/gpt-5-mini

Environment Variables

Required for each provider:

OPENAI_API_KEY + optional OPENAI_API_URL for OpenAI/OpenRouter
GOOGLE_API_KEY + optional GOOGLE_API_URL for Google
XAI_API_KEY + optional XAI_API_URL for xAI
AZURE_API_KEY + optional AZURE_API_URL for Azure
ANTHROPIC_API_KEY + optional ANTHROPIC_API_URL for Anthropic passthrough

Special modes:

PROXY_ONLY=true: Run proxy server without spawning Claude Code
ANYCLAUDE_DEBUG=1|2: Enable debug logging (1=basic, 2=verbose)
OpenAI's gpt-5 was released in August 2025

2.3 KiB Raw Permalink Blame History