Pakai Sider di coding agent Anda
Atur Claude Code, Codex CLI, OpenCode, dan coding agent lainnya agar memakai layanan ini: dapatkan API key, lalu ikuti panduan alat Anda. Perintah dan pengaturannya sudah berisi alamat layanan ini.
Sebelum mulai
API key
API key diberikan atas permintaan oleh administrator layanan ini.
Base URL
API yang kompatibel dengan OpenAI
https://sider.ai.id/v1
API yang kompatibel dengan Anthropic (Claude Code)
https://sider.ai.id
Setiap panduan di bawah sudah memakai yang sesuai.
Model
Contoh di bawah memakai gemini-3.1-pro. Anda bisa memakai model mana pun dari daftar model di halaman status. Pilih model yang mendukung tool calling: coding agent memakai tool untuk membaca dan mengedit file serta menjalankan perintah.
Claude Code
buatan Anthropic · Anthropic Messages APIAgen coding dari Anthropic untuk terminal: membaca proyek Anda, mengedit file, dan menjalankan perintah.
Pasang Claude Code dengan installer dari Anthropic (atau
npm install -g @anthropic-ai/claude-codedengan Node.js 22 atau yang lebih baru). Lalu buka terminal baru dan pastikanclaude --versionmenampilkan nomor versi.macOS, Linux, WSLcurl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell)irm https://claude.ai/install.ps1 | iex
Buat file
~/.claude/settings.json(di Windows%USERPROFILE%\.claude\settings.json) berisi teks di bawah; perintah untuk sistem Anda membukanya di editor (di nano, Ctrl+O lalu Enter menyimpan, Ctrl+X keluar). Bila file itu sudah ada, tambahkan entri-entri ini ke dalamnya.ANTHROPIC_BASE_URLadalah alamat tanpa/v1: Claude Code menambahkan/v1/messagessendiri.macOS, Linuxmkdir -p ~/.claude && nano ~/.claude/settings.json
Windows (PowerShell)New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null; notepad "$env:USERPROFILE\.claude\settings.json"
~/.claude/settings.json{ "env": { "ANTHROPIC_BASE_URL": "https://sider.ai.id", "ANTHROPIC_MODEL": "gemini-3.1-pro", "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-3.1-pro", "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-3.1-pro", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-3.1-pro", "ANTHROPIC_DEFAULT_FABLE_MODEL": "gemini-3.1-pro", "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8192" }, "disableAutoMode": "disable" }Simpan API key Anda di luar file itu, di variabel lingkungan
ANTHROPIC_AUTH_TOKEN(Claude Code mengirimnya sebagaiAuthorization: Bearer): gantiAPI_KEY_ANDAdengan key Anda, jalankan perintah untuk sistem Anda sekali, lalu tutup terminal dan buka yang baru.macOS (zsh)echo 'export ANTHROPIC_AUTH_TOKEN="API_KEY_ANDA"' >> ~/.zshrc
Linux (bash)echo 'export ANTHROPIC_AUTH_TOKEN="API_KEY_ANDA"' >> ~/.bashrc
Windows (PowerShell)setx ANTHROPIC_AUTH_TOKEN "API_KEY_ANDA"
Di folder proyek Anda, jalankan Claude Code. Pertama kali, pilih tema, tekan Enter setelah catatan keamanan, lalu pilih Yes, I trust this folder; tidak perlu login. Ketik
/status: tampil Anthropic base URLhttps://sider.ai.id, Auth tokenANTHROPIC_AUTH_TOKEN, dan Modelgemini-3.1-pro. Lalu ajukan pertanyaan. Bila muncul layar login, berartiANTHROPIC_AUTH_TOKENbelum ada di terminal ini.Di folder proyek Andaclaude
Perlu diketahui
- Kelima entri model menyebut
gemini-3.1-prountuk percakapan utama dan untuk model yang oleh Claude Code disebutopus,sonnet,haiku, danfable, yang diminta subagent dan helper-nya. Tanpa entri itu, permintaan tersebut menyebut model Claude yang tidak ada di layanan ini dan gagal dengan404. Untuk memakai model lain, ganti kelimanya. - Claude Code meminta jawaban sampai 32.000 token; banyak model mengizinkan lebih sedikit, dan provider-nya menolak permintaan seperti itu (
400).CLAUDE_CODE_MAX_OUTPUT_TOKENSmemintanya 8.192 saja: naikkan bila model Anda mengizinkan lebih. Selama permintaan berjalan, batas output-nya juga ikut dihitung dalam batas token harian akun Anda, bila ada. disableAutoModemembuat Claude Code mulai dalam mode Manual: ia bertanya dulu sebelum mengedit file atau menjalankan perintah. Dalam auto mode, mode bawaannya, sebuah classifier memeriksa perintah sebelum dijalankan dengan permintaan tambahan berukuran puluhan ribu token kegemini-3.1-pro, yang ikut dihitung dalam batas Anda, dan memblokir perintah bila jawabannya tidak terbaca. Hapus baris itu bila Anda tetap ingin memakai auto mode.- Pilih model yang mendukung tool calling (function calling): Claude Code membaca, mengedit, dan menjalankan semuanya lewat tool.
- Tool WebSearch berjalan di server Anthropic. Tool ini hanya bekerja bila
gemini-3.1-prodilayani provider yang kompatibel dengan Anthropic dan mendukungnya, dan admin meneruskan server tool Anthropic; selain itu pencarian gagal. - Claude Code tidak mengenal nama model layanan ini, jadi saat mulai ia memperingatkan bahwa jendela konteks dianggap 200k token. Bila jendela
gemini-3.1-proberbeda (tertera di tab Model dashboard Anda, ataucontext_length-nya diGET https://sider.ai.id/v1/modelsdengan API key Anda), tambahkan"CLAUDE_CODE_MAX_CONTEXT_TOKENS": "…"berisi angka itu keenv, agar Claude Code meringkas percakapan tepat waktu.
Semua pengaturannya ada di dokumentasi Claude Code.
Codex CLI
buatan OpenAI · OpenAI Responses APIAgen coding dari OpenAI untuk terminal: membaca proyek Anda, mengedit file, dan menjalankan perintah.
Pasang Codex CLI dengan installer dari OpenAI (atau
npm install -g @openai/codex). Lalu buka terminal baru dan pastikancodex --versionmenampilkan nomor versi.macOS, Linuxcurl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows (PowerShell)powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
Buka
~/.codex/config.toml(di Windows%USERPROFILE%\.codex\config.toml) dengan perintah untuk sistem Anda (di nano, Ctrl+O lalu Enter menyimpan, Ctrl+X keluar), lalu tambahkan pengaturan di bawah. Bila file itu sudah berisi pengaturan, letakkan tiga baris pertama di atas baris berkurung pertamanya, misalnya[features], dan hapus baris lamanya yang bernama sama.base_urldiakhiri/v1: Codex menambahkan/responses.macOS, Linuxmkdir -p ~/.codex && nano ~/.codex/config.toml
Windows (PowerShell)New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null; notepad "$env:USERPROFILE\.codex\config.toml"
~/.codex/config.tomlmodel = "gemini-3.1-pro" model_provider = "aiter" web_search = "disabled" [model_providers.aiter] name = "Sider" base_url = "https://sider.ai.id/v1" env_key = "AITER_API_KEY" wire_api = "responses"
Simpan API key Anda di luar file itu, di variabel lingkungan
AITER_API_KEYyang disebutenv_key: gantiAPI_KEY_ANDAdengan key Anda, jalankan perintah untuk sistem Anda sekali, lalu tutup terminal dan buka yang baru.macOS (zsh)echo 'export AITER_API_KEY="API_KEY_ANDA"' >> ~/.zshrc
Linux (bash)echo 'export AITER_API_KEY="API_KEY_ANDA"' >> ~/.bashrc
Windows (PowerShell)setx AITER_API_KEY "API_KEY_ANDA"
Di folder proyek Anda, jalankan Codex; tidak perlu login. Ketik
/status: tampil Modelgemini-3.1-prodan Model provideraiter. Lalu ajukan pertanyaan. PesanMissing environment variable: `AITER_API_KEY`berarti variabel itu belum ada di terminal ini; setelah ada, jalankancodex app-server daemon restart, karena server latar Codex tetap memakai lingkungan saat ia dimulai.Di folder proyek Andacodex
Perlu diketahui
- Pilih model yang namanya tidak diawali nama model OpenAI yang dikenal Codex, misalnya
gpt-5.5atauopenai/gpt-5.5: untuk nama seperti itu Codex menambahkan tool jenis lain (apply_patchsebagai toolcustom, dantool_search) yang ditolak layanan ini dengan400. - Untuk nama lain Codex memperingatkan
Model metadata for `gemini-3.1-pro` not founddan memakai nilai bawaan, di antaranya jendela konteks 272.000 token. Bila jendelagemini-3.1-prolebih kecil (tertera di tab Model dashboard Anda, ataucontext_length-nya diGET https://sider.ai.id/v1/modelsdengan API key Anda), tambahkanmodel_context_window = …berisi angka itu di dekatmodel, agar Codex meringkas percakapan tepat waktu. - Pilih model yang mendukung tool calling (function calling): Codex menjalankan perintah dan mengedit file lewat tool.
- Agar model berpikir lebih dalam, tambahkan
model_reasoning_effort = "high"(atau"low","medium") di dekatmodel: nilainya sampai ke model sebagaireasoning_effort. Model tanpa reasoning bisa menolaknya dengan400; tanpa pengaturan ini Codex tidak mengirimnya. web_search = "disabled"mematikan web search Codex, yang berjalan di server OpenAI: layanan ini tidak punya web search dan tetap membuang tool itu.
Semua pengaturannya ada di dokumentasi Codex CLI.
Antigravity
buatan Google · OpenAI Chat Completions APIIDE agentik dari Google, yang agen bawaannya hanya menjalankan model yang disediakan Google dan tidak bisa diarahkan ke API lain: di Antigravity, Anda memakai Sider lewat ekstensi Cline.
Di editor Antigravity, buka tampilan Extensions, cari ID ini, lalu pasang Cline dari saoudrizwan (bukan Cline (Nightly) atau tiruannya).
ID ekstensisaoudrizwan.claude-dev
Buka Cline lewat ikonnya di side bar. Pada pembukaan pertama, pilih Bring my own API key lalu Continue; setelah itu, ikon roda giginya membuka Settings → API Configuration. Setel API Provider ke OpenAI Compatible lalu isi kolom-kolom ini; daftar Model ID menampilkan model yang boleh dipakai key Anda.
Base URLhttps://sider.ai.id/v1
OpenAI Compatible API KeyAPI_KEY_ANDA
Model IDgemini-3.1-pro
Di bawah Model Configuration, isi Max Output Tokens (8192 adalah awal yang aman; naikkan bila model mengizinkan lebih) dan Context Window Size, yaitu jendela konteks model yang tertera di tab Model dashboard Anda. Hapus centang Supports Images bila model tidak bisa membaca gambar.
Buka folder proyek Anda, mulai task baru di Cline (+), lalu minta sesuatu yang memerlukan tool, misalnya menampilkan daftar file proyek.
Route POST /chat/completions not found(404) berarti base URL tidak diakhiri/v1;Invalid API key(401) berarti key-nya salah.
Perlu diketahui
- Agen bawaan Antigravity tidak bisa memakai Sider: halaman paket Google menyatakan belum ada dukungan bring-your-own-key maupun bring-your-own-endpoint, dan CLI Antigravity hanya menerima endpoint yang kompatibel dengan Gemini, yang tidak disediakan layanan ini. Cline bekerja di sampingnya, di panelnya sendiri.
- Pilih model yang mendukung tool calling (function calling): Cline membaca dan mengubah file serta menjalankan perintah lewat tool.
- Tanpa Max Output Tokens, Cline meminta sampai 32.000 token output, yang ditolak banyak model (
400 upstream_bad_request) dan, bila akun Anda punya batas token harian, dipesan dari batas itu selama permintaan berjalan. - Biarkan Reasoning Effort tetap none kecuali model itu mendukung reasoning: Cline mengirim pilihan itu sebagai
reasoning_effort, yang bisa ditolak model tanpa reasoning. - Cline menyimpan API key di pengaturannya sendiri di komputer Anda; Cline tidak membaca
AITER_API_KEY.
Semua pengaturannya ada di dokumentasi Cline.
OpenCode
buatan Anomaly · OpenAI Chat Completions APIAgen coding open source untuk terminal, juga tersedia sebagai aplikasi desktop dan ekstensi IDE, yang bisa memakai provider apa pun yang kompatibel dengan OpenAI.
Pasang OpenCode. Di Windows, perintah npm memerlukan Node.js;
scoop install opencodeatauchoco install opencodejuga bisa. OpenCode menyarankan WSL di Windows: di dalam WSL, pakai perintah macOS/Linux.macOS, Linuxcurl -fsSL https://opencode.ai/install | bash
Windows (PowerShell)npm install -g opencode-ai
Simpan ini sebagai config OpenCode untuk semua proyek Anda,
~/.config/opencode/opencode.json(Windows:%USERPROFILE%\.config\opencode\opencode.json; buat folder-nya bila belum ada), atau sebagaiopencode.jsondi folder sebuah proyek untuk proyek itu saja. Bila file itu sudah ada, tambahkan saja barismodeldan entriaiter(di bawahprovider) ke dalamnya. Di bawahmodels, cantumkan setiap model yang ingin Anda pakai, beserta batasnya (lihat di bawah).~/.config/opencode/opencode.json{ "$schema": "https://opencode.ai/config.json", "model": "aiter/gemini-3.1-pro", "provider": { "aiter": { "npm": "@ai-sdk/openai-compatible", "name": "Sider", "options": { "baseURL": "https://sider.ai.id/v1", "apiKey": "{env:AITER_API_KEY}" }, "models": { "gemini-3.1-pro": { "limit": { "context": 128000, "output": 8192 } } } } } }Simpan API key Anda di variabel lingkungan
AITER_API_KEY, di terminal tempat Anda menjalankan OpenCode. Nilainya hilang saat terminal ditutup: agar tetap ada, tambahkan barisnya ke~/.zshrcatau~/.bashrc(macOS, Linux), atau jalankan sekalisetx AITER_API_KEY "API_KEY_ANDA"lalu buka terminal baru (Windows).macOS, Linuxexport AITER_API_KEY="API_KEY_ANDA"
Windows (PowerShell)$env:AITER_API_KEY = "API_KEY_ANDA"
Di terminal yang sama, periksa config:
opencode models aitermencantumkanaiter/gemini-3.1-pro. Lalu jalankan OpenCode di folder proyek Anda; di bawah kolom prompt tampil gemini-3.1-pro dan Sider. Minta sesuatu yang memerlukan tool, misalnya menampilkan daftar file proyek./modelsberganti di antara model-model di config Anda.Di folder proyek Andaopencode models aiter opencode
Perlu diketahui
- Pilih model yang mendukung tool calling (function calling): OpenCode membaca dan mengubah file serta menjalankan perintah lewat tool, di setiap giliran.
limit.outputmembatasi panjang setiap jawaban. Tanpanya OpenCode meminta 32.000 token, yang ditolak banyak model (400 upstream_bad_request) dan, bila akun Anda punya batas token harian, dipesan dari batas itu selama permintaan berjalan. 8192 adalah awal yang aman; naikkan bila model mengizinkan lebih.limit.contextadalah jendela konteks model, yang tertera di tab Model dashboard Anda: OpenCode meringkas percakapan sebelum melampaui jendela itu.- Tidak ingin memakai variabel lingkungan? Jalankan
opencode auth login, pilih Other, isiaiterdan API key Anda, lalu hapus barisapiKeydari config.Missing API key(401) berarti OpenCode tidak mengirim key: variabelnya tidak ada di terminal tempat OpenCode dijalankan. - Model yang menjawab
503denganserved for Anthropic's Messages API onlyhanya bisa dipakai lewat API Anthropic: tambahkan"provider": { "npm": "@ai-sdk/anthropic" }ke entrinya di bawahmodels. Base URL dan key tetap sama.
Semua pengaturannya ada di dokumentasi OpenCode.
Hermes Agent
buatan Nous Research · OpenAI Chat Completions APIAgent open-source dari Nous Research untuk terminal: menjalankan perintah, mengubah file, serta menyimpan memori dan skill antarsesi.
Pasang Hermes Agent dengan installer resminya, yang sudah membawa Python yang diperlukan. Di Windows, pakai PowerShell, atau perintah Linux di dalam WSL2. Di akhir, installer membuka wizard setup.
macOS, Linux, Windows (WSL2)curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows (PowerShell)iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Di wizard, pilih Full setup, lalu provider Custom endpoint (enter URL manually). Isi API base URL
https://sider.ai.id/v1dan API key Anda (API_KEY_ANDA): Hermes memeriksanya lalu menampilkan model yang boleh dipakai key Anda. Bila wizard tidak terbuka, atau untuk mengubahnya nanti, jalankanhermes modeldi terminal baru.API base URLhttps://sider.ai.id/v1
Pilih API compatibility mode Chat Completions dan model
gemini-3.1-pro, lalu tekan Enter di Context length (Hermes membacanya dari layanan) dan di Display name. Untuk sisa wizard, biarkan pilihan bawaan dan lewati key yang tidak Anda punya. Hermes menyimpan pengaturan di~/.hermes/config.yamldan key di~/.hermes/.env(di Windows tanpa WSL, di%LOCALAPPDATA%\hermes).Modelgemini-3.1-pro
Buka terminal baru dan jalankan Hermes. Banner pembuka menampilkan model
gemini-3.1-pro. Tanyakan misalnya File apa saja di folder ini? Hermes menjalankan perintah untuk mencari tahu, lalu menjawab.macOS, Linux, Windowshermes
Perlu diketahui
- Pilih model yang mendukung tool calling: Hermes bekerja lewat tool. Hermes juga memerlukan jendela konteks minimal 64K token dan menolak model yang lebih kecil saat mulai (below the minimum 64,000 required by Hermes Agent). Jendela itu dibaca dari daftar model layanan ini (
context_length); untuk model tanpa nilai itu, Hermes menebak dari namanya atau menganggap 256K, jadi isi jendela sebenarnya bila Anda tahu:hermes config set model.context_length 131072. - Setiap permintaan membawa system prompt dan daftar tool Hermes (
hermes prompt-sizemenunjukkan ukurannya), dan tugas sampingannya juga memakai model Anda di layanan ini: judul sesi, kompresi konteks, review memori di latar belakang, dan deskripsi gambar (hanya dengan model yang menerima gambar). Semuanya dihitung dalam batas key Anda; tugas sampingan baru dikirim ke provider lain (OpenRouter, Nous Portal) bila Anda mengaturnya di Hermes. Untuk menghemat token, matikan review otomatis:hermes config set auxiliary.background_review.enabled false. - Hermes meminta
reasoning_effort: mediumkecuali Anda memilih level lain, dan layanan ini meneruskannya ke provider model. Bila provider menolaknya, Hermes menulis bahwa model itu rejects reasoning effort lalu melanjutkan tanpanya. Token reasoning dihitung sebagai output: turunkan levelnya dengan/reasoning lowdalam sesi, atau permanen denganhermes config set agent.reasoning_effort low.
Semua pengaturannya ada di dokumentasi Hermes Agent.
omp (oh-my-pi)
buatan Stencil Labs · OpenAI Chat Completions APICoding agent untuk terminal, turunan (fork) dari Pi, dengan language server, debugger, subagent, dan banyak tool lain bawaan.
Pasang omp. Installer memasang
ompyang sudah jadi, atau memasangnya lewat Bun bila Bun 1.4.4 atau lebih baru sudah ada;brew install can1357/tap/ompjuga bisa. Bila terminal lalu tidak menemukanomp, ikuti baris PATH yang ditampilkan installer dan buka terminal baru;omp --versionmenampilkan versinya.macOS, Linuxcurl -fsSL https://omp.sh/install | sh
Windows (PowerShell)irm https://omp.sh/install.ps1 | iex
Simpan API key Anda di variabel lingkungan
AITER_API_KEYpada terminal tempat Anda menjalankan omp: omp membacanya dari sana, sehingga key tidak tertulis di file omp. Variabel ini hilang saat terminal ditutup. Agar tetap ada, tambahkan baris itu ke~/.zshrc(macOS) atau~/.bashrc(Linux); di Windows, jalankan sekalisetx AITER_API_KEY "API_KEY_ANDA"lalu buka terminal baru.macOS, Linuxexport AITER_API_KEY="API_KEY_ANDA"
Windows (PowerShell)$env:AITER_API_KEY = "API_KEY_ANDA"
Tambahkan layanan ini ke
~/.omp/agent/models.yml(di Windows%USERPROFILE%\.omp\agent\models.yml): buat file dengan isi ini, atau tambahkan entriaiterdi bawahprovidersdi file yang sudah ada.apiKeyberisi nama variabelnya, bukan key-nya. Tambahkan satu entri dimodelsuntuk setiap model yang Anda pakai;contextWindowdanmaxTokensdijelaskan di catatan.~/.omp/agent/models.ymlproviders: aiter: baseUrl: "https://sider.ai.id/v1" api: openai-completions apiKey: AITER_API_KEY compat: maxTokensField: max_tokens models: - id: "gemini-3.1-pro" contextWindow: 128000 maxTokens: 8192Periksa koneksinya: omp mengirim satu permintaan ke
gemini-3.1-prolewat layanan ini dan menampilkan jawabannya, misalnyaOK.omp models aitermenampilkan model yang dibaca omp dari file; kesalahan di file tampil sebagaimodels.yml validation failedbeserta field yang salah.Terminalomp -p --model aiter/gemini-3.1-pro "Reply with only OK"
Jalankan omp di folder proyek Anda. Saat pertama dijalankan, omp membuka wizard pengaturan: di Set up your providers tekan Esc (key sudah ada di
AITER_API_KEY), lalu di Choose your default model ketikaiter, pilihaiter/gemini-3.1-pro, dan tekan Enter. Bila omp sudah pernah diatur, buka/modeldan jadikanaiter/gemini-3.1-promodel Default.Terminal, di folder proyek Andaomp
Perlu diketahui
- omp mengubah file dan menjalankan perintah lewat tool call: pakai model yang mendukung tool calling (function calling). Tool omp yang memerlukan jenis model lain, seperti pembuatan gambar atau suara, tidak bekerja lewat layanan ini, yang melayani model chat.
apiKey: AITER_API_KEYmembuat omp membaca key dari variabel itu di setiap permintaan. Bila variabel itu tidak ada, omp mengirim namanya sendiri sebagai key dan layanan ini menjawab401 invalid_api_key: isi variabel itu di terminal tempat Anda menjalankan omp.404 model_not_foundberarti key ini tidak bisa memakai model dengan ID itu (huruf besar dan kecil dibedakan).contextWindowadalah jendela konteks model dalam token: omp meringkas percakapan sebelum jendela itu penuh, dan meringkas lalu mencoba lagi bila layanan ini menjawab400 context_length_exceeded. Isi dengan jendela model itu dari tab Model dashboard Anda, ataucontext_length-nya diGET https://sider.ai.id/v1/modelsdengan API key Anda, bila tercantum.maxTokensadalah jawaban terpanjang yang diminta omp: 8192 cocok untuk kebanyakan model; naikkan untuk model yang mengizinkan jawaban lebih panjang, atau turunkan bila permintaan gagal dengan400 upstream_bad_requesttentang batas output. Dengan batas token harian, setiap permintaan memesan prompt-nya ditambahmaxTokenssampai selesai.maxTokensField: max_tokensmengirim batas output di field yang dibaca provider di belakang layanan ini; tanpa itu omp mengirimmax_completion_tokens, yang diabaikan sebagian provider. Model reasoning OpenAI (seri o, GPT-5) menolakmax_tokens(400 upstream_bad_request): beri model seperti itucompat: { maxTokensField: max_completion_tokens }di entrinya.- omp mengirim pengaturan reasoning seperti
reasoning_effortuntuk model bertandareasoning: true, dan untuk model yang dikenalnya dari ID-nya sebagai model reasoning. Provider yang tidak menerimanya menolak permintaan itu (400 upstream_bad_request): isireasoning: falsepada model tersebut.
Semua pengaturannya ada di dokumentasi omp (oh-my-pi).
Pi
buatan Earendil · OpenAI Chat Completions APICoding agent minimalis untuk terminal yang bisa diperluas, dibuat oleh Mario Zechner: membaca dan mengubah file Anda serta menjalankan perintah.
Pasang Pi. Installer juga memasang Node.js bila perlu; dengan Node.js 22.19 atau lebih baru,
npm install -g --ignore-scripts @earendil-works/pi-coding-agentjuga bisa. Setelah itupi --versionmenampilkan versinya.macOS, Linuxcurl -fsSL https://pi.dev/install.sh | sh
Windows (PowerShell)powershell -c "irm https://pi.dev/install.ps1 | iex"
Simpan API key Anda di variabel lingkungan
AITER_API_KEYpada terminal tempat Anda menjalankan Pi: Pi membacanya dari sana, sehingga key tidak tertulis di file Pi. Variabel ini hilang saat terminal ditutup. Agar tetap ada, tambahkan baris itu ke~/.zshrc(macOS) atau~/.bashrc(Linux); di Windows, jalankan sekalisetx AITER_API_KEY "API_KEY_ANDA"lalu buka terminal baru.macOS, Linuxexport AITER_API_KEY="API_KEY_ANDA"
Windows (PowerShell)$env:AITER_API_KEY = "API_KEY_ANDA"
Tambahkan layanan ini ke
~/.pi/agent/models.json(di Windows%USERPROFILE%\.pi\agent\models.json): buat file dengan isi ini, atau tambahkan entriaiterkeprovidersdi file yang sudah ada. Tambahkan satu entri dimodelsuntuk setiap model yang Anda pakai;contextWindowdanmaxTokensdijelaskan di catatan.~/.pi/agent/models.json{ "providers": { "aiter": { "name": "Sider", "baseUrl": "https://sider.ai.id/v1", "api": "openai-completions", "apiKey": "$AITER_API_KEY", "compat": { "supportsDeveloperRole": false, "maxTokensField": "max_tokens" }, "models": [ { "id": "gemini-3.1-pro", "contextWindow": 128000, "maxTokens": 8192 } ] } } }Jalankan Pi di folder proyek Anda dengan model ini, lalu kirim permintaan singkat, misalnya Reply with only OK: jawabannya datang dari
gemini-3.1-prolewat layanan ini. Agar Pi selalu mulai dengan model ini, buka/model, pilih model itu, lalu tekan Ctrl+S. Bila Pi menjawabNo API key found for aiter,AITER_API_KEYbelum diisi di terminal ini.Terminal, di folder proyek Andapi --model aiter/gemini-3.1-pro
Perlu diketahui
- Pi mengubah file dan menjalankan perintah lewat tool call: pakai model yang mendukung tool calling (function calling).
contextWindowadalah jendela konteks model dalam token: Pi meringkas percakapan sebelum jendela itu penuh, dan meringkas lalu mencoba lagi bila layanan ini menjawab400 context_length_exceeded. Isi dengan jendela model itu dari tab Model dashboard Anda, ataucontext_length-nya diGET https://sider.ai.id/v1/modelsdengan API key Anda, bila tercantum.maxTokensadalah jawaban terpanjang yang diminta Pi: 8192 cocok untuk kebanyakan model; naikkan untuk model yang mengizinkan jawaban lebih panjang, atau turunkan bila permintaan gagal dengan400 upstream_bad_requesttentang batas output. Dengan batas token harian, setiap permintaan memesan prompt-nya ditambahmaxTokenssampai selesai.supportsDeveloperRole: falsemembuat instruksi Pi tetap dikirim sebagai pesansystem, yang diterima semua provider yang kompatibel dengan OpenAI, juga untuk model bertandareasoning; layanan ini meneruskan pesandeveloperapa adanya, dan provider model lain bisa menolaknya.maxTokensField: "max_tokens"mengirim batas output di field yang dibaca provider di belakang layanan ini; tanpa itu Pi mengirimmax_completion_tokens, yang diabaikan sebagian provider. Model reasoning OpenAI (seri o, GPT-5) menolakmax_tokens(400 upstream_bad_request): beri model seperti itu"compat": { "maxTokensField": "max_completion_tokens" }di entrinya.- Pi tidak mengirim
reasoning_effortuntuk model ini, sehingga setiap model berpikir seperti bawaan providernya; proses berpikirnya tampil bila provider mengirimkannya. Tambahkan"reasoning": trueke sebuah model hanya bila providernya menerimareasoning_effort:/thinkinglalu mengatur levelnya. Provider model lain menolaknya. - Bila permintaan gagal:
401 invalid_api_keyberarti key diAITER_API_KEYsalah atau sudah di-regenerate;404 model_not_foundberarti key ini tidak bisa memakai model dengan ID itu (huruf besar dan kecil dibedakan). Pi membaca$AITER_API_KEYdengan cara ini sejak versi 0.77: perbarui Pi yang lebih lama denganpi update, atau pasang ulang seperti di langkah 1 bila Pi Anda dari paket lama@mariozechner/pi-coding-agent.
Semua pengaturannya ada di dokumentasi Pi.