Alat coding

OpenCode

Konfigurasikan OpenCode untuk menggunakan TokenLab API

Serahkan pengaturan kepada agen saya

Salin tugas ini ke agen yang sudah berfungsi di komputer Anda:

Baca panduan ini dan bantu saya menghubungkan OpenCode ke TokenLab:
https://tokenlab.sh/docs/id/integrations/opencode
Periksa terlebih dahulu versi yang terpasang dan konfigurasi yang aktif.
Pertahankan akun, penyedia, izin, dan pengaturan lain yang sudah ada.
Cadangkan file lokal dan tampilkan perubahan yang diusulkan.
Biarkan saya memasukkan kunci API yang diperlukan secara lokal; jangan pernah meminta, menampilkan, atau menempelkannya di chat.
Periksa terlebih dahulu apakah konfigurasi dapat dimuat.
Jelaskan secara terpisah biaya setiap pengujian yang mengirim permintaan berbayar sebelum menjalankannya.

Ringkasan

OpenCode adalah asisten coding AI open-source yang berjalan di terminal Anda. Ini mendukung banyak penyedia LLM dan dapat dikonfigurasikan untuk menggunakan API TokenLab guna mengakses ratusan model.

Jenis: Alat coding

Jalur utama: kompatibel OpenAI

Tingkat dukungan: Jalur yang didukung

Instalasi

OpenCode

npm install -g opencode-ai@1.18.31

Verifikasi instalasi:

opencode --version

Konfigurasi

Langkah 1: Atur Environment Variable

Ikuti langkah terminal panduan cepat untuk macOS, Linux, WSL, atau Windows PowerShell guna mengatur TOKENLAB_API_KEY tanpa menulis kunci ke riwayat perintah. Jalankan OpenCode dari terminal tersebut. Untuk penggunaan berkelanjutan, gunakan pengelola rahasia lokal, bukan kunci teks biasa di profil shell.

Langkah 2: Konfigurasikan OpenCode

Konfigurasi berikut telah diperiksa dengan OpenCode 1.18.31. Versi lain perlu diverifikasi sendiri berdasarkan dokumentasi resminya.

Simpan konfigurasi di file terpisah ~/.config/opencode/tokenlab.jsonc. Jika XDG_CONFIG_HOME diatur, gunakan opencode/tokenlab.jsonc di direktori tersebut. Pertahankan opencode.json / opencode.jsonc biasa, akun, model default, dan izin. File terpisah ini hanya dimuat saat peluncuran memilihnya melalui OPENCODE_CONFIG. Jika file atau nama penyedia sudah dipakai, pilih nama lain dan sesuaikan perintah.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenlab": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenLab",
      "options": {
        "baseURL": "https://api.tokenlab.sh/v1",
        "apiKey": "{env:TOKENLAB_API_KEY}"
      },
      "models": {
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        }
      }
    }
  }
}

Konfigurasi ini mengirim Chat Completions melalui @ai-sdk/openai-compatible. Periksa dukungan Chat Completions dan alat yang diperlukan pada detail model saat ini. Contoh ini tidak membuktikan kompatibilitas protokol atau versi lain.

Opsional: helper konfigurasi OpenCode yang dapat dipulihkan menyediakan pratinjau, penerapan, dan pemulihan file asli dengan Python 3.11+. Plugin TokenLab Skills 0.1.2 menyertakan skrip ini; Skill mandiri juga dapat digunakan setelah diperbarui ke versi yang memuatnya. Untuk plugin atau Skill mandiri yang sudah terpasang, ikuti petunjuk pembaruan README dan pastikan skrip tersedia. Konfigurasi manual di halaman ini tetap dapat digunakan tanpa helper.

Penggunaan Dasar

Atur kunci sesuai panduan cepat, lalu muat file hanya untuk peluncuran ini dan pilih model secara eksplisit. Sesuaikan path serta nama penyedia kustom. Pertahankan pengaturan OPENCODE_CONFIG atau OPENCODE_CONFIG_CONTENT yang sudah ada dalam lingkungan peluncuran terpisah; pengaturan proyek atau terkelola masih dapat memiliki prioritas.

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode models tokenlab
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode --model tokenlab/gpt-5.6-terra

Daftar model memeriksa pemuatan lokal, bukan validitas kunci atau keberhasilan permintaan langsung. Prompt memakai saldo TokenLab dan OpenCode dapat mengirim permintaan tambahan yang ditagih terpisah, seperti pembuatan judul. Periksa respons dan catatan permintaan terkait.

Jalankan tanpa file ini untuk memakai pengaturan biasa. Jangan menyimpan OPENCODE_CONFIG dalam profil shell untuk panduan ini. Untuk membatalkan konfigurasi manual, hapus hanya file terpisah yang baru dibuat atau pulihkan cadangannya jika sudah ada sebelumnya.

Model yang Tersedia

ModelPaling Cocok Untuk
gpt-5.6-terraTugas kompleks, arsitektur kode
gpt-5.6-lunaPerbaikan cepat, query sederhana
claude-sonnet-4-6Review kode, dokumentasi
claude-opus-4-6Penalaran kompleks
gemini-3.5-flashRespons cepat

Perintah Umum

Analisis kode:

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "What does this function do?" < src/utils.ts

Hasilkan kode:

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Create a REST API with Express"

Review perubahan:

git diff | OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Review these changes"

Perbaiki error:

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Fix the TypeScript errors in this project"

Perintah Interaktif

CommandDeskripsi
/helpTampilkan perintah yang tersedia
/modelsBeralih ke model yang berbeda
/clearHapus riwayat percakapan
/exitKeluar dari OpenCode

Pemecahan Masalah

Praktik Terbaik

Di halaman ini