Installazzjoni ta’ OpenCode u konfigurazzjoni ta’ OmniProxy

OpenCode huwa assistent tal-kodifikazzjoni open source li jippermettilek tikteb kodiċi mit-terminal, mill-IDE jew mid-desktop. Ma jaħżinx il-kodiċi jew il-kuntest tiegħek, għalhekk huwa adattat għal proġetti fejn il-privatezza hija importanti. build jintuża biex jimmodifika l-proġett, filwaqt li plan huwa read-only b’mod awtomatiku u huwa utli biex l-ewwel tifhem kodiċi li ma tafux u torganizza l-bidliet. Tista’ tagħżel is-servizz tal-mudell skont il-ħtiġijiet tiegħek.

Tħejjija qabel l-installazzjoni

L-iskript tal-installazzjoni huwa l-eħfef metodu. Għandek bżonn terminal modern, jiġifieri programm tat-terminal li jista’ jħaddem kmandi u jimmaniġġja l-fajls tal-proġett, bħal WezTerm, Alacritty, Ghostty jew Kitty. Fuq Windows, huwa preferibbli li tuża WSL, għodda li tħaddem ambjent Linux fi ħdan Windows u tipprovdi prestazzjoni u funzjonalità aktar kompleti.

L-eħfef

Skript tal-installazzjoni

• curl opencode.ai/install
• Użah direttament fuq macOS Linux
• WSL huwa rakkomandat fuq Windows

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Jiġi aġġornat aktar ta' spiss mill-formula
• Hemm ukoll pakkett għal Arch

Direttament fuq Windows

Maniġer tal-pakketti

• choco jew scoop
• Jew installazzjoni globali b'npm
• Tista' wkoll tniżżlu minn Releases

Ħejji wkoll l-ID tal-mudell mil-lista attwali tal-mudelli. L-ID tal-mudell huwa l-isem li s-servizz juża biex jidentifika mudell partikolari b’mod preċiż.

Installa u ħaddem għall-ewwel darba

L-eħfef kmand tal-installazzjoni huwa:

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

Tista’ tuża wkoll dawn il-metodi ta’ installazzjoni:

• Node.js: npm install -g opencode-ai. Bun, pnpm u Yarn għandhom ukoll il-kmandi rispettivi tagħhom għall-installazzjoni globali; ara l-paġna ta’ introduzzjoni fl-aħħar ta’ din il-gwida.
• Homebrew fuq macOS u Linux: brew install anomalyco/tap/opencode. Uża dan it-tap, għax jiġi aġġornat aktar ta’ spiss minn brew install opencode, li jinżamm mit-tim ta’ Homebrew.
• Arch Linux: għall-verżjoni stabbli uża sudo pacman -S opencode; għal verżjoni aktar ġdida tista’ tuża opencode-bin mill-AUR.
• Windows: choco install opencode jew scoop install opencode; tista’ tuża wkoll npm install -g opencode-ai. Tista’ wkoll tniżżel il-fajl binarju minn Releases. L-appoġġ għall-installazzjoni b’Bun fuq Windows għadu qed jiġi żviluppat.

Mur fid-direttorju tal-proġett tiegħek, imbagħad ħaddem OpenCode:

cd /path/to/project
opencode

L-ewwel darba li tużah, tista’ tħaddem /init. Dan janalizza l-proġett u joħloq AGENTS.md fid-direttorju ewlieni tal-proġett. Tista’ tikkommetti dan il-fajl f’Git sabiex il-proġett iżomm dawn l-istruzzjonijiet.

Ikseb il-parametri tal-konnessjoni minn OmniProxy

baseURL: https://your-omniproxy-origin.example/v1
API Key: <YOUR_OMNIPROXY_API_KEY>
Model ID: Ikkopja l-ID sħiħ mil-lista attwali tal-mudelli ta’ OmniProxy

baseURL huwa l-indirizz tas-servizz, API Key hija l-kredenzjali tal-aċċess, u Model ID huwa l-isem sħiħ tal-mudell.

Meta tuża /v1/chat/completions, uża l-pakkett npm @ai-sdk/openai-compatible. Hawnhekk, Chat Completions huwa tip ta’ endpoint għal talbiet ta’ chat. Aqleb għal @ai-sdk/openai biss meta l-mudell juża /v1/responses. Meta OmniProxy jintuża permezz tal-perkors ta’ chat completions, żomm il-pakkett kompatibbli.

Ikkopja l-ID kollu tal-mudell mil-lista attwali ta’ OmniProxy, inklużi kwalunkwe slashes. Żewġ IDs ta’ referenza fl-2026-10-09 kienu claude-sonnet-5-5 u gpt-6-luna. gpt-6-luna jappoġġja Chat Completions; fi Chat Completions, is-sejħiet tal-funzjonijiet huma appoġġjati biss meta reasoning_effort ikun none. Tikkopjax IDs li mhumiex fil-lista.

Daħħal il-konfigurazzjoni tal-għodda

Provider jista’ jitqies bħala sett ta’ konfigurazzjonijiet li OpenCode juża biex jikkonnettja ma’ servizz tal-mudell. Id-dokumentazzjoni tal-Provider tqis servizz kompatibbli ma’ OpenAI li ma jidhirx fil-lista ta’ /connect bħala Provider personalizzat. Servizz kompatibbli ma’ OpenAI juża l-istess format tat-talbiet u jista’ jissejjaħ mill-istess tip ta’ client.

1. F’OpenCode, ħaddem /connect u skrollja sa Other.
2. Daħħal Provider ID. Hawn taħt jintuża omniproxy. Agħżel ID li faċli tiftakru, għax trid tuża l-istess wieħed fil-fajl tal-konfigurazzjoni.
3. Daħħal l-API Key ta’ OmniProxy. Dan il-pass jaħżen biss il-kredenzjali; l-indirizz u l-mudelli xorta jridu jiddaħħlu f’opencode.json. Il-kredenzjali jinħażnu f’~/.local/share/opencode/auth.json.
4. Oħloq jew immodifika opencode.json fid-direttorju tal-proġett:

{
  "$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. Ħaddem /models; il-Provider personalizzat u l-mudelli se jidhru fil-lista.

L-ID f’/connect irid ikun identiku għaċ-ċavetta f’opencode.json. Tiktibx iċ-ċavetta reali f’dan il-fajl. Jekk ma tużax /connect, tista’ tuża varjabbli tal-ambjent f’options.apiKey, pereżempju {env:ISEM_TAL_VARJABBLI}. Fl-2026-10-09, bl-użu ta’ OpenCode 1.18.34, kien possibbli li ssir konnessjoni billi ċ-ċavetta nkitbet direttament f’options.apiKey tal-proġett, mingħajr ma ntuża /connect. Jekk il-gateway ma jivverifikax iċ-ċavetta, dan il-valur jista’ jkun sensiela ta’ karattri placeholder li tintuża lokalment biss. Iċ-ċwievet f’models għandhom jużaw l-IDs sħaħ mil-lista.

Ċavetta

/connect

• Agħżel Other fil-qiegħ nett
• Iddefinixxi l-Provider ID int stess
• Jinħażen f'auth.json

Proġett

opencode.json

• Iċ-ċavetta provider trid tuża l-istess isem
• Għal npm uża l-pakkett kompatibbli
• baseURL għandu jispiċċa b'/v1

Għażla

/models

• Il-mudell jidher fil-lista
• Agħżel wieħed qabel tistaqsi
• Uża l-ID mil-lista tal-gateway

Ivverifika b’kompitu reali

L-ewwel ħaddem kompitu reali fid-direttorju tal-proġett. Il-format tar-referenza tal-mudell huwa Provider ID/Model ID; żomm kwalunkwe slash li jkun hemm fl-ID tal-mudell:

opencode run --model omniproxy/claude-sonnet-5-5 --auto "Spjega x’jagħmel fajl li tispeċifika int, mingħajr ma timmodifika l-fajl."

--auto jippermetti lil din it-tħaddima tuża għodod bħall-qari tal-fajls. Fl-2026-10-09, OpenCode 1.18.34 qara l-kontenut tal-fajl speċifikat. L-ewwel darba ħadet madwar żewġ minuti.

Għall-użu interattiv, ħaddem opencode u mbagħad agħżel il-mudell permezz ta’ /models. Tista’ tuża @ biex tfittex fajls. Tista’ tħaddem opencode auth list biex tikkonferma l-kredenzjali rreġistrati permezz ta’ /connect, u mbagħad tiċċekkja r-rekords tas-sejħiet f’OmniProxy biex tikkonferma s-sors u l-ID tal-mudell.

Tnedija

opencode jista' jinfetaħ

• L-ewwel uża cd biex tidħol fil-proġett
• L-ID jidher f'auth list
• Il-fajl tal-konfigurazzjoni jinsab fil-proġett

Kompitu

Qara l-kodiċi

• Staqsi dwar fajl speċifiku
• Ara l-ispjegazzjoni tiegħu
• Uża /undo jekk mhuwiex korrett

Reġistru

Jidher fil-gateway

• Is-sors huwa OpenCode
• L-ID tal-mudell jaqbel
• Tikkommettix iċ-ċavetta

Żbalji komuni

• OmniProxy ma jidhirx f’/models: iċċekkja li l-ID ta’ /connect jaqbel maċ-ċavetta f’opencode.json, li npm huwa @ai-sdk/openai-compatible, u li baseURL jintemm b’/v1.
• Il-kredenzjali sparixxew: ħaddem opencode auth list. Providers bħal Bedrock li jiddependu fuq varjabbli tal-ambjent ma jidhrux hawn; Provider personalizzat li juża /connect għandu jidher.
• Il-funzjonalità fuq Windows mhix kompleta: uża l-iskript tal-installazzjoni fi WSL.
• L-ID tal-mudell mhuwiex validu: erġa’ kkopjah mil-lista attwali ta’ OmniProxy u aġġorna ċ-ċavetta f’models.
• It-talba qed tintbagħat lill-endpoint ħażin: żomm @ai-sdk/openai-compatible għal chat completions. Tibdilx il-pakkett għall-API Responses sakemm il-mudell partikolari fuq OmniProxy ma jkunx verament juża /v1/responses.

Referenzi uffiċjali

Għall-installazzjoni, ara l-introduzzjoni ta’ OpenCode. Għal Provider personalizzat, ara Providers. Għall-IDs tal-mudelli użati fl-eżempji, ara l-ħarsa ġenerali lejn il-mudelli Claude u GPT-6 Luna.

Ibdel kull placeholder b'valuri mill-konfigurazzjoni personali tiegħek ta' OmniProxy. Qatt ma npubblika key reali.

Risultat salvat jew HTTP 200 waħdu ma jipprovax kompatibilità sħiħa tal-Agent. Iċċekkja s-sors u l-mudell fir-rekord tat-talba ta' OmniProxy.

Sorsi uffiċjali · OpenCode ↗