API Usage

Overview

The CCProxy API is a reverse proxy to api.anthropic.com that provides both Anthropic and OpenAI-compatible interfaces. It offers two main access modes:

Access Modes

Mode	URL Prefix	Method	Use Case
Claude Code	/ or /cc/	Uses claude-code-sdk	Access to all Claude Code tools
API	/api/	Direct proxy with headers	Full API control and settings

Anthropic API Format

Base URLs by Mode

Claude SDK Mode: http://localhost:8000/claude/sdk/v1/
Claude API Mode: http://localhost:8000/claude/v1/

Messages Endpoint

# Claude SDK mode - with all tools
curl -X POST http://localhost:8000/claude/sdk/v1/messages \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1000,
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

# Claude API mode - direct proxy for full control
curl -X POST http://localhost:8000/claude/v1/messages \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1000,
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

OpenAI API Format

Base URLs by Mode

Claude SDK Mode: http://localhost:8000/claude/sdk/v1/
Claude API Mode: http://localhost:8000/claude/v1/
Codex (OpenAI):  http://localhost:8000/codex/v1/
Copilot (GitHub): http://localhost:8000/copilot/v1/

Chat Completions

# Claude SDK mode - with all tools
curl -X POST http://localhost:8000/claude/sdk/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

# Claude API mode - direct proxy for full control
curl -X POST http://localhost:8000/claude/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

### Codex (OpenAI) Examples

```bash
# OpenAI Chat Completions via Codex
curl -X POST http://localhost:8000/codex/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [
      {"role": "user", "content": "Hello from Codex!"}
    ]
  }'

# OpenAI Responses API via Codex
curl -X POST http://localhost:8000/codex/v1/responses \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "input": [
      {"role": "user", "content": [{"type": "text", "text": "Hello!"}]}
    ]
  }'

# OpenAI Chat Completions via Copilot
curl -X POST http://localhost:8000/copilot/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4-copilot",
    "messages": [
      {"role": "user", "content": "Hello from Copilot!"}
    ]
  }'

# OpenAI Responses API via Copilot
curl -X POST http://localhost:8000/copilot/v1/responses \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4-copilot",
    "input": [
      {"role": "user", "content": [{"type": "text", "text": "Hello!"}]}
    ]
  }'

```

Supported Models

• claude-3-5-sonnet-20241022
• claude-3-5-haiku-20241022
• claude-3-opus-20240229
• claude-3-sonnet-20240229
• claude-3-haiku-20240307

Function Calling and Tools

Claude Code Mode Limitations

When using Claude Code mode (default), the proxy uses the claude-code-sdk which has these limitations: - Cannot directly use ToolCall/function calling through the API - Limited control over model settings - However, you get access to all tools configured in Claude Code

API Mode Advantages

When using API mode (/api/*), you get: - Full access to all API features including ToolCall - Complete control over model settings - Direct pass-through to api.anthropic.com

MCP Integration

You can extend Claude's capabilities using MCP (Model Context Protocol) servers in Claude Code mode.

For detailed information on setting up and using MCP servers with Claude Code, see the MCP Server Integration guide.