All your models.
One picker.
Use Claude, ChatGPT, Copilot and local models from the coding app you already use, on your Mac and from your phone.
Set up this MacThe gateway does
- Sign in to each account the official way
- Add its models to your app's picker
- Translate requests and stream answers back
Your app still does
- Run tools and ask for approvals
- Own chats, names and permissions
- Choose the model and agents
Each account keeps its own sign-in. A failed request never moves to another account or billing plan, and the gateway never logs tokens, request bodies or tool arguments.
Set up this Mac.
One Mac is the whole setup. It holds your accounts, runs the gateway and shows the models in your app. You need an Apple Silicon Mac, the Codex desktop app, and the official CLI for each subscription you connect, such as Claude Code for a Claude subscription.
- Installthe app or the command
- Connectyour accounts and models
- Startthe service, then reopen Codex
The easy way: the app
Download for Mac 2.1.4 · Apple silicon
Latest 2.1.4 What changed
Unzip it, move the fox to Applications and open it. The setup wizard walks through all three steps: choose a provider, sign in, pick models, then Set up once starts the background service and adds the models to Codex. The app is notarized and includes its own runtime. Every version is on GitHub Releases. See the macOS app.
The command-line way
Run these in a new, empty download folder. The installer needs no administrator access and installs under your user folder.
VERSION=2.1.4
gh release download "v$VERSION" -R edihasaj/gatefox \
--pattern 'gatefox-*-macos-arm64.tar.gz' --pattern SHA256SUMS
shasum -a 256 --ignore-missing -c SHA256SUMS
tar -xzf "gatefox-$VERSION-macos-arm64.tar.gz"
"./gatefox-$VERSION-macos-arm64/install"
gateway --version
Then connect accounts and start it. gateway init writes a private configuration that listens on 127.0.0.1 only, so nothing is reachable from other machines.
gateway init # 1. private config for this Mac
gateway login claude # 2. sign in to each account you want
gateway login codex # (a second ChatGPT account)
gateway discover claude --load # load the models each one offers
gateway discover codex --load
gateway service install # 3. keep it running in the background
gateway desktop register # add the models to Codex
gateway doctor # check everything
Quit Codex normally once and reopen it. That's it: the new models appear after your native ones.
Adding Copilot, an API key or a local model server
Copilot uses its CLI's subscription login. API services (OpenRouter, xAI, OpenCode and compatible endpoints) and local servers such as vLLM use a key or a URL. The app's Add connection wizard covers each; on the command line see API providers.
gateway login copilot
gateway discover copilot --load
gateway doctorAlready using a development checkout?
Import its gateway-owned registrations into the installed data directory. Native Codex authentication and settings are not copied.
gateway setup --from-config /absolute/path/gateway.local.jsonUse it in the ChatGPT app (Codex).
Codex lives in the ChatGPT app for Mac. After setup, its model picker lists your GateFox models after the native ones.
- Start a new chat and select the project where the work belongs.
- Open the model list. Added models have labels such as Claude · Opus 5.5 and Codex 2 · GPT-6.1-Sol.
- Choose a reasoning level, then send your task.
| Control | Behavior |
|---|---|
| Files and instructions | Codex reads the project's AGENTS.md and runs tools in that workspace, as usual. |
| Switching models | History carries across gateway models. Start a new chat to move between your native account and a gateway model. |
| Images | Claude and Codex accept PNG, JPEG, GIF and WebP. Some local models accept text only. |
| Stop and resume | Stop cancels the request. Send another message or reopen the chat to continue. |
| From your phone | Codex in the ChatGPT app lists and continues your gateway chats while your Mac's native relay is connected. Claude's mobile app does not support custom gateways yet. |
| Speed | Standard is the default. Fast appears only where the account offers it. |
Use it in the Claude app.
The Claude app (Claude Desktop) can list every GateFox model too: your Claude accounts first, then Codex, local and API models. It talks to the gateway on this Mac; nothing else is installed.
- Once: in the Claude app, open Developer → Configure Third-Party Inference…, set the provider to Gateway and the base URL to
http://127.0.0.1:3457, name the configurationGateFoxand apply it. - Quit the Claude app (⌘Q), then run the command below.
- Open the Claude app. The account menu reads you · GateFox and the picker shows Claude · Opus 5.5, Codex · GPT-6.1-Sol and the rest.
gateway claude-desktop configure --direct --native-model-metadata --apply
Run it again after you add or remove models. To go back to another configuration, use the account menu → Inference configuration. Each run keeps a backup of the previous profile.
To run Claude app sessions on another Mac over SSH, see Other Macs. The Claude mobile app has no setting for a custom gateway; use Codex in the ChatGPT app on your phone instead.
More: the Claude app guide.
Load the models your account offers.
Discovery reads each account's current model list. --load saves it; --select keeps a smaller list.
gateway discover claude --load
gateway discover copilot --select gpt-6.1-sol,claude-opus-5.5 --load
gateway catalog
The provider's label is the name before the middle dot. Changes apply on the next request; reopen the model picker to see them. To follow new model releases automatically, see automatic latest models.
Use more than one Mac.
Skip this if you use one Mac. To use the same models on a laptop, keep the accounts on your first Mac and let the others connect to it. Each extra Mac gets only a client token and an SSH tunnel; no account credentials are copied.
On the extra Mac, install the gateway as in step 1, then:
umask 077
mkdir -p ~/.local/state/gatefox-client
ssh you@main-mac 'gateway token' \
> ~/.local/state/gatefox-client/client-token
gateway setup --client --port 3459 \
--token-file ~/.local/state/gatefox-client/client-token
gateway tunnel install --tunnel-id main --host you@main-mac \
--port 3459 --remote-port 3457
gateway desktop register
gateway doctor
The client token unlocks every account on the main Mac. Keep it owner-only and give it only to your own devices. The main Mac must stay awake and reachable.
Use an existing Codex “Control other devices” connection instead
The experimental native relay reuses that connection, so there is no separate SSH entry. Finish open chats and quit ChatGPT normally on that Mac first.
gateway native install
gateway desktop register
gateway native statusWork in a project on another Mac
Both apps can run a chat's files, terminal and tools on another Mac over SSH, while the chat stays on this one. Check that ssh that-mac works from a terminal first.
| Codex app | Claude app | |
|---|---|---|
| First, on both | ssh that-mac works without a password (key in ~/.ssh/config) | |
| On the other Mac | GateFox and the Codex CLI, then gateway ssh register --codex "$(command -v codex)" | Nothing |
| On this Mac | Nothing | Turn on "tailnetListener": true, then quit the Claude app and run gateway claude-desktop configure --direct --tailnet --ssh-host that-mac --ssh-host ITS-IP --apply |
| Add it in the app | Settings → SSH connections | New environment → SSH → Add SSH connection… |
| Needs | SSH | SSH and Tailscale, with HTTPS Certificates on |
Step by step, with a three-Mac example: other Macs, and Claude app SSH environments.
Use it beyond the Codex app.
gateway codex-config so your main settings stay untouched.
mkdir -p ~/.config/gatefox/clients/codex
gateway codex-config --model codex/gpt-6.1-sol \
> ~/.config/gatefox/clients/codex/config.toml
CODEX_HOME=~/.config/gatefox/clients/codex codex
Keep it running.
One background service starts the gateway at login and restarts it after a crash. Closing the app or the terminal leaves it running. New releases are picked up when the gateway is idle, without stopping your chats.
gateway service status
gateway health
gateway versions --check
Uninstalling moves the installed files to Trash and keeps your accounts and native Codex settings.
gateway uninstall
More: the service, health checks, diagnostics.
Find where it stopped.
Start with gateway doctor on the Mac that has the problem. It checks the configuration, accounts, service, tunnel and Codex registration in turn.
| Symptom | Next step |
|---|---|
| Added models are missing | Quit Codex normally once and reopen it. Then run gateway desktop status and gateway doctor. |
| “Model not supported with a ChatGPT account” | Start a new chat with the gateway model selected. An existing native chat cannot switch to it. |
Model provider gatefox (or subscription_gateway) not found | Run gateway desktop register on the Mac that owns the chat's project, then reopen the chat. It registers both of the gateway's ids. |
| An extra Mac sees no models | Check that the main Mac is awake, then run gateway doctor on the extra Mac to test the tunnel. |
| The Claude app shows no GateFox models | Quit the Claude app with ⌘Q and run gateway claude-desktop configure --direct --apply again; it refuses to write while the app is open. |
| Claude app: “Some saved settings can't be used as written: inferenceGatewayBaseUrl” | Choose Cancel, not Save. Quit the app, update GateFox and run the configure command again; the app accepts http:// only on this Mac. |
| Claude app: “SSH host … is not allowed by your organization's managed settings” | Add that address with another --ssh-host in the configure command. The app checks the address the SSH alias resolves to. |
| An answer stops early | Check gateway service status. Keep the chat and logs; the gateway does not retry on another account. |
When asking for help, share versions, timestamps and error messages. Never share client tokens, account tokens or request bodies.
Everything else is in All docs, a searchable list of every topic with when to read it. Want to help, including with Linux and Windows? See the roadmap.