What do you want to do?
4 use cases
-
Point Claude Code at your own OpenAI-compatible gateway
Write the gateway URL, key, and model into Claude Code settings without losing existing config.
- Setup Gateway
- Claude Code
- Software and DevOps
- Intermediate
View prompt
Work in the cloned repo Sinholms/setup-gateway. Run `node bin/setup-gateway.mjs claude --base-url <GATEWAY_BASE_URL> --api-key <API_KEY> --model <MODEL_ID> --yes` and report the written file path. Then run `node setup-gateway.mjs status` and verify the printed base URL and model match the values passed in.
-
Set up Codex CLI with gateway models in the /model picker
Configure Codex CLI to use a Responses API gateway and list extra gateway models in /model.
- Setup Gateway
- Codex
- Software and DevOps
- Intermediate
View prompt
In the repo Sinholms/setup-gateway, run `node bin/setup-gateway.mjs codex --base-url <GATEWAY_BASE_URL> --api-key <API_KEY> --model <MODEL_ID> --yes`. Expect config.toml and gateway-catalog.json to be written in the Codex config directory. Verify that config.toml sets wire_api to responses and that model_catalog_json points to an existing gateway-catalog.json.
-
Restore the last working config after a bad gateway change
Bring back the most recent backup of Claude Code, OpenCode, or Codex config with one command.
- Setup Gateway
- Software and DevOps
- Beginner
View prompt
In the repo Sinholms/setup-gateway, run `node setup-gateway.mjs restore <TOOL>` where <TOOL> is claude, opencode, or codex, adding --yes for the newest backup. Expect a message that the config was restored and that a backup of the previous state was made first. Verify by running `node setup-gateway.mjs status` and confirming the values match the backup.
-
Run the built-in selftest in CI before publishing a release
Check the Setup Gateway pure functions in CI without touching real config files.
- Setup Gateway
- Software and DevOps
- Intermediate
View prompt
In the repo Sinholms/setup-gateway, run `node setup-gateway.mjs --selftest` and report the number of assertions and the exit code. Expect exit code 0 with no real config files changed. Verify that the exit code is 0 before approving any release step.
How to use Setup Gateway
- Check you have what it needs: Node.js 18 or newer installed; A gateway base URL that exposes /v1 and an API key for it; A model id the gateway serves, or access to GET /v1/models so the picker can list them.
- Open Sinholms/setup-gateway on GitHub and read the README and license.
- Clone the repo and run
node bin/setup-gateway.mjs claudein a terminal to start the interactive setup. - Enter the Base URL, the API key, and pick a model from the list that appears.
- Restart Claude Code so the new env values are read.
- Run
node setup-gateway.mjs statusto confirm the base URL and model (the key is shown masked).
These steps come from our top use case, Point Claude Code at your own OpenAI-compatible gateway, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeSetup Gateway alternatives · Best AI repos for Software and DevOps
About this repo
- Who it is forDevelopers and platform engineers who run Claude Code, OpenCode, or Codex CLI against a company proxy, LiteLLM, OpenRouter, or a local gateway and need repeatable setup.
- Why it is hot
- LanguageJavaScript
- Sourcegithub.com/Sinholms/setup-gateway · Back to Hot repos
Requirements
- Node.js 18 or newer installed
- A gateway base URL that exposes /v1 and an API key for it
- A model id the gateway serves, or access to GET /v1/models so the picker can list them
- For Codex: a gateway that serves the Responses API (/v1/responses)
Maintain Setup Gateway? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/sinholms-setup-gateway/?ref=badge)
Questions about Setup Gateway
What is Setup Gateway?
A zero-dependency Node.js CLI that points Claude Code, OpenCode, and Codex CLI at any OpenAI-compatible gateway, with automatic backups and a restore command. It is an open-source project on GitHub: https://github.com/Sinholms/setup-gateway.
Who is Setup Gateway for?
Developers and platform engineers who run Claude Code, OpenCode, or Codex CLI against a company proxy, LiteLLM, OpenRouter, or a local gateway and need repeatable setup.
What can I do with Setup Gateway?
4 use cases so far, for example: Point Claude Code at your own OpenAI-compatible gateway; Set up Codex CLI with gateway models in the /model picker; Restore the last working config after a bad gateway change. Each has steps and a copy-paste agent prompt.
What do I need to run Setup Gateway?
Node.js 18 or newer installed; A gateway base URL that exposes /v1 and an API key for it; A model id the gateway serves, or access to GET /v1/models so the picker can list them; For Codex: a gateway that serves the Responses API (/v1/responses).
What are alternatives to Setup Gateway?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is Setup Gateway safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.