GenFlow Auto Setup

Auto setup provider GenFlowAI untuk OpenCode dan Claude Code lewat npm.

Saat dijalankan, akan muncul menu untuk memilih OpenCode atau Claude Code. Setelah itu script cek tool yang dipilih, install otomatis jika belum ada, meminta API key GenFlow, lalu menampilkan pilihan mode model (Tambah Semua Model atau Manual Model), dan otomatis membuat atau memperbarui config di komputer user.

Syarat

• Node.js minimal versi 18
• npm
• API key GenFlowAI

API docs: https://genflowai.co/api-docs

Daftar model: https://genflowai.co/models

Cara pakai cepat

Jalankan launcher terpadu:

npx @genflowai/autosetup

Akan muncul menu pilihan:

   ╔══════════════════════════════════╗
   ║       GenFlowAI Auto Setup       ║
   ╚══════════════════════════════════╝

  > Pilih yang ingin di-setup
    Gunakan panah atas/bawah lalu Enter (Esc untuk batal)
    > OpenCode    - Setup GenFlowAI provider untuk OpenCode
      Claude Code - Setup GenFlowAI provider untuk Claude Code

Navigasi dengan panah atas/bawah lalu Enter (angka 1/2 juga bisa).

Setelah memilih tool, alurnya:

1. Masukkan GenFlow API key.
2. Pilih mode model: Tambah Semua Model (semua model tersedia, default gpt-5.5) atau Manual Model (pilih satu model lewat picker).
3. Config otomatis ditulis.

Lewati menu (langsung ke tool tertentu)

# OpenCode langsung
npx @genflowai/autosetup opencode

# Claude Code langsung
npx @genflowai/autosetup claude

Opsi lain (--api-key, --model, --skip-*-install) diteruskan ke setup terpilih.

Dari source lokal

npm start            # launcher (menu pilih tool)
npm run setup        # langsung OpenCode
npm run setup-claude # langsung Claude Code

OpenCode Setup

Apa yang dilakukan script?

1. Mengecek apakah command opencode sudah tersedia.

2. Jika belum tersedia, script install otomatis dengan:

   npm install -g opencode-ai@latest

3. Meminta API key GenFlowAI.

4. Mengambil daftar model dari:

   https://v1.genflow.id/v1/models

5. Menampilkan pilihan mode: Tambah Semua Model (konfigurasi semua model tersedia) atau Manual Model (pilih satu lewat picker panah + filter).

6. Validasi model jika endpoint model bisa diakses.

7. Menulis config OpenCode ke home directory user.

Lokasi config default:

~/.config/opencode/opencode.json

Contoh di Windows akan menjadi:

C:\Users\NAMA_USER\.config\opencode\opencode.json

Tidak ada path user hardcoded. Path otomatis mengikuti komputer masing-masing user.

Contoh config yang dibuat

Jika user memilih model gpt-5.5, script akan membuat config seperti ini:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "genflowai/gpt-5.5",
  "provider": {
    "genflowai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "GenFlowAI",
      "options": {
        "baseURL": "https://v1.genflow.id/v1",
        "apiKey": "API_KEY_USER"
      },
      "models": {
        "gpt-5.5": {
          "name": "gpt-5.5"
        }
      }
    }
  }
}

Mode non-interaktif

Cocok untuk automation/CI/script. Wajib menyertakan --model karena picker tidak muncul di mode non-interaktif.

Linux/macOS:

GENFLOW_API_KEY="gf_xxxxxxxxx" npx @genflowai/autosetup opencode --model gpt-5.5

Windows PowerShell:

$env:GENFLOW_API_KEY="gf_xxxxxxxxx"; npx @genflowai/autosetup opencode --model gpt-5.5

Atau langsung lewat argumen:

npx @genflowai/autosetup opencode --api-key gf_xxxxxxxxx --model gpt-5.5

Jika ingin melewati cek/install OpenCode:

npx @genflowai/autosetup opencode --skip-opencode-install --api-key gf_xxxxxxxxx --model gpt-5.5

Custom lokasi config

Defaultnya script menulis ke:

~/.config/opencode/opencode.json

Untuk test atau custom lokasi, pakai OPENCODE_CONFIG_DIR.

Linux/macOS:

OPENCODE_CONFIG_DIR="/tmp/opencode" GENFLOW_API_KEY="gf_xxxxxxxxx" npx @genflowai/autosetup opencode --model gpt-5.5

Windows PowerShell:

$env:OPENCODE_CONFIG_DIR="C:\Temp\opencode"; $env:GENFLOW_API_KEY="gf_xxxxxxxxx"; npx @genflowai/autosetup opencode --model gpt-5.5

Setelah setup

Jalankan OpenCode:

opencode

OpenCode akan memakai provider genflowai dengan model genflowai/NAMA_MODEL, contoh genflowai/gpt-5.5.

Claude Code Setup

Apa yang dilakukan script?

1. Mengecek apakah command claude sudah tersedia.

2. Jika belum tersedia, script install otomatis dengan:

   npm install -g @anthropic-ai/claude-code@latest

3. Meminta API key GenFlowAI.

4. Mengambil daftar model dari GenFlowAI.

5. Menampilkan pilihan mode: Tambah Semua Model (default gpt-5.5 aktif) atau Manual Model (pilih satu lewat picker panah + filter).

6. Validasi model jika endpoint model bisa diakses.

7. Menulis config Claude Code ke home directory user.

8. Auto-approve API key di ~/.claude.json agar tidak muncul prompt "Not logged in".

Lokasi config default:

~/.claude/settings.json

Contoh di Windows akan menjadi:

C:\Users\NAMA_USER\.claude\settings.json

Contoh config yang dibuat

Jika user memilih model gpt-5.5, script akan membuat config seperti ini:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "gpt-5.5",
  "env": {
    "ANTHROPIC_BASE_URL": "https://v1.genflow.id",
    "ANTHROPIC_API_KEY": "API_KEY_USER",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
    "ANTHROPIC_CUSTOM_MODEL_OPTION": "gpt-5.5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "gpt-5.5 (GenFlowAI)",
    "ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION": "GenFlowAI - gpt-5.5"
  }
}

Script mengkonfigurasi Claude Code agar menggunakan GenFlowAI sebagai API endpoint melalui ANTHROPIC_BASE_URL dan ANTHROPIC_API_KEY di blok env.

Catatan tentang /model picker: Claude Code hanya menampilkan model bawaan (Default/Sonnet/Haiku), model claude* dari gateway discovery, dan 1 custom model option di /model picker. Ini limitasi desain Claude Code, bukan bug. Model default (dari config model) langsung aktif saat claude dijalankan. Untuk ganti model default ke model lain, gunakan Model Switcher.

Mode non-interaktif

Wajib menyertakan --model karena picker tidak muncul di mode non-interaktif.

Linux/macOS:

GENFLOW_API_KEY="gf_xxxxxxxxx" npx @genflowai/autosetup claude --model claude-sonnet-4-6

Windows PowerShell:

$env:GENFLOW_API_KEY="gf_xxxxxxxxx"; npx @genflowai/autosetup claude --model claude-sonnet-4-6

Atau langsung lewat argumen:

npx @genflowai/autosetup claude --api-key gf_xxxxxxxxx --model claude-sonnet-4-6

Jika ingin melewati cek/install Claude Code:

npx @genflowai/autosetup claude --skip-claude-install --api-key gf_xxxxxxxxx --model claude-sonnet-4-6

Custom lokasi config

Defaultnya script menulis ke:

~/.claude/settings.json

Untuk test atau custom lokasi, pakai CLAUDE_CONFIG_DIR.

Linux/macOS:

CLAUDE_CONFIG_DIR="/tmp/claude" GENFLOW_API_KEY="gf_xxxxxxxxx" npx @genflowai/autosetup claude --model claude-sonnet-4-6

Windows PowerShell:

$env:CLAUDE_CONFIG_DIR="C:\Temp\claude"; $env:GENFLOW_API_KEY="gf_xxxxxxxxx"; npx @genflowai/autosetup claude --model claude-sonnet-4-6

Setelah setup

Jalankan Claude Code dengan model default:

claude

Jalankan model tertentu (genflow-claude)

Claude Code /model picker hanya menampilkan model bawaan + 1 custom option. Untuk menjalankan model GenFlowAI apapun langsung tanpa repot ganti config, gunakan genflow-claude:

# Pakai model tertentu
npx -p @genflowai/autosetup genflow-claude --model gpt-5.5
npx -p @genflowai/autosetup genflow-claude --model deepseek-v4-pro

# Dengan argumen claude lainnya
npx -p @genflowai/autosetup genflow-claude --model gpt-5.5 -p "explain this code"

# Lihat daftar model
npx -p @genflowai/autosetup genflow-claude --list

# Bantuan
npx -p @genflowai/autosetup genflow-claude --help

Atau dari source lokal:

npm run genflow-claude -- --model gpt-5.5

genflow-claude membaca config GenFlowAI yang sudah disetup lalu menjalankan claude dengan ANTHROPIC_MODEL sesuai model yang dipilih.

Ganti model default (Model Switcher)

Untuk mengubah model default yang dipakai saat menjalankan claude:

# Interaktif - pilih dari daftar lengkap
npx -p @genflowai/autosetup genflow-claude-model

# Langsung lewat argumen
npx -p @genflowai/autosetup genflow-claude-model --model gpt-5.4

Atau dari source lokal:

npm run claude-model
# atau
npm run claude-model -- --model deepseek-v4-pro

Memilih model

Saat setup, pertama muncul pilihan mode:

• Tambah Semua Model - konfigurasi semua model yang tersedia sekaligus. Model default diset ke gpt-5.5 (jika tersedia di daftar).
• Manual Model - buka picker untuk memilih satu model saja.

Daftar model lengkap ada di:

https://genflowai.co/models

Saat picker model (mode Manual Model) muncul:

• Ketik untuk memfilter daftar (contoh: ketik gpt untuk menyaring model gpt).
• Panah atas/bawah untuk berpindah pilihan.
• Enter untuk set model terpilih.
• Backspace untuk mengedit teks filter.
• Esc untuk batal.

Untuk mode non-interaktif (tanpa terminal/CI), pilihan mode tidak muncul - sertakan --model secara eksplisit untuk menentukan satu model.

Troubleshooting

API key wajib diisi.

API key kosong. Jalankan ulang lalu isi API key GenFlowAI.

Model tidak ditemukan

Model yang dipilih/diketik tidak ada di endpoint model GenFlowAI.

Cek daftar model:

https://genflowai.co/models

Lalu jalankan ulang dengan model yang valid.

npm tidak bisa jalan di PowerShell

Jika PowerShell memblokir npm.ps1, pakai:

cmd /c "npm start"

atau:

cmd /c "npx @genflowai/autosetup"

Install OpenCode gagal

Script otomatis menjalankan:

npm install -g opencode-ai@latest

Jika gagal, cek koneksi internet dan permission npm global. Setelah berhasil, restart terminal lalu jalankan ulang script.

Jika OpenCode sudah terinstall tapi script tetap ingin install, jalankan dengan:

npx @genflowai/autosetup opencode --skip-opencode-install

Config lama sudah ada

Script akan membaca config lama lalu menambahkan/memperbarui provider genflowai. Config provider lain tetap dipertahankan.

Claude Code config lama sudah ada

Script Claude Code akan membaca settings.json lama lalu memperbarui env.ANTHROPIC_BASE_URL, env.ANTHROPIC_API_KEY, dan model. Settings lain tetap dipertahankan.