OpenAI Codex Claude Code Proxy — Development skill for Claude Code

OpenAI Codex Claude Code Proxy


Run Claude Code with GPT models through [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI).

This project provides two small launchers:

• ./claudex-oai routes Claude Code to GPT-5.6 Sol through an OpenAI/Codex subscription authenticated with OAuth.
• ./claudex routes Claude Code to GPT-5.6 Sol on Azure OpenAI.

Both launchers enable effort mode, defer tool loading, start the local proxy automatically, and keep provider credentials out of Claude Code.

How it works

Claude Code sends requests using Anthropic's Messages API. CLIProxyAPI exposes an Anthropic-compatible localhost endpoint and translates those requests to the OpenAI Responses API.

Claude Code -> localhost:8317 -> CLIProxyAPI -> Codex OAuth or Azure OpenAI

Azure and OpenAI subscription models use separate names so they cannot route to the wrong billing source:

• gpt-5.6-sol -> OpenAI/Codex OAuth
• azure-gpt-5.6-sol -> Azure OpenAI

Requirements

• macOS or Linux
• Claude Code
• CLIProxyAPI
• Python 3
• One or both of:
  • An OpenAI/Codex subscription supported by CLIProxyAPI OAuth
  • An Azure OpenAI endpoint, API key, and GPT deployment

The automatic background service uses `launchd` on macOS and `nohup` on Linux.

Install

On macOS:

brew install cliproxyapi
git clone https://github.com/MikeChongCan/OpenAI-Codex-Claude-Code-Proxy.git
cd OpenAI-Codex-Claude-Code-Proxy
cp .env.example .env

Generate a local proxy token:

openssl rand -hex 32

Put that value in `CLIPROXY_LOCAL_TOKEN` inside `.env`. This token protects the local proxy and must not be the same as a provider API key.

OpenAI/Codex subscription setup

Render the proxy configuration once, then authenticate CLIProxyAPI with OpenAI/Codex OAuth:

./start-cliproxy.sh

Stop