clodxy 0.1.2

Claude Code to OpenAI-compatible API proxy

clodxy

A simple custom proxy for Claude Code -> Any (OpenAI-compatible) Backend.

Supports the bare minimum necessary (messages, streaming, tools, vision).

Security Warning

NEVER expose this proxy to the public internet. This proxy is designed for local-only use and has no authentication or authorization mechanisms. The moment you bind this to a public-facing interface, you're inviting anyone on the internet to use your API keys and backend credentials. That's a skill issue waiting to happen. Keep it local.

Requirements

• Python 3.12+
• Claude Code CLI must be installed
• uv (for running from source)

Installation

Clone and run with uv:

git clone https://github.com/lyssieth/clodxy.git
cd clodxy
./clodxy.sh

Or install via pip/uv:

pip install clodxy

Configuration

Create a config file at ~/.config/clodxy/config.json (or set CLODXY_CONFIG to customize the path).

See config.example.json for reference:

{
  "backends": {
    "openai": {
      "api_base": "https://api.openai.com/v1",
      "api_key": "sk-your-api-key-here",
      "models": {
        "gpt-4o": {
          "context_size": 128000,
          "reasoning": false,
          "vision": true
        }
      }
    }
  },
  "default": {
    "backend": "openai",
    "model": "gpt-4o"
  }
}

Usage

Run clodxy - it will start the proxy and launch Claude Code:

clodxy
clodxy /path/to/project

CLI Options

clodxy --help              # Show help
clodxy --version           # Show version
clodxy --list              # List available backends and models
clodxy --validate-config   # Validate configuration
clodxy --port 9000         # Custom port (default: auto-assign)
clodxy --host 0.0.0.0      # Custom host

Passthrough

Use -- to separate clodxy options from claude options:

clodxy --port 9000 -- --prompt "help me debug"

Logs

Logs are written to ~/.cache/clodxy/:

• clodxy.log - Application logs
• uvicorn.log - Server logs