3 Penyebab Utama dan Solusi Perbaikan untuk Masalah Pemutusan Koneksi yang Sering Terjadi pada OpenCode Saat Menggunakan Model Claude

"Kenapa saya sering mengalami putus koneksi saat menggunakan model Claude di OpenCode?"—ini adalah masalah yang paling sering dikeluhkan oleh para pengembang yang menggunakan OpenCode (sekarang berganti nama menjadi Crush) untuk mengakses model Claude. Penyebab utamanya sangat sederhana: OpenCode menggunakan SDK asli Anthropic untuk memanggil Claude, sementara banyak layanan proksi API pihak ketiga hanya mendukung format yang kompatibel dengan OpenAI. Ketidakcocokan format inilah yang menyebabkan error dan pemutusan koneksi yang sering terjadi.

Nilai Utama: Setelah membaca artikel ini, Anda akan memahami arsitektur dasar pemanggilan Claude di OpenCode, 3 penyebab umum gangguan koneksi, dan solusi lengkap untuk mengatasinya secara tuntas menggunakan antarmuka format asli Anthropic dari APIYI.

Apa itu OpenCode: Dari OpenCode ke Crush

OpenCode adalah asisten pengodean AI berbasis terminal yang ditulis dalam bahasa Go, menggunakan kerangka kerja Bubble Tea untuk membangun TUI (Terminal User Interface) yang elegan. Proyek ini telah mendapatkan 11.600+ bintang di GitHub, dan kemudian diakuisisi oleh tim Charm, berganti nama menjadi Crush (charmbracelet/crush, 22.200+ bintang).

Perbedaan Utama OpenCode dengan Claude Code dan Aider

Perbedaan Kunci: OpenCode menggunakan SDK asli untuk setiap penyedia AI, bukan melalui format yang kompatibel dengan OpenAI. Ini berarti saat memanggil Claude, ia menggunakan Messages API asli Anthropic (/v1/messages), bukan Chat Completions API milik OpenAI (/v1/chat/completions).

🎯 Catatan Penting: Inilah akar permasalahannya—jika layanan proksi Anda hanya menyediakan antarmuka /v1/chat/completions, SDK asli Anthropic milik OpenCode tidak dapat melakukan pemanggilan dengan benar. APIYI (apiyi.com) mendukung format kompatibel OpenAI dan format asli Anthropic, yang dapat menyelesaikan masalah ini sepenuhnya.

3 Penyebab Utama Claude Sering Terputus di OpenCode

Penyebab 1: Format API Tidak Cocok (Paling Sering)

Ini adalah akar masalah yang dialami oleh 90% pengguna.

Jalur pemanggilan Claude di OpenCode:

OpenCode → Anthropic Go SDK → POST /v1/messages
                                ↑ Menggunakan format asli Anthropic

Banyak layanan proksi API hanya menyediakan:

Layanan proksi → Hanya mendukung POST /v1/chat/completions
                      ↑ Format kompatibel OpenAI

Struktur permintaan dari kedua format ini sangat berbeda:

Ketika OpenCode mengirim permintaan format Anthropic ke endpoint yang hanya mendukung format OpenAI, server tidak dapat mengurai permintaan tersebut dan langsung mengembalikan error atau memutus koneksi.

Penyebab 2: Gangguan Transmisi Streaming

OpenCode menggunakan Messages.NewStreaming() dari Anthropic SDK untuk respons streaming. Urutan kejadian selama transmisi streaming adalah:

ContentBlockStartEvent → ContentBlockDeltaEvent (berulang) → ContentBlockStopEvent → MessageStopEvent

Jika layanan proksi API tidak mendukung format streaming Anthropic secara lengkap (misalnya tidak mengembalikan event thinking_delta, atau format content_block_stop tidak benar), penguraian event oleh OpenCode akan gagal dan koneksi terputus.

Logika percobaan ulang (retry) OpenCode hanya mencakup HTTP 429 (limit rate) dan 529 (overload). Kode error lainnya akan langsung dihentikan dan tidak akan dicoba ulang. Artinya, respons 400/500 yang disebabkan oleh kesalahan format akan langsung gagal.

Penyebab 3: Perbedaan Format Pemikiran Luas dan Pemanggilan Alat

OpenCode memiliki logika penanganan khusus untuk pemikiran luas (extended thinking) Claude:

• Diaktifkan secara otomatis saat pesan pengguna mengandung kata kunci "think"
• Setelah diaktifkan, 80% dari maxTokens dialokasikan sebagai anggaran pemikiran
• Suhu (temperature) dipaksa ke 1.0

Jika layanan proksi API tidak mendukung format blok thinking asli dari Anthropic, konten pemikiran akan hilang atau menyebabkan kesalahan penguraian. Begitu pula dengan format tool_use / tool_result asli Anthropic yang sangat berbeda dengan format function_call / tool_calls milik OpenAI.

Solusi: Gunakan Endpoint API yang Mendukung Format Asli Anthropic

Arsitektur Dukungan Format Ganda APIYI

APIYI (apiyi.com) mendukung kedua format API secara bersamaan, sehingga pengembang dapat memilih sesuai kebutuhan alat mereka:

Solusi 1: Konfigurasi Format Asli Anthropic di OpenCode (Direkomendasikan)

Karena penyedia Anthropic di OpenCode tidak secara langsung mengekspos opsi konfigurasi Base URL, Anda perlu mengaturnya melalui variabel lingkungan:

# Atur Kunci API Anthropic (gunakan Kunci dari APIYI)
export ANTHROPIC_API_KEY="sk-kunciAPIYIanda"

# Atur Base URL Anthropic (arahkan ke antarmuka asli APIYI)
export ANTHROPIC_BASE_URL="https://api.apiyi.com"

# Jalankan OpenCode
opencode

Atau atur di file konfigurasi .opencode.json:

{
  "providers": {
    "anthropic": {
      "apiKey": "sk-kunciAPIYIanda"
    }
  },
  "agents": {
    "coder": {
      "model": "claude-sonnet-4-6",
      "maxTokens": 16000
    },
    "task": {
      "model": "claude-haiku-4-5-20251001",
      "maxTokens": 8000
    }
  }
}

Gunakan bersama variabel lingkungan:

# Tambahkan ke .bashrc atau .zshrc
export ANTHROPIC_API_KEY="sk-kunciAPIYIanda"
export ANTHROPIC_BASE_URL="https://api.apiyi.com"

Dengan cara ini, OpenCode akan memanggil https://api.apiyi.com/v1/messages melalui SDK asli Anthropic, sehingga mempertahankan semua fungsi asli: Prompt Caching, pemikiran luas, dan pemanggilan alat asli.

Solusi 2: Menggunakan Format Kompatibel OpenAI melalui Local Provider (Cadangan)

Jika Solusi 1 tidak berhasil, Anda dapat mengonfigurasi APIYI sebagai Local Provider di OpenCode:

# Atur endpoint lokal
export LOCAL_ENDPOINT="https://api.apiyi.com/v1"
export LOCAL_API_KEY="sk-kunciAPIYIanda"

{
  "providers": {
    "local": {
      "apiKey": "sk-kunciAPIYIanda"
    }
  },
  "agents": {
    "coder": {
      "model": "claude-sonnet-4-6",
      "maxTokens": 16000
    }
  }
}

Catatan: Solusi ini menggunakan format kompatibel OpenAI (/v1/chat/completions), yang akan menghilangkan fungsi asli berikut:

• Prompt Caching (hit cache)
• Pemikiran luas asli (blok thinking)
• Format pemanggilan alat asli Anthropic

💡 Saran: Prioritaskan Solusi 1 (format asli Anthropic) untuk mendapatkan fungsi lengkap dan stabilitas terbaik.
Saat mengambil Kunci di dasbor APIYI (apiyi.com), pilih grup 【ClaudeCode】 untuk menikmati diskon 88%.

Panduan Lengkap Pemanggilan API Claude di APIYI

Mendapatkan dan Mengonfigurasi Kunci API

Dua Format Permintaan yang Didukung

Format 1: Format Asli Anthropic (Direkomendasikan untuk OpenCode/Claude Code)

Alamat permintaan: https://api.apiyi.com/v1/messages

import anthropic

client = anthropic.Anthropic(
    api_key="sk-kunciAPIYIAnda",
    base_url="https://api.apiyi.com"
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=4096,
    messages=[
        {"role": "user", "content": "Tuliskan algoritma quicksort menggunakan Python"}
    ]
)
print(message.content[0].text)

Format 2: Format Kompatibel OpenAI (Direkomendasikan untuk Aider/Cursor/Aplikasi Mandiri)

Alamat permintaan: https://api.apiyi.com/v1/chat/completions

import openai

client = openai.OpenAI(
    api_key="sk-kunciAPIYIAnda",
    base_url="https://api.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "user", "content": "Tuliskan algoritma quicksort menggunakan Python"}
    ]
)
print(response.choices[0].message.content)

Daftar Model Claude yang Didukung

Model Utama Terbaru (Direkomendasikan):

Model Penalaran (Mengaktifkan pemikiran tambahan secara paksa):

Model penalaran menggunakan model dasar yang sama dengan model standar, perbedaannya adalah model penalaran akan memaksa aktivasi pemikiran tambahan (thinking), menghasilkan proses penalaran yang lebih detail, cocok untuk skenario yang memerlukan analisis mendalam.

import anthropic

client = anthropic.Anthropic(
    api_key="sk-kunciAPIYIAnda",
    base_url="https://api.apiyi.com"
)

# Menggunakan model thinking, memaksa pemikiran tambahan
message = client.messages.create(
    model="claude-sonnet-4-6-thinking",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000  # Anggaran Token untuk pemikiran
    },
    messages=[
        {"role": "user", "content": "Analisis kompleksitas waktu kode ini dan optimalkan"}
    ]
)

for block in message.content:
    if block.type == "thinking":
        print(f"Proses berpikir:\n{block.thinking}")
    elif block.type == "text":
        print(f"Jawaban akhir:\n{block.text}")

🚀 Mulai Cepat: Kunjungi APIYI api.apiyi.com/token untuk mendapatkan kunci API,
pilih grup 【ClaudeCode】 untuk menikmati diskon 12%.
Satu kunci mendukung format asli Anthropic dan format kompatibel OpenAI,
kompatibel dengan semua alat coding AI utama seperti OpenCode, Claude Code, Aider, dan Cursor.

Cara Integrasi Terbaik untuk Berbagai Alat Coding AI

Panduan Cepat Konfigurasi Alat

OpenCode/Crush:

export ANTHROPIC_API_KEY="sk-kunciAPIYIAnda"
export ANTHROPIC_BASE_URL="https://api.apiyi.com"

Claude Code:

export ANTHROPIC_API_KEY="sk-kunciAPIYIAnda"
export ANTHROPIC_BASE_URL="https://api.apiyi.com"
claude

Aider:

export OPENAI_API_KEY="sk-kunciAPIYIAnda"
export OPENAI_API_BASE="https://api.apiyi.com/v1"
aider --model claude-sonnet-4-6

🎯 Manajemen Terpadu: Kelola semua pemanggilan API alat coding AI Anda dengan satu kunci dari APIYI apiyi.com,
mendukung 300+ model termasuk Claude, GPT, Gemini, dengan penagihan dan manajemen yang terpusat.

Pertanyaan Umum

Ringkasan: Pilih Format API yang Tepat, Claude Berjalan Stabil di OpenCode

Penyebab utama sering terputusnya koneksi model Claude di OpenCode/Crush adalah ketidakcocokan format API—OpenCode menggunakan format asli Anthropic, sementara banyak layanan proksi API hanya mendukung format yang kompatibel dengan OpenAI.

Solusinya sangat jelas:

1. Gunakan layanan API yang mendukung format asli Anthropic — Titik akhir /v1/messages dari APIYI.
2. Konfigurasikan variabel lingkungan yang benar — ANTHROPIC_BASE_URL=https://api.apiyi.com
3. Pilih model yang sesuai — Gunakan claude-sonnet-4-6 untuk penggunaan harian, dan claude-sonnet-4-6-thinking untuk penalaran mendalam.

Kami merekomendasikan penggunaan APIYI (apiyi.com) untuk mengelola semua pemanggilan model API pada alat pengodean AI Anda secara terpusat. Kunjungi api.apiyi.com/token untuk mendapatkan kunci API, dan pilih grup 【ClaudeCode】 untuk menikmati diskon 12%. Satu kunci API kompatibel dengan format asli Anthropic maupun format yang kompatibel dengan OpenAI, sehingga cocok untuk semua alat pengodean AI utama di pasaran.

📝 Penulis Artikel: Tim Teknis APIYI | APIYI apiyi.com – Platform akses terpadu untuk 300+ API Model Bahasa Besar

Referensi

1. Repositori GitHub OpenCode (Diarsipkan): Kode proyek dan dokumentasi asli

   • Tautan: github.com/opencode-ai/opencode
   • Keterangan: Telah berganti nama menjadi Crush

2. Repositori GitHub Crush: Proyek penerus yang sedang dikembangkan secara aktif

   • Tautan: github.com/charmbracelet/crush
   • Keterangan: Versi terbaru yang dikelola oleh tim Charm

3. Dokumentasi API Anthropic: Spesifikasi format asli Messages API

   • Tautan: docs.anthropic.com/en/api/messages
   • Keterangan: Format permintaan dan respons lengkap untuk titik akhir /v1/messages

4. Dokumentasi APIYI: Panduan akses API Claude

   • Tautan: apiyi.com
   • Keterangan: Mendukung format asli Anthropic dan format yang kompatibel dengan OpenAI secara bersamaan