Pag-install ng OpenCode at Pag-configure ng OmniProxy

Ang OpenCode ay isang open-source coding assistant na nagpapahintulot sa iyong magsulat ng code mula sa terminal, IDE, o desktop. Hindi nito iniimbak ang iyong code o context, kaya angkop ito para sa mga proyektong sensitibo sa privacy. build ay ginagamit para baguhin ang isang proyekto, habang ang plan ay read-only bilang default at kapaki-pakinabang para sa pag-unawa sa hindi pamilyar na code at pagpaplano ng mga pagbabago bago gawin ang mga ito. Maaari kang pumili ng model service batay sa iyong mga pangangailangan.

Bago Ka Magsimula

Ang installation script ang pinakamadaling opsyon. Kailangan mo ng modernong terminal—isang terminal application na kayang magpatakbo ng mga command at gumana sa mga project file—gaya ng WezTerm, Alacritty, Ghostty, o Kitty. Sa Windows, mas mainam ang WSL. Nagbibigay ito ng Linux environment sa loob ng Windows na may mas kumpletong performance at functionality.

Pinakamadali

Installation script

• curl opencode.ai/install
• Gamitin nang direkta sa macOS Linux
• Inirerekomenda ang WSL sa Windows

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Mas madalas na ina-update kaysa sa formula
• Mayroon ding package para sa Arch

Native Windows

Package manager

• choco o scoop
• O i-install nang global gamit ang npm
• Maaari mo rin itong i-download mula sa Releases

Ihanda rin ang model ID mula sa kasalukuyang listahan ng mga model. Ang model ID ay ang pangalan na ginagamit ng serbisyo para matukoy nang tumpak ang isang partikular na model.

Pag-install at Unang Paglulunsad

Ang pinakamadaling installation command ay:

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

Maaari mo ring gamitin ang isa sa mga paraan ng pag-install na ito:

• Node.js: npm install -g opencode-ai. Ang Bun, pnpm, at Yarn ay mayroon ding kaukulang global installation command; tingnan ang introduction page sa dulo ng gabay na ito.
• Homebrew sa macOS at Linux: brew install anomalyco/tap/opencode. Gamitin ang tap na ito dahil mas madalas itong ina-update kaysa sa brew install opencode, na pinapanatili ng Homebrew team.
• Arch Linux: gamitin ang sudo pacman -S opencode para sa stable release, o ang AUR package na opencode-bin para sa mas bagong bersyon.
• Windows: gamitin ang choco install opencode o scoop install opencode. Maaari mo ring gamitin ang npm install -g opencode-ai. Ang mga binary file ay maaari ring i-download mula sa Releases. Ang suporta para sa pag-install gamit ang Bun sa Windows ay kasalukuyan pang ginagawa.

Pumasok sa iyong project directory, pagkatapos ay ilunsad ang OpenCode:

cd /path/to/project
opencode

Kapag ginagamit ito sa unang pagkakataon, maaari mong patakbuhin ang /init. Sinusuri nito ang proyekto at gumagawa ng AGENTS.md sa root ng proyekto. Ang file na ito ay maaaring i-commit sa Git para mapanatili ng proyekto ang mga tagubiling ito.

Kumuha ng Connection Values mula sa OmniProxy

baseURL: https://your-omniproxy-origin.example/v1
API Key: <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

baseURL ay ang service address, API Key ay ang access credential, at Model ID ay ang buong pangalan ng model.

Kapag gumagamit ng /v1/chat/completions, i-set ang npm package sa @ai-sdk/openai-compatible. Ang Chat Completions ay isang uri ng chat request interface. Lumipat sa @ai-sdk/openai lamang kapag ang model ay gumagamit ng /v1/responses. Kapag ang OmniProxy ay ginamit sa pamamagitan ng chat completions endpoint, panatilihin ang compatibility package.

Kopyahin ang buong model ID mula sa kasalukuyang listahan ng OmniProxy, kasama ang anumang slash. Noong 2026-10-09, ang dalawang reference ID ay claude-sonnet-5-5 at gpt-6-luna. gpt-6-luna ay sumusuporta sa Chat Completions; ang function calling sa pamamagitan ng Chat Completions ay sinusuportahan lamang kapag ang reasoning_effort ay none. Huwag kopyahin ang ID na wala sa listahan.

Ipasok ang Configuration ng Tool

Ang isang Provider ay maaaring ituring bilang isang set ng mga configuration value na ginagamit ng OpenCode para kumonekta sa isang model service. Itinuturing ng dokumentasyon ng Provider ang isang OpenAI-compatible service na wala sa listahan sa ilalim ng /connect bilang isang custom Provider. Ang isang OpenAI-compatible service ay gumagamit ng parehong request format at maaaring tawagin ng parehong uri ng client.

1. Patakbuhin ang /connect sa OpenCode at mag-scroll sa Other.
2. Magpasok ng Provider ID. Ang halimbawa sa ibaba ay gumagamit ng omniproxy. Pumili ng ID na madaling tandaan dahil dapat mong gamitin ang parehong ID sa configuration file.
3. Ipasok ang OmniProxy API Key. Ang hakbang na ito ay nagse-save lamang ng credential; ang address at mga model ay dapat pa ring idagdag sa opencode.json. Ang credential ay iniimbak sa ~/.local/share/opencode/auth.json.
4. Gumawa o baguhin ang opencode.json sa project directory:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniproxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniProxy",
      "options": {
        "baseURL": "https://your-omniproxy-origin.example/v1"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "gpt-6-luna": { "name": "GPT-6 Luna" }
      }
    }
  }
}

5. Patakbuhin ang /models. Ang custom Provider at ang mga model nito ay lalabas sa listahan.

Ang ID na ipinasok sa ilalim ng /connect ay dapat tumugma sa key sa opencode.json. Huwag maglagay ng totoong secret key sa file na ito. Kung hindi ka gumagamit ng /connect, maaari kang gumamit ng environment-variable syntax sa options.apiKey, gaya ng {env:VARIABLE_NAME}. Sa testing noong 2026-10-09 gamit ang OpenCode 1.18.34, ang paglalagay ng key nang direkta sa options.apiKey ng proyekto nang hindi gumagamit ng /connect ay matagumpay ding nakakonekta. Kung hindi i-validate ng gateway ang key, ang value na ito ay maaaring isang placeholder string na ginagamit lamang sa lokal na machine. Ang mga key sa ilalim ng models ay dapat gumamit ng mga kumpletong ID mula sa listahan.

Key

/connect

• Piliin ang Other sa ibaba
• Piliin ang sarili mong Provider ID
• Naka-imbak sa auth.json

Proyekto

opencode.json

• Ang provider key ay dapat gumamit ng parehong pangalan
• Gumamit ng compatible na npm package
• Ang baseURL ay nagtatapos sa /v1

Piliin

/models

• Ang model ay lumalabas sa listahan
• Pumili ng isa bago magtanong
• Gamitin ang ID mula sa listahan ng gateway

I-verify gamit ang Isang Totoong Gawain

Patakbuhin ang isang totoong gawain mula sa project directory muna. Ang format ng sanggunian ng model ay Provider ID/model ID; panatilihin ang anumang slash sa loob ng model ID:

opencode run --model omniproxy/claude-sonnet-5-5 --auto "Explain what a file you specify does. Do not modify the file."

--auto ay nagpapahintulot sa run na ito na gumamit ng mga tool gaya ng file-reading tools. Sa testing noong 2026-10-09 gamit ang OpenCode 1.18.34, matagumpay nitong nabasa ang mga nilalaman ng tinukoy na file. Ang unang run ay tumagal ng mga dalawang minuto.

Para sa interactive na paggamit, patakbuhin ang opencode, pagkatapos ay pumili ng model gamit ang /models. Maaari mong gamitin ang @ para maghanap ng mga file. Gamitin ang opencode auth list para kumpirmahin ang credential na na-save sa pamamagitan ng /connect, pagkatapos ay suriin ang mga request record ng OmniProxy para i-verify ang source at model ID.

Ilunsad

Inilunsad ang opencode

• Mag-cd muna sa proyekto
• Ipinapakita ng auth list ang ID
• Ang configuration file ay nasa proyekto

Gawain

Binasa nito ang code

• Magtanong tungkol sa isang partikular na file
• Suriin ang paliwanag nito
• Gamitin ang /undo kung ito ay mali

Mga Log

Nakikita sa gateway

• Ang source ay OpenCode
• Ang Model ID ay tumutugma
• Huwag i-commit ang key

Mga Karaniwang Error

• Hindi lumalabas ang OmniProxy sa ilalim ng /models: Suriin na ang ID na ipinasok sa ilalim ng /connect ay tumutugma sa key sa opencode.json, na ang npm ay naka-set sa @ai-sdk/openai-compatible, at na ang baseURL ay nagtatapos sa /v1.
• Nawawala ang credential: Patakbuhin ang opencode auth list. Ang mga provider gaya ng Bedrock na umaasa sa mga environment variable ay hindi lumalabas dito; ang isang custom Provider na na-configure sa pamamagitan ng /connect ay dapat na makita.
• Hindi kumpleto ang functionality sa Windows: Gamitin ang installation script sa loob ng WSL sa halip.
• Hindi valid ang model ID: Kopyahin itong muli mula sa kasalukuyang listahan ng OmniProxy at i-update ang kaukulang key sa ilalim ng models.
• Ang mga request ay napupunta sa maling endpoint: Panatilihin ang @ai-sdk/openai-compatible para sa chat completions. Huwag baguhin ang package para sa Responses interface maliban kung ang model na iyon sa OmniProxy ay talagang gumagamit ng /v1/responses.

Mga Opisyal na Sanggunian

Para sa pag-install, tingnan ang OpenCode introduction. Para sa mga custom Provider, tingnan ang Providers. Para sa mga model ID na ginamit sa mga halimbawa, tingnan ang Claude model overview at GPT-6 Luna.

Palagyan ng halaga mula sa iyong sariling konfigurasyon ng OmniProxy ang bawat placeholder. Huwag kailanman ilabas ang tunay na key.

Ang isang na-save na resulta o HTTP 200 lamang ay hindi patunay ng full Agent compatibility. Suriin ang source at modelo sa call log ng OmniProxy.

Mga opisyal na pinagkukunan · OpenCode ↗