Temporary fork: Based on v0.1.43 with upstream PR #122 for successful silent completion after tool results. This fork also handles trailing hook system messages and system-reminder blocks, excludes failed-tool batches and new user text, and resets the consecutive-empty counter on errors. Completed task notifications and framed final subagent reports also allow silent completion, including an adjacent harness interruption marker. Failed tasks, interruption markers alone, and extra user text remain excluded. Empty completions retry once before acceptance; missing or failed terminal events retain their error handling. Regression tests live in the Codex adapter. Return to upstream once an equivalent fix is released and verified.

Claude Code, powered by OpenAI Codex, Kimi, Grok, OpenCode Go, or Cursor Agent.

Docs: https://claude-code-proxy.raine.dev

LLM docs: https://claude-code-proxy.raine.dev/llms.txt

Claude Code remains an excellent coding harness, with strong tools, skills, hooks, subagents, and editor integrations. claude-code-proxy keeps that client experience while translating its Anthropic API traffic for subscription-backed provider services.

One local process handles provider authentication, model-based routing, protocol translation, streaming responses, and diagnostics. The built-in monitor shows sessions, active and recent requests, errors, token usage, and throughput.

Install on macOS or Linux:

brew install raine/claude-code-proxy/claude-code-proxy

Or use the release installer:

curl -fsSL https://raw.githubusercontent.com/raine/claude-code-proxy/main/scripts/install.sh | bash

Windows and other prebuilt artifacts are available from GitHub Releases.

Sign in with a ChatGPT Plus or Pro account, not an OpenAI API account:

claude-code-proxy codex auth login

Start the proxy in one terminal:

claude-code-proxy serve

For a background service, use claude-code-proxy serve --no-monitor and attach from another terminal with claude-code-proxy monitor. Closing an attached dashboard leaves the proxy running.

Start Claude Code in another:

ANTHROPIC_BASE_URL=http://127.0.0.1:18765 \
ANTHROPIC_AUTH_TOKEN=unused \
ANTHROPIC_MODEL=gpt-6-sol[1m] \
ANTHROPIC_SMALL_FAST_MODEL=gpt-6-luna[1m] \
CLAUDE_CODE_AUTO_COMPACT_WINDOW=272000 \
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 \
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1 \
  claude

See Getting started for the complete first session.

Optional Codex image generation and editing can reuse the same ChatGPT login:

CCP_CODEX_IMAGES_API=1 claude-code-proxy serve
curl http://127.0.0.1:18765/v1/images/generations \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"A paper-cut fox","model":"gpt-image-2"}'

The opt-in Images API returns base64 image data and consumes the signed-in account's image quota. Image prompts and payloads are excluded from traffic captures. See the HTTP API for generation and edit schemas.

Run claude-code-proxy models for the current catalog or claude-code-proxy models --full for every dynamic Cursor alias.

• What is claude-code-proxy?
• Choosing a provider
• Configure Claude Code
• Models and routing
• Monitor TUI
• Troubleshooting
• Command reference
• Configuration
• HTTP API
• Compatibility and limitations
• For coding agents

• aven: local-first task management for power users and agents
• claude-history: search Claude Code conversation history from the terminal
• git-surgeon: non-interactive hunk-level git staging for coding agents
• workmux: parallel coding tasks in git worktrees and tmux
• consult-llm: consult other AI models from an agent workflow

MIT