Alat coding

OpenCode

Konfigurasikan OpenCode untuk menggunakan TokenLab API

Biarkan agen saya yang mengatur ini

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

Read this guide and help me connect OpenCode to TokenLab:
https://tokenlab.sh/docs/id/integrations/opencode
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

Gambaran Umum

OpenCode dapat menggunakan TokenLab melalui penyedia (provider) kustom yang kompatibel dengan OpenAI. Tambahkan TokenLab API key, Base URL, dan ID model saat ini.

Instalasi

OpenCode

npm install -g opencode-ai@1.18.31

Verifikasi instalasi:

opencode --version

Konfigurasi

Langkah 1: Atur Variabel Lingkungan (Environment Variables)

Gunakan instruksi terminal Panduan Cepat untuk macOS, Linux, WSL, atau Windows PowerShell guna mengatur TOKENLAB_API_KEY tanpa memasukkan kunci tersebut ke dalam riwayat perintah. Jalankan OpenCode dari terminal tersebut. Untuk penggunaan permanen, gunakan pengelola rahasia (secret manager) lokal Anda; jangan menambahkan kunci teks biasa ke profil shell Anda.

Langkah 2: Konfigurasi OpenCode

Konfigurasi di bawah ini telah diperiksa dengan OpenCode 1.18.31. Versi lain memerlukan verifikasi mandiri terhadap dokumentasi resmi.

Buat file terpisah ~/.config/opencode/tokenlab.jsonc dengan konfigurasi di bawah ini. Jika XDG_CONFIG_HOME diatur, gunakan opencode/tokenlab.jsonc di bawah direktori tersebut. Biarkan opencode.json / opencode.jsonc, akun, model default, dan izin tetap tidak berubah: file terpisah ini hanya dimuat untuk pemanggilan yang memilihnya dengan OPENCODE_CONFIG. Jika nama file atau penyedia sudah dimiliki oleh pengaturan lain, pilih file/nama yang berbeda dan sesuaikan perintahnya.

{
  "$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 menggunakan @ai-sdk/openai-compatible untuk Chat Completions. Pilih model saat ini yang detailnya mendukung Chat Completions dan alat yang Anda butuhkan; jangan menyimpulkan dukungan untuk protokol atau versi lain dari contoh ini.

Opsional: pembantu pengaturan OpenCode yang dapat dibalik menyediakan pratinjau, penerapan, dan pemulihan file asli dengan Python 3.11+. Plugin TokenLab Skills 0.1.2 menyertakan skrip ini; instalasi Skill mandiri juga dapat digunakan setelah memperbarui ke versi yang memuatnya. Untuk plugin yang sudah ada atau instalasi Skill mandiri, ikuti instruksi pembaruan README dan konfirmasikan bahwa skrip tersebut ada. Konfigurasi manual di sini tetap dapat digunakan tanpa pembantu tersebut.

Penggunaan Dasar

Atur kunci menggunakan Quickstart, lalu muat file ini dan pilih model secara eksplisit untuk pemanggilan ini. Ganti jalur dan nama penyedia Anda yang sebenarnya jika disesuaikan. Simpan pengaturan OPENCODE_CONFIG atau OPENCODE_CONFIG_CONTENT inline yang ada di lingkungan peluncuran terpisah; pengaturan proyek dan pengaturan terkelola mungkin masih lebih diutamakan.

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

Penemuan model memeriksa pemuatan lokal, bukan validitas kunci atau keberhasilan permintaan langsung. Sebuah prompt menggunakan saldo TokenLab dan OpenCode mungkin mengirimkan permintaan tambahan yang ditagih secara terpisah, seperti pembuatan judul. Periksa balasan dan catatan permintaan yang cocok.

Untuk menggunakan pengaturan biasa Anda, luncurkan tanpa lapisan ini. Jangan simpan OPENCODE_CONFIG di profil shell Anda untuk panduan ini. Untuk membatalkan pengaturan manual, hapus hanya file terpisah yang Anda buat, atau pulihkan cadangannya jika ada sebelum pengaturan dilakukan.

Menghasilkan gambar dan video di agen yang sama

OpenCode juga dapat membuat gambar dan video pendek dengan server TokenLab MCP. Setiap pembuatan dibayar dari saldo TokenLab yang sama. Gabungkan entri mcp ini ke dalam tokenlab.jsonc yang sama, di samping provider. OpenCode menggantikan {env:TOKENLAB_API_KEY} dengan variabel dari terminal Anda, sehingga kunci tidak ditulis ke dalam file:

{
  "mcp": {
    "tokenlab": {
      "type": "local",
      "command": ["npx", "-y", "@tokenlabai/mcp-server@0.6.48"],
      "environment": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "{env:TOKENLAB_API_KEY}"
      },
      "timeout": 30000
    }
  }
}

timeout yang lebih lama memberikan waktu bagi npx untuk mengunduh paket pada saat pertama kali dijalankan. Jalankan opencode mcp list dengan OPENCODE_CONFIG yang sama dan periksa apakah tokenlab sudah terhubung. Kemudian coba:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video mengembalikan ID tugas. Agen memanggil get_task_status sampai video siap. Lihat server OpenCode MCP untuk pengaturan lainnya.

Memilih Model

Salin ID model pengkodean saat ini dari halaman Model. Bandingkan model pada repositori Anda sendiri sebelum menetapkan default.

Perintah Umum

Menganalisis 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

Menghasilkan 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"

Meninjau perubahan:

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

Memperbaiki kesalahan:

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

PerintahDeskripsi
/helpMenampilkan perintah yang tersedia
/modelsBeralih ke model yang berbeda
/clearMenghapus riwayat percakapan
/exitKeluar dari OpenCode

Pemecahan Masalah

Tips

Di halaman ini