for those who speak one tongue but hear another
There exists a bridge. A translator between worlds. When one oracle falls silent, another may speak in its place.
This is that bridge.
Copy this incantation. Execute it in your terminal.
#!/bin/bash
set -e
INSTALL_DIR="$HOME/.claude-gpt"
PROXY_DIR="$INSTALL_DIR/proxy"
# install uv if needed
command -v uv >/dev/null || curl -LsSf https://astral.sh/uv/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
# clone the proxy
rm -rf "$PROXY_DIR"
mkdir -p "$INSTALL_DIR"
git clone --quiet https://github.com/1rgs/claude-code-proxy.git "$PROXY_DIR"
# install dependencies
cd "$PROXY_DIR"
uv sync --quiet
# write the wrapper script
mkdir -p ~/bin
cat > ~/bin/claude-gpt << 'WRAPPER'
#!/bin/bash
export PATH="$HOME/.local/bin:$PATH"
PROXY_DIR="$HOME/.claude-gpt/proxy"
[ -z "$OPENAI_API_KEY" ] && { echo "set OPENAI_API_KEY"; exit 1; }
# models (override with BIG_MODEL / SMALL_MODEL)
export BIG_MODEL="${BIG_MODEL:-gpt-4.1}"
export SMALL_MODEL="${SMALL_MODEL:-gpt-4.1-mini}"
# start proxy on random port
PORT=$(uv run python -c "import socket;s=socket.socket();s.bind(('',0));print(s.getsockname()[1]);s.close()")
cd "$PROXY_DIR"
uv run uvicorn server:app --port $PORT &>/dev/null &
PID=$!; trap "kill $PID 2>/dev/null" EXIT
sleep 1
# run claude through the proxy
ANTHROPIC_BASE_URL="http://localhost:$PORT" ANTHROPIC_API_KEY="x" claude "$@"
WRAPPER
chmod +x ~/bin/claude-gpt
echo "done. add ~/bin to PATH."
the artifact manifests in ~/bin/claude-gpt
You will need a key. You know where to find it.
export OPENAI_API_KEY=sk-...
bind it to your shell's memory
Ensure the bridge is reachable.
export PATH="$HOME/bin:$PATH"
add to .bashrc or .zshrc to persist
And then, simply:
claude-gpt
override by setting BIG_MODEL and SMALL_MODEL
| vessel | nature |
|---|---|
| gpt-4.1 | default oracle |
| gpt-4.1-mini | swift messenger |
| gpt-5.2 | the full oracle |
| gpt-5.1-codex | the architect |
BIG_MODEL=gpt-5.2 claude-gpt
A proxy awakens on a random port. What enters as one protocol, exits as another. The translation is seamless. The tool remains familiar.
when you depart, the bridge dissolves
if the oracle stalls, whisper "continue" and wait