Usakinishaji wa OpenCode na Usanidi wa OmniProxy

OpenCode ni msaidizi wa usimbaji wa chanzo huria unaokuwezesha kuandika msimbo kutoka kwa terminal, IDE, au mezani. Haihifadhi msimbo wako au muktadha, na kuifanya kufaa kwa miradi inayohitaji faragha. build inatumiwa kurekebisha mradi, wakati plan ni ya kusoma pekee kwa chaguo-msingi na inafaa kwa kuelewa msimbo usiojulikana na kupanga mabadiliko kabla ya kuyafanya. Unaweza kuchagua huduma ya muundo kulingana na mahitaji yako.

Kabla Hujaanza

Hati ya usakinishaji ndiyo chaguo rahisi zaidi. Unahitaji terminal ya kisasa—programu ya terminal inayoweza kuendesha amri na kufanya kazi na faili za mradi—kama vile WezTerm, Alacritty, Ghostty, au Kitty. Kwenye Windows, WSL inapendekezwa. Inatoa mazingira ya Linux ndani ya Windows yenye utendaji na utendakazi kamili zaidi.

Rahisi zaidi

Hati ya usakinishaji

• curl opencode.ai/install
• Tumia moja kwa moja kwenye macOS Linux
• WSL inapendekezwa kwenye Windows

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Inasasishwa mara nyingi zaidi kuliko fomula
• Kifurushi pia kinapatikana kwa Arch

Windows ya asili

Kidhibiti cha vifurushi

• choco au scoop
• Au sakinisha kimataifa na npm
• Unaweza pia kuipakua kutoka kwa Releases

Pia tayarisha kitambulisho cha muundo kutoka kwa orodha ya sasa ya miundo. Kitambulisho cha muundo ni jina ambalo huduma hutumia kutambua muundo mahususi kwa usahihi.

Sakinisha na Uzindue kwa Mara ya Kwanza

Amri rahisi zaidi ya usakinishaji ni:

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

Unaweza pia kutumia mojawapo ya njia hizi za usakinishaji:

• Node.js: npm install -g opencode-ai. Bun, pnpm, na Yarn pia zina amri husika za usakinishaji wa kimataifa; angalia ukurasa wa utangulizi mwishoni mwa mwongozo huu.
• Homebrew kwenye macOS na Linux: brew install anomalyco/tap/opencode. Tumia tap hii kwa sababu inasasishwa mara nyingi zaidi kuliko brew install opencode, ambayo inasimamiwa na timu ya Homebrew.
• Arch Linux: tumia sudo pacman -S opencode kwa toleo thabiti, au kifurushi cha AUR opencode-bin kwa toleo jipya zaidi.
• Windows: tumia choco install opencode au scoop install opencode. Unaweza pia kutumia npm install -g opencode-ai. Faili za binary zinaweza pia kupakuliwa kutoka kwa Releases. Usaidizi wa kusakinisha na Bun kwenye Windows bado unaendelea.

Ingiza saraka ya mradi wako, kisha uzindue OpenCode:

cd /path/to/project
opencode

Unapoitumia kwa mara ya kwanza, unaweza kuendesha /init. Inachambua mradi na kuunda AGENTS.md kwenye mzizi wa mradi. Faili hii inaweza kukabidhiwa kwa Git ili mradi uhifadhi maagizo haya.

Pata Thamani za Muunganisho kutoka OmniProxy

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

baseURL ni anwani ya huduma, API Key ni kitambulisho cha ufikiaji, na Model ID ni jina kamili la muundo.

Unapotumia /v1/chat/completions, weka kifurushi cha npm kuwa @ai-sdk/openai-compatible. Chat Completions ni aina ya kiolesura cha ombi la gumzo. Badilisha hadi @ai-sdk/openai tu wakati muundo unatumia /v1/responses. Wakati OmniProxy inatumiwa kupitia mwisho wa chat completions, weka kifurushi cha utangamano.

Nakili kitambulisho kamili cha muundo kutoka kwa orodha ya sasa ya OmniProxy, ikijumuisha mikwaju yoyote. Kufikia 2026-10-09, vitambulisho viwili vya marejeleo vilikuwa claude-sonnet-5-5 na gpt-6-luna. gpt-6-luna inasaidia Chat Completions; utekelezaji wa kazi kupitia Chat Completions unasaidiwa tu wakati reasoning_effort ni none. Usinakili kitambulisho ambacho hakipo kwenye orodha.

Ingiza Usanidi wa Zana

Mtoa huduma anaweza kueleweka kama seti ya thamani za usanidi ambazo OpenCode hutumia kuunganisha kwenye huduma ya muundo. Nyaraka za Mtoa huduma huchukulia huduma inayooana na OpenAI ambayo haijaorodheshwa chini ya /connect kama Mtoa huduma maalum. Huduma inayooana na OpenAI hutumia umbizo sawa la ombi na inaweza kuitwa na aina sawa ya mteja.

1. Endesha /connect katika OpenCode na usogeze hadi Other.
2. Ingiza Kitambulisho cha Mtoa huduma. Mfano hapa chini unatumia omniproxy. Chagua kitambulisho ambacho ni rahisi kukumbuka kwa sababu lazima utumie kile kile kwenye faili ya usanidi.
3. Ingiza Ufunguo wa API wa OmniProxy. Hatua hii huhifadhi kitambulisho pekee; anwani na miundo lazima bado ziongezwe kwenye opencode.json. Kitambulisho kinahifadhiwa kwenye ~/.local/share/opencode/auth.json.
4. Unda au urekebishe opencode.json kwenye saraka ya mradi:

{
  "$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. Endesha /models. Mtoa huduma maalum na miundo yake itaonekana kwenye orodha.

Kitambulisho kilichoingizwa chini ya /connect lazima kilingane na ufunguo katika opencode.json. Usiweke ufunguo wa siri halisi kwenye faili hii. Ikiwa hutumii /connect, unaweza kutumia sintaksia ya kigeu cha mazingira katika options.apiKey, kama vile {env:VARIABLE_NAME}. Katika majaribio mnamo 2026-10-09 na OpenCode 1.18.34, kuweka ufunguo moja kwa moja kwenye options.apiKey ya mradi bila kutumia /connect pia kuliunganishwa kwa mafanikio. Ikiwa gateway haithibitishi ufunguo, thamani hii inaweza kuwa kamba ya kishika nafasi inayotumiwa kwenye mashine ya ndani pekee. Funguo chini ya models lazima zitumie vitambulisho kamili kutoka kwenye orodha.

Ufunguo

/connect

• Chagua Other chini
• Chagua Kitambulisho chako cha Mtoa huduma
• Imehifadhiwa kwenye auth.json

Mradi

opencode.json

• Ufunguo wa mtoa huduma lazima utumie jina lile lile
• Tumia kifurushi cha npm kinachooana
• baseURL inaishia na /v1

Chagua

/models

• Muundo unaonekana kwenye orodha
• Chagua mmoja kabla ya kuuliza swali
• Tumia kitambulisho kutoka kwa orodha ya gateway

Thibitisha na Kazi Halisi

Endesha kazi moja halisi kutoka kwa saraka ya mradi kwanza. Umbizo la marejeleo ya muundo ni Provider ID/model ID; hifadhi mikwaju yoyote ndani ya kitambulisho cha muundo:

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

--auto inaruhusu uendeshaji huu kutumia zana kama vile zana za kusoma faili. Katika majaribio mnamo 2026-10-09 na OpenCode 1.18.34, ilisoma kwa mafanikio yaliyomo kwenye faili iliyobainishwa. Uendeshaji wa kwanza ulichukua kama dakika mbili.

Kwa matumizi ya mwingiliano, endesha opencode, kisha chagua muundo na /models. Unaweza kutumia @ kutafuta faili. Tumia opencode auth list kuthibitisha kitambulisho kilichohifadhiwa kupitia /connect, kisha angalia rekodi za ombi za OmniProxy ili kuthibitisha chanzo na kitambulisho cha muundo.

Zindua

opencode inazindua

• Kwanza cd kwenye mradi
• auth list inaonyesha kitambulisho
• Faili ya usanidi iko kwenye mradi

Kazi

Ilisoma msimbo

• Uliza kuhusu faili mahususi
• Kagua maelezo yake
• Tumia /undo ikiwa ni makosa

Kumbukumbu

Inaonekana kwenye gateway

• Chanzo ni OpenCode
• Kitambulisho cha muundo kinalingana
• Usikabidhi ufunguo

Makosa ya Kawaida

• OmniProxy haionekani chini ya /models: Angalia kuwa kitambulisho kilichoingizwa chini ya /connect kinalingana na ufunguo katika opencode.json, kwamba npm imewekwa kuwa @ai-sdk/openai-compatible, na kwamba baseURL inaishia na /v1.
• Kitambulisho hakipo: Endesha opencode auth list. Watoa huduma kama Bedrock wanaotegemea vigeu vya mazingira hawaonekani hapa; Mtoa huduma maalum aliyesanidiwa kupitia /connect anapaswa kuonekana.
• Utendaji wa Windows haujakamilika: Tumia hati ya usakinishaji ndani ya WSL badala yake.
• Kitambulisho cha muundo si sahihi: Nakili tena kutoka kwa orodha ya sasa ya OmniProxy na usasishe ufunguo husika chini ya models.
• Maombi yanaenda kwenye mwisho mbaya: Weka @ai-sdk/openai-compatible kwa chat completions. Usibadilishe kifurushi kwa kiolesura cha Majibu isipokuwa muundo huo kwenye OmniProxy unatumia /v1/responses.

Marejeleo Rasmi

Kwa usakinishaji, angalia OpenCode introduction. Kwa Watoa huduma maalum, angalia Providers. Kwa vitambulisho vya muundo vinavyotumiwa katika mifano, angalia Claude model overview na GPT-6 Luna.

Badilisha kila nafasi yenye thamani kutoka kwenye usanidi wako wa OmniProxy. Usitangaze funguo halisi.

Matokeo yaliyohifadhiwa au HTTP 200 pekee hayathibitishi utangamano kamili wa Agent. Angalia chanzo na mfano katika rekodi ya maombi ya OmniProxy.

Vyanzo rasmi · OpenCode ↗