3 Langkah Konfigurasi OpenCode Mengakses Stasiun Relay API, Membuka Akses 400+ Model AI Secara Bebas

Ingin menggunakan OpenCode, asisten pemrograman AI sumber terbuka ini, tapi terhalang harga API resmi yang mahal atau jaringan yang tidak stabil? Layanan API proxy adalah solusi terbaik untukmu. Artikel ini akan memandu kamu 3 langkah mudah menghubungkan OpenCode ke layanan proxy seperti APIYI, OpenRouter, dll., sehingga kamu bisa mengakses 75+ Model Bahasa Besar populer seperti Claude, GPT-4, dan Gemini dengan biaya lebih rendah.

Nilai Inti: Setelah membaca artikel ini, kamu akan belajar cara mengonfigurasi OpenCode untuk menggunakan API apa pun yang kompatibel dengan OpenAI, memungkinkan pergantian model yang bebas dan optimalisasi biaya.

Apa itu OpenCode? Mengapa Harus Menggunakan API Proxy?

OpenCode adalah asisten pemrograman AI berbasis terminal sumber terbuka, yang sering disebut sebagai alternatif open-source untuk Claude Code. Dikembangkan dengan bahasa Go, alat ini menawarkan antarmuka TUI yang cantik, manajemen sesi ganda, integrasi LSP, dan berbagai fitur profesional lainnya.

Sekilas Fitur Utama OpenCode

Mengapa Harus Menggunakan API Proxy?

Menggunakan API resmi secara langsung mungkin menghadapi masalah berikut:

🚀 Mulai Cepat: Direkomendasikan menggunakan APIYI apiyi.com sebagai proxy. Mereka menyediakan antarmuka yang kompatibel dengan OpenAI dan langsung bisa digunakan. Daftar sekarang untuk mendapatkan kuota uji coba gratis, dan selesaikan konfigurasi OpenCode dalam 5 menit.

Poin Inti Menghubungkan OpenCode ke API Relay

Sebelum mulai konfigurasi, mari pahami dulu prinsip koneksi API di OpenCode:

Penjelasan Arsitektur Konfigurasi

OpenCode menggunakan sistem manajemen konfigurasi terpadu yang mendukung pelapisan konfigurasi (override) di berbagai level:

Prinsip Koneksi API Relay

OpenCode mendukung API apa pun yang kompatibel dengan OpenAI melalui adapter @ai-sdk/openai-compatible. Item konfigurasi utamanya adalah:

• baseURL: Alamat interface dari API Relay
• apiKey: API Key yang disediakan oleh Relay
• models: Daftar model yang tersedia

Ini berarti selama Relay menyediakan interface /v1/chat/completions yang standar, Anda bisa langsung menghubungkannya ke OpenCode.

Konfigurasi Cepat OpenCode

Langkah 1: Instal OpenCode

OpenCode menyediakan berbagai metode instalasi, pilih yang paling sesuai untukmu:

Skrip instalasi sekali klik (Direkomendasikan):

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

Instalasi via Homebrew (macOS/Linux):

brew install opencode-ai/tap/opencode

Instalasi via npm:

npm i -g opencode-ai@latest

Instalasi via Go:

go install github.com/opencode-ai/opencode@latest

Verifikasi instalasi berhasil:

opencode --version

Langkah 2: Konfigurasi API Key Relay

OpenCode mendukung dua metode autentikasi:

Metode 1: Menggunakan perintah /connect (Direkomendasikan)

Setelah menjalankan OpenCode, masukkan perintah /connect:

opencode
# Masukkan di antarmuka TUI
/connect

Pilih Other untuk menambahkan Provider kustom, lalu masukkan API Key Anda. Key akan disimpan dengan aman di ~/.local/share/opencode/auth.json.

Metode 2: Konfigurasi Variabel Lingkungan

Tambahkan baris berikut di file ~/.zshrc atau ~/.bashrc:

# Konfigurasi Relay APIYI
export OPENAI_API_KEY="sk-your-apiyi-key"
export OPENAI_BASE_URL="https://api.apiyi.com/v1"

Aktifkan konfigurasi:

source ~/.zshrc

Langkah 3: Buat File Konfigurasi opencode.json

Ini adalah langkah paling krusial, buat file konfigurasi untuk menentukan API Relay:

Konfigurasi Global (berlaku untuk semua proyek):

mkdir -p ~/.config/opencode
touch ~/.config/opencode/opencode.json

Konfigurasi Proyek (hanya berlaku untuk proyek saat ini):

touch opencode.json  # Di root proyek

Contoh Konfigurasi Minimalis

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI",
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4"
        },
        "gpt-4o": {
          "name": "GPT-4o"
        }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514"
}

Penjelasan Konfigurasi: Sintaks {env:OPENAI_API_KEY} akan membaca variabel lingkungan secara otomatis untuk menghindari hardcoding key di file konfigurasi. API Key yang didapatkan melalui APIYI (apiyi.com) kompatibel dengan format OpenAI dan bisa langsung digunakan.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI (Direkomendasikan)",
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "{env:APIYI_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4",
          "limit": {
            "context": 200000,
            "output": 65536
          }
        },
        "claude-opus-4-20250514": {
          "name": "Claude Opus 4",
          "limit": {
            "context": 200000,
            "output": 32000
          }
        },
        "gpt-4o": {
          "name": "GPT-4o",
          "limit": {
            "context": 128000,
            "output": 16384
          }
        },
        "gpt-4o-mini": {
          "name": "GPT-4o Mini",
          "limit": {
            "context": 128000,
            "output": 16384
          }
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro",
          "limit": {
            "context": 1000000,
            "output": 65536
          }
        },
        "deepseek-chat": {
          "name": "DeepSeek V3",
          "limit": {
            "context": 64000,
            "output": 8192
          }
        }
      }
    },
    "openrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenRouter",
      "options": {
        "baseURL": "https://openrouter.ai/api/v1",
        "apiKey": "{env:OPENROUTER_API_KEY}",
        "headers": {
          "HTTP-Referer": "https://your-site.com",
          "X-Title": "OpenCode Client"
        }
      },
      "models": {
        "anthropic/claude-sonnet-4": {
          "name": "Claude Sonnet 4 (OpenRouter)"
        },
        "openai/gpt-4o": {
          "name": "GPT-4o (OpenRouter)"
        }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514",
  "small_model": "apiyi/gpt-4o-mini",
  "agent": {
    "coder": {
      "model": "apiyi/claude-sonnet-4-20250514",
      "maxTokens": 8000
    },
    "planner": {
      "model": "apiyi/gpt-4o",
      "maxTokens": 4000
    }
  },
  "tools": {
    "write": true,
    "bash": true,
    "glob": true,
    "grep": true
  }
}

Perbandingan Agregator API yang Didukung OpenCode

Parameter Konfigurasi Agregator API Populer

Detail Konfigurasi APIYI

APIYI adalah platform agregator API AI yang dioptimalkan khusus untuk developer, menyediakan:

• Antarmuka seragam yang kompatibel dengan OpenAI
• Mendukung model utama seperti Claude, GPT, Gemini, DeepSeek, dll.
• Bayar sesuai pemakaian, tanpa biaya bulanan
• Kuota uji coba gratis
• Dukungan layanan pelanggan dalam Bahasa Mandarin

{
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI",
      "options": {
        "baseURL": "https://api.apiyi.com/v1"
      },
      "models": {
        "claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
        "claude-opus-4-20250514": { "name": "Claude Opus 4" },
        "gpt-4o": { "name": "GPT-4o" },
        "gpt-4o-mini": { "name": "GPT-4o Mini" },
        "gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
        "deepseek-chat": { "name": "DeepSeek V3" }
      }
    }
  }
}

Detail Konfigurasi OpenRouter

OpenRouter menggabungkan lebih dari 400 model AI, cocok untuk skenario yang memerlukan pergantian model secara sering:

{
  "provider": {
    "openrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenRouter",
      "options": {
        "baseURL": "https://openrouter.ai/api/v1",
        "apiKey": "{env:OPENROUTER_API_KEY}",
        "headers": {
          "HTTP-Referer": "https://your-app.com",
          "X-Title": "My OpenCode App"
        }
      },
      "models": {
        "anthropic/claude-sonnet-4": {
          "name": "Claude Sonnet 4"
        },
        "google/gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro"
        },
        "meta-llama/llama-3.1-405b": {
          "name": "Llama 3.1 405B"
        }
      }
    }
  }
}

💡 Saran Pemilihan: Jika Anda terutama menggunakan model seri Claude dan GPT, direkomendasikan menggunakan APIYI apiyi.com karena harganya lebih terjangkau dan responnya cepat. Jika butuh menggunakan model open-source atau model khusus, OpenRouter memiliki cakupan yang lebih lengkap.

Tips Konfigurasi Lanjutan OpenCode

Strategi Alokasi Model Agent

OpenCode memiliki dua Agent bawaan, yaitu Coder dan Planner. Kamu bisa mengalokasikan model yang berbeda untuk masing-masing Agent:

{
  "agent": {
    "coder": {
      "model": "apiyi/claude-sonnet-4-20250514",
      "maxTokens": 8000,
      "description": "Tugas pengkodean utama, menggunakan model yang kuat"
    },
    "planner": {
      "model": "apiyi/gpt-4o-mini",
      "maxTokens": 4000,
      "description": "Perencanaan dan analisis, menggunakan model ringan untuk menghemat biaya"
    }
  }
}

Perpindahan Antar Provider

Setelah mengonfigurasi beberapa Provider, kamu bisa berpindah model kapan saja menggunakan perintah /models di OpenCode:

# Jalankan OpenCode
opencode

# Berpindah model di TUI
/models
# Pilih apiyi/claude-sonnet-4-20250514 atau model lainnya

Praktik Terbaik Variabel Lingkungan

Disarankan untuk mengelola kunci API di dalam file .env:

# File .env
APIYI_API_KEY=sk-your-apiyi-key
OPENROUTER_API_KEY=sk-or-your-openrouter-key

Kemudian referensikan di dalam opencode.json:

{
  "provider": {
    "apiyi": {
      "options": {
        "apiKey": "{env:APIYI_API_KEY}"
      }
    }
  }
}

Konfigurasi Batasan Token

Tentukan batasan konteks dan output untuk model guna menghindari error akibat melampaui batas:

{
  "models": {
    "claude-sonnet-4-20250514": {
      "name": "Claude Sonnet 4",
      "limit": {
        "context": 200000,
        "output": 65536
      }
    }
  }
}

Pemecahan Masalah Umum OpenCode

Berikut adalah beberapa masalah yang mungkin kamu temui selama proses konfigurasi beserta solusinya:

"baseURL": "https://api.apiyi.com/v1"

"baseURL": "https://api.apiyi.com/v1/chat/completions"

{
  "provider": {
    "apiyi": {
      "models": {
        "claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514"
}

# Melihat informasi autentikasi yang sudah dikonfigurasi
opencode auth list

# Melihat model yang tersedia
opencode
/models

# Mengetes percakapan sederhana
opencode -p "Halo, tolong balas dalam bahasa Indonesia"

opencode
/models
# Cukup pilih model di bawah Provider yang berbeda untuk berpindah

{
  "model": "apiyi/claude-sonnet-4-20250514"
}

OpenCode vs Claude Code: Perbandingan Metode Akses API

🎯 Saran Teknis: Keunggulan terbesar OpenCode adalah fleksibilitas modelnya. Dengan bantuan proxy APIYI apiyi.com, Anda bisa menggunakan konfigurasi yang sama untuk berganti-ganti antara berbagai model seperti Claude, GPT-4, Gemini, dan lainnya guna menemukan solusi dengan rasio performa dan harga terbaik.

Referensi

Berikut adalah beberapa referensi yang mungkin Anda butuhkan saat mengonfigurasi OpenCode:

Kesimpulan

Melalui metode konfigurasi 3 langkah dalam artikel ini, Anda telah menguasai:

1. Menginstal OpenCode: Menggunakan skrip satu klik atau manajer paket untuk instalasi cepat.
2. Mengonfigurasi Kunci API: Mengatur autentikasi melalui /connect atau variabel lingkungan.
3. Membuat File Konfigurasi: Menulis opencode.json untuk menentukan stasiun perantara dan model.

Sebagai asisten pemrograman AI berbasis terminal yang open-source, OpenCode yang digunakan bersama stasiun perantara API dapat memberikan pengalaman yang setara dengan Claude Code, sembari menjaga biaya tetap terkendali dan fleksibilitas model tetap terjaga.

Direkomendasikan untuk mendapatkan kunci API dengan cepat melalui APIYI apiyi.com dan mulai melakukan pengujian. Platform ini menyediakan kuota gratis, mendukung model-model utama seperti Claude, GPT, Gemini, dan format antarmuka yang seragam membuat konfigurasi menjadi lebih mudah.

📝 Penulis: Tim Teknis APIYI | APIYI apiyi.com – Membuat pemanggilan AI API menjadi lebih sederhana