🛰️ setup-gateway

Konfigurator gateway OpenAI-compatible untuk Claude Code, OpenCode, dan Codex CLI — sekali jalan, config ter-update dengan aman.

Quick start · Cara kerja · Perintah · Flag & env · Keamanan · Troubleshooting

Tulis ulang config alat AI kamu tanpa merusak yang sudah ada — backup otomatis, preservasi setting, dan restore satu perintah.

---

setup-gateway adalah CLI generik yang mengkonfigurasi gateway API OpenAI-compatible (LiteLLM, OpenRouter, proxy internal perusahaan, instance 9Router lokal, dll.) ke tiga klien AI coding populer. Tidak ada provider, base URL, atau model yang di-hardcode — kamu memasukkan base URL + API key + model sendiri tiap setup.

Satu perintah. Pilih tool → tempel base URL → tempel key → pilih model → selesai. Config lama dipertahankan, backup dibuat, dan kamu bisa kembali kapan pun dengan restore.

✨ Kenapa menarik

• 🧩 Generik & netral — pakai gateway apa pun yang expose /v1 (Responses API untuk Codex).
• 🧰 Tiga tool sekaligus — Claude Code (settings.json), OpenCode (opencode.json), Codex CLI (config.toml).
• 🖱️ Interaktif (menu panah, filterable model picker, multi-select catalog) dan headless/CI (flag + env) — satu binary, dua dunia.
• 🧼 Preservasi config — hanya bagian gateway yang disentuh; komentar TOML, provider lama, agent.*, dan key tak dikenal tetap utuh.
• 💾 Backup atomik + restore — salah menulis bukan masalah, karena setiap tulis didahului backup berlabel waktu.
• 🧪 Selftest built-in — verifikasi fungsi murni tanpa menyentuh disk nyata (--selftest, cocok untuk CI).
• 🪶 Zero-dependency — Node ≥ 18 saja (fetch, readline, AbortController bawaan). Tidak ada npm install.

🚀 Quick start

Butuh Node ≥ 18. Clone, lalu jalankan:

# interaktif — menu pilih tool → tanya base URL, API key, model
node bin/setup-gateway.mjs
# alias:  node setup-gateway.mjs      (shim, setara)
# alias:  npm run setup

Langsung satu tool:

node bin/setup-gateway.mjs claude     # Claude Code
node bin/setup-gateway.mjs opencode   # OpenCode
node bin/setup-gateway.mjs codex      # Codex CLI

Headless / CI (tanpa prompt):

node bin/setup-gateway.mjs claude \
  --base-url https://gw.example.com \
  --api-key sk-... \
  --model deepseek-v4 \
  --yes

status (read-only) dan restore (pulihkan backup) tersedia kapan pun:

node setup-gateway.mjs status         # lihat config aktif (key termask)
node setup-gateway.mjs restore codex  # pulihkan backup terakhir Codex

⚙️ Cara kerja

Alur interaktif:

1. Pilih tool (panah + spasi; a = semua).
2. Masukkan Base URL — mis. https://gw.example.com atau http://127.0.0.1:8080.
3. Masukkan API key.
4. Pilih model — tool mencoba GET <baseURL>/v1/models dengan key sebagai Bearer. Berhasil → daftar filterable (ketik untuk cari); gagal/timeout → ketik id model manual.
5. Config ditulis → backup dibuat → (khusus Claude Code) suffix key di-approve di ~/.claude.json supaya tidak ada prompt izin custom API key.

Yang dihasilkan per tool: