Instalasi OpenCode dan Konfigurasi OmniProxy

OpenCode adalah asisten pemrograman sumber terbuka yang dapat digunakan untuk menulis kode melalui terminal, IDE, atau desktop. OpenCode juga tidak menyimpan kode dan konteks Anda, sehingga cocok untuk proyek yang mengutamakan privasi. build digunakan untuk memodifikasi proyek, sedangkan plan secara default hanya dapat membaca dan cocok untuk memahami kode yang belum dikenal serta menyusun rencana perubahan terlebih dahulu. Anda dapat memilih layanan model sesuai kebutuhan.

Persiapan sebelum instalasi

Skrip instalasi adalah cara yang paling praktis. Anda memerlukan terminal modern, yaitu program terminal yang dapat menjalankan perintah dan mengelola berkas proyek, seperti WezTerm, Alacritty, Ghostty, atau Kitty. Di Windows, utamakan penggunaan WSL, yaitu alat untuk menjalankan lingkungan Linux di dalam Windows dengan performa dan fitur yang lebih lengkap.

Paling mudah

Skrip instalasi

• curl opencode.ai/install
• Langsung gunakan di macOS Linux
• WSL disarankan untuk Windows

macOS Linux

Tap Homebrew

• anomalyco/tap/opencode
• Diperbarui lebih sering daripada formula
• Paket juga tersedia untuk Arch

Windows native

Pengelola paket

• choco atau scoop
• Atau instal secara global dengan npm
• Dapat juga diunduh dari Rilis

Siapkan juga ID model dari daftar model saat ini. ID model adalah nama yang digunakan layanan untuk mengidentifikasi model tertentu secara akurat.

Instalasi dan peluncuran pertama

Perintah instalasi yang paling mudah digunakan adalah:

curl -fsSL https://opencode.ai/install | bash

Anda juga dapat menggunakan metode instalasi berikut:

• Node.js: npm install -g opencode-ai. Bun, pnpm, dan Yarn juga memiliki perintah instalasi global masing-masing; lihat halaman pengantar pada bagian akhir.
• Homebrew untuk macOS dan Linux: brew install anomalyco/tap/opencode. Gunakan tap ini karena diperbarui lebih sering daripada brew install opencode yang dikelola oleh tim Homebrew.
• Arch Linux: gunakan sudo pacman -S opencode untuk versi stabil. Untuk versi yang lebih baru, gunakan opencode-bin dari AUR.
• Windows: gunakan choco install opencode atau scoop install opencode. Anda juga dapat menggunakan npm install -g opencode-ai. Berkas biner juga dapat diunduh dari Releases. Dukungan instalasi dengan Bun di Windows masih dalam pengembangan.

Masuk ke direktori proyek Anda, lalu jalankan OpenCode:

cd /path/to/project
opencode

Pada penggunaan pertama, Anda dapat menjalankan /init. Perintah ini akan menganalisis proyek dan membuat AGENTS.md di direktori utama proyek. Berkas tersebut dapat dimasukkan ke Git agar petunjuk ini tetap tersimpan bersama proyek.

Mendapatkan parameter koneksi dari OmniProxy

baseURL: https://your-omniproxy-origin.example/v1
API Key: <YOUR_OMNIPROXY_API_KEY>
Model ID: salin ID lengkap dari daftar model OmniProxy saat ini

baseURL adalah alamat layanan, API Key adalah kredensial akses, dan Model ID adalah nama lengkap model.

Saat menggunakan /v1/chat/completions, gunakan paket npm @ai-sdk/openai-compatible. Chat Completions di sini adalah antarmuka permintaan percakapan. Hanya gunakan @ai-sdk/openai jika model memakai /v1/responses. Jika OmniProxy digunakan melalui jalur chat completions, tetap gunakan paket kompatibilitas tersebut.

Salin seluruh ID model dari daftar OmniProxy saat ini, termasuk karakter garis miring. Dua ID pembanding pada 2026-10-09 adalah claude-sonnet-5-5 dan gpt-6-luna. gpt-6-luna mendukung Chat Completions; pemanggilan fungsi di Chat Completions hanya didukung ketika reasoning_effort bernilai none. Jangan menyalin ID yang tidak tersedia dalam daftar.

Mengisi konfigurasi alat

Provider dapat dipahami sebagai sekumpulan konfigurasi yang digunakan OpenCode untuk terhubung ke layanan model. Dokumentasi Provider mengategorikan layanan kompatibel OpenAI yang tidak tersedia dalam daftar /connect sebagai Provider kustom. Layanan kompatibel OpenAI adalah layanan yang menggunakan format permintaan yang sama dan dapat dipanggil oleh jenis klien yang sama.

1. Jalankan /connect di OpenCode, lalu gulir ke Other.
2. Masukkan Provider ID. Contoh berikut menggunakan omniproxy. Pilih ID yang mudah diingat karena ID yang sama harus digunakan dalam berkas konfigurasi.
3. Masukkan API Key OmniProxy. Langkah ini hanya menyimpan kredensial; alamat dan model masih harus ditulis dalam opencode.json. Kredensial disimpan di ~/.local/share/opencode/auth.json.
4. Buat atau ubah opencode.json di direktori proyek:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniproxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniProxy",
      "options": {
        "baseURL": "https://your-omniproxy-origin.example/v1"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "gpt-6-luna": { "name": "GPT-6 Luna" }
      }
    }
  }
}

5. Jalankan /models. Provider kustom dan model akan muncul dalam daftar.

ID dalam /connect harus sama dengan kunci dalam opencode.json. Jangan tulis kunci asli di dalam berkas ini. Jika tidak menggunakan /connect, Anda juga dapat menggunakan format variabel lingkungan di options.apiKey, misalnya {env:nama_variabel}. Dalam pengujian pada 2026-10-09 dengan OpenCode 1.18.34, koneksi juga berhasil ketika kunci ditulis langsung pada options.apiKey proyek tanpa melalui /connect. Jika gateway tidak memvalidasi kunci, nilai ini dapat berupa rangkaian karakter pengganti yang hanya digunakan secara lokal. Kunci dalam models harus menggunakan ID lengkap dari daftar.

Kunci

/connect

• Pilih Other yang paling bawah
• Tentukan sendiri Provider ID
• Disimpan di auth.json

Proyek

opencode.json

• Kunci provider harus menggunakan nama yang sama
• Gunakan paket kompatibilitas untuk npm
• Akhiri baseURL dengan /v1

Pemilihan

/models

• Model muncul dalam daftar
• Pilih satu sebelum bertanya
• Gunakan ID dari daftar gateway

Memverifikasi dengan tugas nyata

Jalankan satu tugas nyata dari direktori proyek. Format referensi model adalah Provider ID/ID model; pertahankan garis miring yang terdapat dalam ID model:

opencode run --model omniproxy/claude-sonnet-5-5 --auto "Jelaskan apa yang dilakukan oleh sebuah berkas yang saya tentukan, tanpa mengubah berkas tersebut."

--auto memungkinkan proses ini menggunakan alat seperti pembaca berkas. Dalam pengujian pada 2026-10-09 dengan OpenCode 1.18.34, isi berkas yang ditentukan berhasil dibaca. Proses pertama memerlukan waktu sekitar dua menit.

Untuk penggunaan interaktif, jalankan opencode, lalu pilih model melalui /models. Dalam penggunaan yang didokumentasikan, Anda dapat memakai @ untuk mencari berkas. Gunakan opencode auth list untuk memastikan kredensial yang disimpan melalui /connect, kemudian periksa sumber dan ID model dalam catatan pemanggilan OmniProxy.

Mulai

opencode dapat dibuka

• Gunakan cd untuk masuk ke proyek terlebih dahulu
• ID terlihat di auth list
• File konfigurasi berada di dalam proyek

Tugas

Kode sudah dibaca

• Tanyakan tentang satu file tertentu
• Lihat penjelasannya
• Gunakan /undo jika tidak sesuai

Catatan

Terlihat di gateway

• Sumbernya adalah OpenCode
• ID model sesuai
• Jangan komit kunci

Kesalahan umum

• OmniProxy tidak tersedia dalam /models: periksa apakah ID dalam /connect sama dengan kunci dalam opencode.json, apakah npm bernilai @ai-sdk/openai-compatible, dan apakah baseURL diakhiri dengan /v1.
• Kredensial tidak ditemukan: jalankan opencode auth list. Provider seperti Bedrock yang mengandalkan variabel lingkungan tidak akan muncul di sini; Provider kustom yang dikonfigurasi melalui /connect seharusnya terlihat.
• Fitur di Windows tidak lengkap: gunakan skrip instalasi di dalam WSL.
• ID model tidak valid: salin kembali ID dari daftar OmniProxy saat ini, lalu ubah kunci dalam models.
• Permintaan menggunakan antarmuka yang salah: untuk chat completions, tetap gunakan @ai-sdk/openai-compatible. Jangan mengganti paket demi antarmuka Responses, kecuali model tersebut di OmniProxy memang menggunakan /v1/responses.

Referensi resmi

Untuk instalasi, lihat Pengenalan OpenCode. Untuk Provider kustom, lihat Providers. Untuk ID model yang digunakan sebagai contoh, lihat Ringkasan model Claude dan GPT-6 Luna.

Ganti setiap placeholder dengan nilai dari konfigurasi OmniProxy Anda sendiri. Jangan pernah menerbitkan kunci asli.

Hasil tersimpan atau HTTP 200 saja tidak membuktikan kompatibilitas Agen penuh. Periksa sumber dan model dalam catatan panggilan OmniProxy.

Sumber resmi · OpenCode ↗