menu_bookAI Coding Agent Gateway

Kuloworks AI Gateway

Kuloworks AI Gateway adalah infrastruktur routing AI berkinerja tinggi yang dirancang khusus untuk AI Coding Agents & Modern IDEs (Claude Code, Cursor, Trae, VS Code Cline/Roo Code, Continue.dev, OpenCode, Windsurf, Aider). Menyediakan kompatibilitas penuh dengan standar Anthropic (/v1/messages) dan OpenAI (/v1/chat/completions) dengan fitur low-latency SSE streaming, token-saver compression, dan fair-use rolling window rate limit.

terminalClaude Code Native

Kompatibilitas penuh Anthropic CLI protocol dengan streaming SSE dan thinking reasoning block.

extensionMulti-Agent & IDEs

Dukungan Cursor, Trae, Cline, Continue.dev, OpenCode, Windsurf, hingga script kustom.

historyRolling Window Kuota

Reset jendela bergerak transparan dengan live status monitor (/usage) tanpa login admin.

settings_ethernetParameter Koneksi Endpoint

Gunakan kredensial dan URL berikut saat mengonfigurasi Agent atau IDE Anda.

Base URL (OpenAI / Agent)

https://ai.kuloworks.my.id/v1

Anthropic Base URL (Claude Code)

https://ai.kuloworks.my.id

Format Model ID

kulo/<nama-model>

Contoh: kulo/claude-sonnet-4-6

boltSetup Cepat & Teruji (100% Agent-Focused)

terminalPetunjuk Setup AI Coding Agents & IDEs

Pilih AI Coding Agent atau IDE yang Anda gunakan untuk melihat konfigurasi siap pakai dengan Kuloworks AI Gateway.

Claude Code CLI

Anthropic Agent✓ Verified Compatible

Terminal AI agent resmi dari Anthropic yang terhubung langsung ke Kuloworks AI Gateway via Anthropic native protocol.

dnsProvider

Kuloworks AI Gateway

linkBase URL

https://ai.kuloworks.my.id

smart_toyModel Flagship

kulo/claude-sonnet-4-6

verifiedProtokol

Anthropic Native Protocol

format_list_numberedLangkah Integrasi:

1Set ANTHROPIC_BASE_URL ke https://ai.kuloworks.my.id dan ANTHROPIC_AUTH_TOKEN ke API Key Kuloworks Anda

2PENTING: Kosongkan (unset) ANTHROPIC_API_KEY agar tidak bentrok dengan validasi format resmi Anthropic

3Jalankan claude --model kulo/claude-sonnet-4-6 dan verifikasi koneksi dengan mengetik /status di dalam CLI

~/.claude/settings.json & Terminal

# ─── METODE 1: Session Langsung di Terminal (atau masukkan ke ~/.zshrc / ~/.bashrc) ───
export ANTHROPIC_BASE_URL="https://ai.kuloworks.my.id"
export ANTHROPIC_AUTH_TOKEN="sk-your-registered-api-key"
unset ANTHROPIC_API_KEY  # Wajib di-unset agar Claude Code menggunakan Auth Token gateway

# Jalankan Claude Code dengan model Flagship Kuloworks
claude --model kulo/claude-sonnet-4-6

# Mode Deep Reasoning Architecture:
# claude --model kulo/claude-opus-4-6


# ─── METODE 2: Konfigurasi Persisten di ~/.claude/settings.json (Direkomendasikan) ───
# Simpan JSON berikut ke file ~/.claude/settings.json (atau ~/.claude.json):
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.kuloworks.my.id",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-registered-api-key"
  }
}

# Tips: Di dalam Claude Code, ketik /status untuk memverifikasi URL & token gateway sudah aktif!

databaseDaftar Model AI yang Didukung

Gunakan Model ID di bawah saat mengonfigurasi parameter request pada SDK atau IDE Anda.

8 Model Aktif

Model ID (Prefix)	Model Asli & Fitur	Spesialisasi & Use Case
kulo/claude-sonnet-4-6	Claude Sonnet 4.6 (Thinking)Flagship ⭐🧠 Thinking	Model flagship mutakhir untuk coding kompleks, deep extended thinking, refactoring arsitektur
kulo/claude-opus-4-6	Claude Opus 4.6 (Thinking)Deep Reasoning🧠 Thinking	Tingkat reasoning tertinggi, matematika rumit, logika deduksi mendalam, analisis codebase berat
kulo/deepseek-v4-pro	DeepSeek V4 ProFlagship Pro🧠 Thinking	Model penalaran flagship DeepSeek mutakhir untuk pemecahan algoritma dan arsitektur kompleks
kulo/deepseek-v4-flash	DeepSeek V4 FlashUltra Fast	Kecepatan eksekusi tinggi dan throughput efisien untuk tasks scripting harian
kulo/gemini-3.8-flash	Gemini 3.8 FlashNext-Gen ⚡🧠 Thinking	Generasi mutakhir Gemini 3.8 dengan kecepatan throughput ultra tinggi dan respons instan
kulo/gemini-3.7-flash	Gemini 3.7 FlashUltra Fast🧠 Thinking	Kecepatan eksekusi ultra tinggi dengan context window 1 juta token untuk analisis codebase masif
kulo/gemini-3.1-pro	Gemini 3.1 ProPro Flagship🧠 Thinking	Kemampuan agentic multi-langkah yang stabil dan handal untuk tool orchestration
kulo/gpt-oss-120b	smart_toy GPT-OSS 120BOpen Model	Model open-weights parameter 120B untuk coding serbaguna dan penalaran independen

historyMekanisme Rolling Window & Reset Kuota

Bagaimana batas request dan pemulihan slot dihitung secara adil.

Kuloworks AI Gateway menggunakan metode Sliding Window Rate Limiter (First-In First-Out). Sistem ini tidak mereset kuota secara kaku di tengah malam, melainkan memantau setiap request secara individual dalam jendela waktu aktif (misal 5 jam).

Rumus Pemulihan Slot Kuota:

Waktu Reset Slot = Timestamp Request Tertua + Durasi Window (5 Jam)

Contoh: Jika Anda memiliki paket limit 50 req / 5 jam dan request pertama dilakukan pada pukul 10:15 WIB, maka slot request tersebut akan otomatis keluar dari window pada pukul 15:15 WIB, dan kuota yang tersedia langsung bertambah +1 slot.

tuneSub-Limit Khusus Per Model (Sub-Caps):

Selain limit total, kunci API dapat memiliki alokasi sub-kuota per model (misal: total limit 250 req, dengan sub-limit Claude Opus: 25 req & Sonnet: 100 req).

Isolasi Model: Jika kuota model flagship (seperti Opus) mencapai batas sub-cap, Anda tetap dapat menggunakan model lain (seperti Sonnet, Gemini Flash, DeepSeek) selama limit total masih tersedia.
Bebas untuk Flat / Free Tier: Kunci tanpa sub-limit dapat menggunakan seluruh kapasitas limitnya secara 100% bebas untuk model mana pun.
Transparansi Quota: Kuota dihitung berdasarkan nama model yang Anda request (misal kulo/claude-opus-4-6), bukan model fallback internal backend.

HTTP Headers saat Rate Limit Tercapai (429):

Retry-After

Detik sisa reset

X-RateLimit-Limit

Batas request

X-RateLimit-Reset

Unix timestamp

Self-Service Portal

Periksa Sisa Kuota & Jam Reset Mandiri

Anda tidak perlu login ke dashboard admin. Cukup masukkan nama key Anda di halaman publik untuk melihat progress bar kuota dan jam slot pulih secara real-time.

help_outlineFAQ & Troubleshooting Khusus AI Agent

Pertanyaan umum seputar penggunaan dan pemecahan kendala pada coding agent.

Mengapa Claude Code CLI saya tidak bisa terhubung?

Pastikan Anda menyetel ANTHROPIC_AUTH_TOKEN (bukan hanya ANTHROPIC_API_KEY) dan pastikan variable ANTHROPIC_API_KEY di-unset / dikosongkan. Claude Code CLI membutuhkan Auth Token Bearer untuk terhubung ke gateway pihak ketiga tanpa memvalidasi pola key resmi Anthropic. Anda dapat menjalankan perintah /status di dalam Claude Code untuk memverifikasi.

Bagaimana cara menggunakan VS Code biasa sebagai AI Coding Agent?

Cukup install extension Cline atau Roo Code dari VS Code Marketplace, lalu pada Settings pilih provider OpenAI Compatible dengan Base URL https://ai.kuloworks.my.id/v1. Extension ini akan otomatis memiliki kemampuan multi-file editing, tool use, terminal execution, dan MCP protocol.

Mengapa saya mendapatkan response 429 Too Many Requests?

Ini menandakan batas request pada sliding window Anda telah tercapai. Cek jadwal jam reset di halaman /usage untuk melihat kapan slot kuota Anda akan pulih kembali.

Apakah tool-use, MCP (Model Context Protocol), dan reasoning block didukung?

Ya, gateway mendukung penuh Anthropic native tool calling, Claude Extended Thinking blocks, MCP servers, serta OpenAI streaming functions tanpa penurunan kompatibilitas.