OpenCode: pemasangan, model dan pelancaran pertama

OpenCode ialah ejen pengekodan AI sumber terbuka untuk terminal: alat itu sendiri percuma (lesen MIT), dan anda boleh menyambungkan mana-mana model—daripada Claude dan GPT hinggalah model setempat melalui Ollama. Repositori projek ini sudah melepasi dua ratus ribu bintang di GitHub. Ungkapan “Claude Code percuma dengan mana-mana model” kedengaran menarik, tetapi perlu diperjelas: alatnya percuma; syarat penggunaan bergantung pada model yang anda pilih.

Di bawah ialah segala-galanya berdasarkan dokumentasi rasmi: apakah alat ini, cara memasangnya pada macOS, Linux atau Windows, cara menyambungkan model dan perkara yang perlu dilakukan semasa pelancaran pertama. Terdapat bahagian berasingan tentang kos, kerana “percuma” di sini hanya merujuk kepada alat itu: model memerlukan bayaran, dan perkara inilah yang paling kerap menimbulkan kekeliruan.

Maklumat praktikal tentang penggunaan Ailoot terdapat dalam dokumentasi.

Apakah OpenCode dalam istilah mudah?#

Ringkasnya, OpenCode melakukan perkara yang sama seperti Claude Code: ia menerima tugasan dalam bahasa biasa dan melaksanakannya dalam projek anda. Kedua-duanya berbeza dalam dua perkara. Kodnya terbuka sepenuhnya, jadi anda boleh membaca dan memeriksanya. Alat ini juga tidak terikat pada satu penyedia model: ia berfungsi dengan 75+ penyedia, daripada Anthropic dan OpenAI hinggalah model setempat yang berjalan pada perkakasan anda.

Projek ini dibangunkan oleh pasukan Anomaly. Repositori itu diwujudkan pada 30 April 2025 dan, setakat 4 Oktober 2026, mempunyai lebih daripada 211 ribu bintang dan 28 ribu fork (disahkan melalui permintaan API GitHub). Bahasanya ialah TypeScript. Dokumentasi dikemas kini secara berterusan, jadi arahan di bawah berdasarkan versi semasa.

Jangan kelirukan nama-namanya: pakej npm untuk rangkaian semasa dipanggil opencode-ai, repositorinya ialah anomalyco/opencode, dan arahan terminalnya hanya opencode. Artikel lama mungkin menggunakan alamat sst/opencode: organisasi itu telah menukar namanya dan pautan lama kini menghala ke pautan baharu.

Dikemas kini pada 4 Oktober 2026: pasukan itu mengeluarkan OpenCode 2.0, generasi utama seterusnya bagi alat ini. Arahan pemasangan dan penyambungan model di bawah masih ditulis untuk rangkaian 1.x semasa (dipasang dengan arahan curl -fsSL https://opencode.ai/install | bash; versi semasa setakat 30 September 2026 ialah 1.18.34): versi ini masih disokong secara aktif dan merupakan versi yang dipasang oleh dokumentasi rasmi di opencode.ai/docs. Bahagian berasingan di bawah menerangkan perubahan dalam versi kedua dan masa yang sesuai untuk beralih kepadanya.

Apakah perbezaan OpenCode daripada Claude Code dan Codex?#

Jika anda sudah mempunyai langganan Claude, masuk akal untuk terus menggunakan Claude Code sebagai alat utama—kami mempunyai panduan pemasangan terperinci mengenainya. OpenCode sesuai dalam tiga keadaan: anda mahu bekerja melalui langganan ChatGPT Plus atau GitHub Copilot, mahu menjalankan model setempat tanpa bil API, atau mahu satu antara muka untuk beberapa model. Kami juga mempunyai ulasan dan panduan pemasangan untuk Codex.

Jika anda masih memilih alat, mulakan dengan gambaran keseluruhan ini: alat yang digunakan orang untuk mengekod pada 2026. Jika OpenCode sudah dipasang dan anda perlu menyambungkannya dengan ejen lain dalam Devin Desktop melalui ACP, lihat panduan persediaan tersebut.

Apakah perubahan dalam OpenCode 2.0?#

Versi kedua dipasang dengan arahan curl -fsSL https://opencode.ai/v2/install | bash. Menurut panduan migrasi rasmi (opencode.ai/v2/docs/migrate-v1), kedua-dua versi menggunakan arahan opencode yang sama dan secara lalai tidak lagi dipasang serentak: pemasang v2 menggantikan binari v1, dan sebelum memasang v2 melalui pengurus pakej, dokumentasi secara jelas meminta anda membuang versi v1 terlebih dahulu. Walau bagaimanapun, konfigurasi dibaca daripada fail yang sama—~/.config/opencode/ dan <project>/.opencode/—jadi tetapan, ejen dan pelayan MCP dipindahkan tanpa perlu ditulis semula. Tiga perkara perlu ditulis semula: plugin (API baharu), integrasi dengan API pelayan (protokol telah berubah) dan tetapan terminal (kini satu fail cli.json yang dikongsi, bukannya beberapa fail tui.json).

Dua ciri baharu v2 yang paling ketara ialah seperti berikut. Pertama, Console diperkenalkan—perkhidmatan berbayar untuk pasukan dengan penjejakan penggunaan, belanjawan dan dasar yang dikongsi oleh semua ahli. Kedua, pasukan itu akhirnya mengumumkan harga langganan Go: $10 sebulan untuk Go dan $40 sebulan untuk Go Plus dengan had lebih tinggi (halaman opencode.ai/go, disahkan pada 4 Oktober 2026). Sebelum ini, dokumentasi hanya menyebut “langganan kos rendah” tanpa angka.

Jika anda pengguna baharu dan hanya mahu memasang ejen, ikut arahan di bawah; arahan ini meliputi versi pertama semasa yang disyorkan oleh dokumentasi itu sendiri. Pertimbangkan v2 jika anda memerlukan ciri plugin baharu atau Console untuk pasukan—tetapi bersedia untuk menulis semula sesetengah plugin lama supaya serasi dengan API baharu. Jika anda lebih berminat dengan aplikasi desktop sumber terbuka yang tidak memerlukan terminal, kami mempunyai ulasan ZCode, satu lagi ejen serupa dengan antara mukanya sendiri.

Apakah yang diperlukan sebelum pemasangan?#

Sedikit lagi tentang terminal, kerana inilah satu-satunya bahagian pemasangan yang mungkin tidak berjalan seperti dirancang. OpenCode memaparkan antara muka penuh dengan panel dan penyerlahan dalam terminal, sebab itulah dokumentasi meminta emulator moden. Jika antara muka kelihatan tidak betul selepas pelancaran, pasang dahulu salah satu daripada empat pilihan yang disebut: WezTerm (berfungsi pada semua sistem), Alacritty, Ghostty atau Kitty. Pada Windows, laluan utama ialah melalui WSL; terdapat bahagian khas mengenainya di bawah.

Perkara kedua ialah model. OpenCode berfungsi melalui model yang anda sambungkan: dengan sendirinya, ia tidak memproses permintaan. Terdapat empat pilihan: langganan (ChatGPT Plus, GitHub Copilot, GitLab Duo), kunci API daripada mana-mana penyedia, OpenCode Zen, agregator daripada pasukan itu sendiri, atau model setempat melalui Ollama. Keempat-empat pilihan ini diterangkan dalam bahagian tentang penyambungan model.

Tanpa penerangan projek, ejen perlu meneka arahan binaan, struktur fail dan konvensyen yang digunakan—sebab itulah berlaku “halusinasi”. OpenCode menggunakan fail AGENTS.md untuk tujuan ini. Pendekatan yang sama terpakai kepada Claude Code dan mana-mana ejen lain; hanya nama fail arahan yang berubah.

Bagaimanakah cara memasang OpenCode pada macOS dan Linux?#

Kaedah yang disyorkan ialah pemasang rasmi:

1. Jalankan pemasang

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

   Skrip mengesan sistem anda dan memuat turun OpenCode. Jika arahan tidak ditemui selepas pemasangan, tutup dan buka semula terminal; laluan akan dikesan dalam sesi baharu.

2. Pastikan pemasangan berjaya

   opencode --version
   

   Arahan itu memulangkan nombor versi, yang bermaksud pemasangan berjaya. Respons “command not found” bermakna anda perlu kembali ke langkah pertama: mulakan sesi terminal baharu atau edit PATH secara manual.

Jika anda lebih suka mengurus pakej sendiri, berikut ialah pilihannya:

brew install anomalyco/tap/opencode

npm install -g opencode-ai

Arahan Homebrew sengaja bermula dengan anomalyco/tap/: dokumentasi mengesyorkan tap mereka sendiri kerana pasukan Homebrew lebih jarang mengemas kini formula untuk brew install opencode. Nama pakej yang sama, opencode-ai, turut berfungsi dengan bun, pnpm dan yarn (bun install -g opencode-ai, yarn global add opencode-ai). Pada Arch Linux, gunakan sudo pacman -S opencode daripada repositori stabil atau paru -S opencode-bin untuk mendapatkan versi terkini daripada AUR.

Kemas kini OpenCode dengan opencode upgrade; apabila dilancarkan, ia turut memuat turun kemas kini sendiri jika kemas kini automatik diaktifkan. Selepas mengemas kini, semak versi dengan arahan biasa opencode --version. Penyahpasangan juga tersedia secara terbina dalam:

opencode uninstall

Arahan itu menunjukkan dengan tepat perkara yang akan dipadam dan meminta pengesahan. Jika mahu, anda boleh mengekalkan konfigurasi dan data sesi: gunakan pilihan --keep-config dan --keep-data.

Bagaimanakah cara memasang OpenCode pada Windows?#

Pilihan pertama yang disyorkan oleh pembangun sendiri ialah WSL. Pasangnya dengan satu arahan dalam PowerShell yang dijalankan sebagai pentadbir:

wsl --install

Selepas but semula, buka Ubuntu daripada menu Start dan jalankan arahan biasa di dalamnya:

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

Fail pada pemacu Windows boleh diakses dalam WSL melalui /mnt/—pemacu C: berada di /mnt/c/ dan pemacu D: di /mnt/d/. Jadi, projek di C:\Users\Name\project boleh dibuka seperti ini:

cd /mnt/c/Users/Name/project
opencode

Pilihan kedua ialah tidak menggunakan WSL dan sebaliknya menggunakan pengurus pakej Windows. Dalam PowerShell:

choco install opencode

scoop install opencode

Pilihan ketiga ialah aplikasi desktop dan versi web. Aplikasi ini dipasang seperti program biasa dan memaparkan antara muka dalam tetingkap tanpa terminal. Versi web dimulakan dengan arahan opencode web: arahan itu membuka OpenCode dalam pelayar, dan dokumentasi turut mengesyorkan agar ia dilancarkan daripada WSL untuk mengelakkan masalah mengakses fail. Dokumentasi juga menyenaraikan pilihan yang kurang lazim—mise, Docker dan binari sedia guna daripada halaman keluaran GitHub. Pemasangan melalui bun pada Windows masih dalam pembangunan; jika bun ialah pengurus pakej utama anda, gunakan pilihan npm.

Bagaimanakah cara menyambungkan model kepada OpenCode?#

OpenCode menyokong 75+ penyedia melalui AI SDK dan Models.dev, serta model setempat. Kebanyakannya disambungkan dengan arahan /connect di dalam antara muka; untuk model setempat, anda turut menentukan alamat pelayan dalam konfigurasi. Pilihannya berbeza dari segi kaedah pembayaran dan keperluan komputer:

Dokumentasi mengesyorkan agar pengguna baharu bermula dengan OpenCode Zen. Pasukan itu memilih model yang berfungsi dengan baik khususnya sebagai ejen dan menguji gabungannya dengan penyedia melalui tugasan mereka sendiri.

Cara menyambungkannya adalah seperti berikut: masukkan /connect, pilih OpenCode Zen, log masuk dan tambah kaedah pembayaran di opencode.ai/auth, dapatkan kunci dan tampalkannya. Kemudian /models akan memaparkan senarai model yang disyorkan. Setakat 4 Oktober 2026, senarai itu termasuk, contohnya, GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 dan Kimi K2.5. Dokumentasi menyatakan dengan jujur bahawa senarai itu tidak menyeluruh dan cepat lapuk kerana model baharu dikeluarkan setiap minggu.

Langganan disambungkan dengan arahan /connect yang sama: pilih ChatGPT Plus atau GitHub Copilot daripada senarai dan log masuk ke akaun anda—tiada persediaan tambahan diperlukan.

Jika anda memilih Anthropic, /connect menawarkan dua pilihan: masukkan kunci API secara manual atau pilih Claude Pro/Max dan sahkan melalui pelayar. Walau bagaimanapun, Anthropic melarang penggunaan langganan Claude Pro/Max melalui plugin pihak ketiga, dan plugin terbina dalam jenis ini telah dibuang daripada OpenCode mulai versi 1.3.0. Jika anda menemui artikel lama tentang “OpenCode melalui langganan Claude”, artikel itu merujuk kepada plugin yang telah dibuang tersebut, bukannya kebenaran rasmi. Langganan ChatGPT Plus, GitHub Copilot, GitLab Duo (ditandakan sebagai eksperimental) dan Atomic Chat berfungsi tanpa persediaan tambahan.

OpenCode menyimpan kunci yang anda masukkan melalui /connect dalam fail ~/.local/share/opencode/auth.json. Jika anda tidak mahu memilih model setiap kali, tetapkan model lalai dalam fail konfigurasi opencode.json di akar projek:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5"
}

Formatnya ialah provider/model; kedua-dua pengecam dipaparkan dalam output /models.

Bagaimanakah cara menyambungkan model setempat melalui Ollama?#

Pilihan ini bermakna tiada langsung bil API: model berjalan pada komputer anda. Jika anda sedang memilih antara model percuma secara umum, kami mempunyai ulasan berasingan tentang model yang berfungsi dengan agak baik sebagai ejen dan model yang hanya kelihatan begitu di atas kertas. Untuk OpenCode, pasang Ollama daripada laman rasmi dan muat turun model:

ollama pull qwen3-coder

Satu butiran berguna daripada dokumentasi: Ollama boleh mengkonfigurasi dirinya untuk OpenCode secara automatik; terdapat panduan integrasi berasingan. Jika anda mahu menyediakan semuanya secara manual, tambah penyedia dengan alamat pelayan Ollama setempat anda pada opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": {
          "name": "Qwen3 Coder"
        }
      }
    }
  }
}

Kemudian /models dalam antara muka akan memaparkan model setempat dalam senarai. Pilih model itu dan mula bekerja. Satu peringatan praktikal daripada dokumentasi: jika ejen berhenti memanggil alat (mengedit fail atau menjalankan arahan), tingkatkan num_ctx dalam tetapan Ollama—mulakan dengan nilai 16k–32k. Model setempat lebih lemah berbanding model awan khususnya untuk kerja ejen, dan konteks yang kecil memburukkan keadaan. Jika versi setempat tidak memadai, anda boleh menyambungkan Qwen daripada awan dengan kunci; panduan cara mendapatkan kunci API untuk Qwen Code menerangkan tempat mendapatkannya.

Berapakah kos OpenCode dan penggunaannya?#

Semua kos di sini adalah untuk model, dan terdapat empat senario. Dengan kunci API atau Zen, anda membayar berdasarkan penggunaan sebenar, dan jumlahnya bergantung pada banyak mana ejen bekerja. Go ialah pelan langganan pasukan OpenCode untuk model terbuka: $10 sebulan untuk Go dan $40 sebulan untuk Go Plus dengan had lebih tinggi (disahkan pada halaman opencode.ai/go pada 4 Oktober 2026). Had bergantung pada model: contohnya, Go membenarkan kira-kira 110 permintaan setiap 5 jam (440 sebulan) untuk Kimi K3 dan kira-kira 26,000 permintaan setiap 5 jam untuk DeepSeek V4.1 Flash yang lebih ringan. Untuk akses kepada model tertentu melebihi had, dokumentasi menyenaraikan harga berasingan ($15 sebulan untuk Kimi K3, $60 untuk Go Plus). Lihat halaman langganan semasa menyambung untuk senarai penuh model dan had. Dengan ChatGPT Plus atau Copilot, permintaan dilindungi oleh langganan yang sudah anda bayar; cuma ingat bahawa langganan mempunyai had penggunaan intensif tersendiri. Akhir sekali, permintaan kepada model setempat melalui Ollama tidak dikenakan bayaran—tetapi anda memerlukan komputer yang cukup berkuasa untuk menjalankannya dengan pantas.

Apakah yang perlu dilakukan semasa pelancaran pertama?#

Pelancaran pertama—dalam folder projek anda:

cd path/to/project
opencode

Antara muka akan dibuka dengan medan input. Mula-mula, gunakan arahan /init: ejen mengimbas fail penting repositori, bertanya beberapa soalan jika perlu dan menulis fail AGENTS.md—panduan tentang struktur projek, arahan untuk menjalankan binaan dan ujian serta konvensyen yang digunakan. Dokumentasi mengesyorkan agar fail ini dimasukkan ke dalam git; selepas itu OpenCode menggunakannya sebagai arahan projek yang kekal. Dari segi tujuan, AGENTS.md ialah setara langsung dengan CLAUDE.md dalam ekosistem OpenCode.

Kedua, gunakan mod Plan. Kekunci Tab bertukar antara dua ejen utama: Build mempunyai akses penuh kepada fail dan arahan, manakala Plan digunakan untuk analisis dan perancangan—pengeditan fail dan arahan bash dalam mod Plan memerlukan kelulusan anda secara lalai. Untuk tugasan baharu, dokumentasi mengesyorkan supaya anda bermula dengan pelan: baca perkara yang ingin dilakukan oleh ejen, laraskan kata-katanya dan selepas itu barulah kembali ke Build dengan Tab.

Dokumentasi memberikan nasihat ini:

Semakin khusus tugasan dan semakin banyak konteks yang anda berikan, semakin kurang kerja yang perlu dibuat semula. Tambahkan fail pada permintaan dengan @—mula menaip nama dan antara muka akan mencarinya menggunakan carian kabur. Anda boleh menyeret imej terus ke terminal, dan mesej yang bermula dengan ! dijalankan sebagai arahan shell; outputnya ditambahkan pada konteks ejen. Jika anda tersilap dalam tugasan atau ejen melakukan perkara yang salah, /undo mengembalikan perubahan dan anda boleh menjalankannya beberapa kali berturut-turut. Berubah fikiran lagi? /redo memulihkan perkara yang telah dibatalkan. Dan /share mencipta pautan kepada perbualan untuk pasukan anda; tanpa arahan ini, perbualan itu tidak diterbitkan di mana-mana.

Apakah lagi yang boleh dilakukan oleh OpenCode?#

Arahan tersuai. Mana-mana permintaan berulang boleh dijadikan arahan: letakkan fail markdown dalam .opencode/commands/, tetapkan description, agent dan model dalam frontmatter-nya, kemudian tulis templat prompt di bawah. Selepas itu, panggil arahan tersebut dengan /. Semakan projek sebelum penerbitan, pemeriksaan ralat terkini, penjanaan migrasi—apa-apa sahaja yang kerap anda minta.

Subejen. Selain Build dan Plan, terdapat tiga lagi: General untuk tugasan berbilang langkah (akses kepada semua alat kecuali senarai tugasan), Explore untuk membaca kod dengan pantas tanpa kebenaran mengedit dan Scout untuk menyelidik pustaka luaran. Panggil mereka dengan menyebut namanya menggunakan @ dalam mesej.

Pelayan MCP. Sambungkan alat luaran melalui bahagian mcp dalam konfigurasi opencode.json—pelayan setempat dan jauh kedua-duanya disokong. Setiap pelayan MCP menambahkan alatnya pada konteks, dan pelayan yang menggunakan banyak konteks seperti GitHub boleh menghabiskan konteks dengan sangat cepat—sambungkan secara terpilih, hanya yang anda perlukan. Kami mempunyai panduan dengan persediaan sedia guna tentang konsep MCP; panduan itu ditulis untuk Claude Code, tetapi protokolnya dikongsi.

Versi web dan pelayan. opencode web membuka antara muka dalam pelayar. Untuk akses daripada mesin lain, gunakan opencode serve --hostname 0.0.0.0 --port 4096; apabila terdapat akses rangkaian, pastikan anda menetapkan kata laluan dengan pemboleh ubah OPENCODE_SERVER_PASSWORD. Tanpa kata laluan, pelayan itu tidak dilindungi.

Apakah yang perlu dilakukan jika pemasangan gagal?#

“opencode: command not found” selepas pemasangan. Terminal belum mengetahui laluan baharu itu. Mula-mula, tutup dan buka semula terminal. Jika itu tidak membantu, cari lokasi binari yang dipasang oleh pemasang dan tambahkan folder tersebut pada PATH terminal anda.

Model tidak memberi respons atau melaporkan ralat kebenaran. Semak bahawa penyedia telah disambungkan: masukkan /connect dan sahkan semula. Kunci disimpan dalam ~/.local/share/opencode/auth.json—jika anda memindahkan pemasangan daripada mesin lain atau mengosongkan folder, fail itu mungkin tiada. Dokumentasi menerangkan ralat ProviderInitError dan AI_APICallError secara berasingan: untuk ralat pertama, benarkan semula penyedia; untuk ralat kedua, kosongkan folder ~/.cache/opencode dan mulakan semula.

Antara muka rosak: panel berselerak atau aksara yang tidak boleh dibaca muncul menggantikan simbol. Mula-mula, periksa terminal anda. Pasang salah satu pilihan yang disyorkan—WezTerm berfungsi pada ketiga-tiga sistem—dan lancarkan OpenCode daripadanya.

Jika tiada apa-apa yang membantu, semak log: pada macOS dan Linux, log berada di ~/.local/share/opencode/log/; pada Windows, tekan Win+R dan masukkan %USERPROFILE%\.local\share\opencode\log. Sepuluh fail terkini disimpan; aktifkan pengelogan terperinci dengan pilihan opencode --log-level DEBUG. Dengan log tersebut, anda boleh menghantar laporan pepijat di repositori GitHub projek.

Apakah soalan lain yang ditanya orang tentang OpenCode?#

Buka Ailoot.