clodxy 0.1.0

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).

Requirements

• Python 3.12+
• Claude Code CLI must be installed

Installation

uvx pip install clodxy

Or clone and run with uv:

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

Configuration

Create a config file at ~/.config/clodxy/config.json. 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 with any arguments forwarded to the Claude CLI:

clodxy
clodxy --help
clodxy /path/to/project

The proxy starts on http://127.0.0.1:8000 and automatically configures the environment for Claude Code.