OpenCode instalēšana un OmniProxy konfigurēšana

OpenCode ir atvērtā pirmkoda kodēšanas asistents, kas ļauj rakstīt kodu no termināļa, IDE vai darbvirsmas. Tas nesaglabā jūsu kodu vai kontekstu, padarot to piemērotu privātuma ziņā jutīgiem projektiem. build tiek izmantots projekta modificēšanai, savukārt plan pēc noklusējuma ir tikai lasāms un ir noderīgs nepazīstama koda izpratnei un izmaiņu plānošanai pirms to veikšanas. Varat izvēlēties modeļu pakalpojumu atbilstoši savām vajadzībām.

Pirms sākat

Instalēšanas skripts ir vienkāršākā iespēja. Jums ir nepieciešams moderns terminālis — termināļa lietotne, kas var palaist komandas un strādāt ar projekta failiem, piemēram, WezTerm, Alacritty, Ghostty vai Kitty. Operētājsistēmā Windows ieteicams izmantot WSL. Tas nodrošina Linux vidi operētājsistēmā Windows ar pilnīgāku veiktspēju un funkcionalitāti.

Vienkāršākais

Instalēšanas skripts

• curl opencode.ai/install
• Izmantojiet tieši macOS un Linux sistēmās
• WSL ir ieteicams operētājsistēmā Windows

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Tiek atjaunināts biežāk nekā formula
• Pakotne ir pieejama arī Arch

Vietējais Windows

Pakotņu pārvaldnieks

• choco vai scoop
• Vai instalējiet globāli ar npm
• Varat to arī lejupielādēt no Releases

Sagatavojiet arī modeļa ID no pašreizējā modeļu saraksta. Modeļa ID ir nosaukums, ko pakalpojums izmanto, lai precīzi identificētu konkrētu modeli.

Instalēšana un pirmā palaišana

Vienkāršākā instalēšanas komanda ir:

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

Varat izmantot arī kādu no šīm instalēšanas metodēm:

• Node.js: npm install -g opencode-ai. Bun, pnpm un Yarn arī ir atbilstošas globālās instalēšanas komandas; skatiet ievada lapu šīs rokasgrāmatas beigās.
• Homebrew operētājsistēmās macOS un Linux: brew install anomalyco/tap/opencode. Izmantojiet šo tap, jo tas tiek atjaunināts biežāk nekā brew install opencode, ko uztur Homebrew komanda.
• Arch Linux: izmantojiet sudo pacman -S opencode stabilajam laidienam vai AUR pakotni opencode-bin jaunākai versijai.
• Windows: izmantojiet choco install opencode vai scoop install opencode. Varat izmantot arī npm install -g opencode-ai. Bināros failus var lejupielādēt arī no Releases. Atbalsts instalēšanai ar Bun operētājsistēmā Windows joprojām tiek izstrādāts.

Ieejiet savā projekta direktorijā, pēc tam palaidiet OpenCode:

cd /path/to/project
opencode

Pirmo reizi lietojot, varat palaist /init. Tas analizē projektu un izveido AGENTS.md projekta saknē. Šo failu var iekļaut Git, lai projekts saglabātu šīs instrukcijas.

Savienojuma vērtību iegūšana no OmniProxy

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

baseURL ir pakalpojuma adrese, API Key ir piekļuves akreditācijas dati, un Model ID ir modeļa pilnais nosaukums.

Izmantojot /v1/chat/completions, iestatiet npm pakotni uz @ai-sdk/openai-compatible. Chat Completions ir tērzēšanas pieprasījuma saskarnes veids. Pārslēdzieties uz @ai-sdk/openai tikai tad, ja modelis izmanto /v1/responses. Kad OmniProxy tiek izmantots caur tērzēšanas pabeigšanas galapunktu, saglabājiet saderības pakotni.

Kopējiet visu modeļa ID no OmniProxy pašreizējā saraksta, ieskaitot slīpsvītras. Uz 2026-10-09 divi atsauces ID bija claude-sonnet-5-5 un gpt-6-luna. gpt-6-luna atbalsta Chat Completions; funkciju izsaukšana caur Chat Completions tiek atbalstīta tikai tad, kad reasoning_effort ir none. Nekopējiet ID, kas nav sarakstā.

Rīka konfigurācijas ievadīšana

Pakalpojumu sniedzēju (Provider) var saprast kā konfigurācijas vērtību kopu, ko OpenCode izmanto, lai izveidotu savienojumu ar modeļa pakalpojumu. Pakalpojumu sniedzēja dokumentācijā OpenAI saderīgs pakalpojums, kas nav uzskaitīts zem /connect tiek uzskatīts par pielāgotu pakalpojumu sniedzēju. OpenAI saderīgs pakalpojums izmanto to pašu pieprasījuma formātu, un to var izsaukt tāda paša veida klients.

1. Palaidiet /connect OpenCode un ritiniet līdz Other.
2. Ievadiet pakalpojumu sniedzēja ID. Tālāk redzamajā piemērā izmantots omniproxy. Izvēlieties ID, kuru ir viegli atcerēties, jo tas pats jāizmanto konfigurācijas failā.
3. Ievadiet OmniProxy API atslēgu. Šis solis saglabā tikai akreditācijas datus; adrese un modeļi joprojām ir jāpievieno opencode.json. Akreditācijas dati tiek saglabāti ~/.local/share/opencode/auth.json.
4. Izveidojiet vai modificējiet opencode.json projekta direktorijā:

{
  "$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. Palaidiet /models. Pielāgotais pakalpojumu sniedzējs un tā modeļi parādīsies sarakstā.

ID, kas ievadīts zem /connect jāatbilst atslēgai opencode.json. Neievietojiet īstu slepenu atslēgu šajā failā. Ja neizmantojat /connect, varat izmantot vides mainīgā sintaksi options.apiKey, piemēram, {env:VARIABLE_NAME}. Pārbaudē 2026-10-09 ar OpenCode 1.18.34, atslēgas ievietošana tieši projekta options.apiKey bez /connect izmantošanas arī veiksmīgi izveidoja savienojumu. Ja vārteja nevalidē atslēgu, šī vērtība var būt viettura virkne, kas tiek izmantota tikai lokālajā datorā. Atslēgām zem models jāizmanto pilnie ID no saraksta.

Atslēga

/connect

• Atlasiet Other apakšā
• Izvēlieties savu pakalpojumu sniedzēja ID
• Saglabāts auth.json

Projekts

opencode.json

• Pakalpojumu sniedzēja atslēgai jāizmanto tāds pats nosaukums
• Izmantojiet saderīgu npm pakotni
• baseURL beidzas ar /v1

Atlasīt

/models

• Modelis parādās sarakstā
• Atlasiet vienu pirms jautājuma uzdošanas
• Izmantojiet ID no vārtejas saraksta

Pārbaude ar reālu uzdevumu

Vispirms palaidiet vienu reālu uzdevumu no projekta direktorijas. Modeļa atsauces formāts ir Provider ID/model ID; saglabājiet visas slīpsvītras modeļa ID:

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

--auto ļauj šai palaišanas reizei izmantot rīkus, piemēram, failu lasīšanas rīkus. Pārbaudē 2026-10-09 ar OpenCode 1.18.34 tas veiksmīgi izlasīja norādītā faila saturu. Pirmā palaišana aizņēma apmēram divas minūtes.

Interaktīvai lietošanai palaidiet opencode, pēc tam atlasiet modeli ar /models. Varat izmantot @ failu meklēšanai. Izmantojiet opencode auth list lai apstiprinātu akreditācijas datus, kas saglabāti caur /connect, pēc tam pārbaudiet OmniProxy pieprasījumu ierakstus, lai pārbaudītu avotu un modeļa ID.

Palaišana

opencode palaižas

• Vispirms cd uz projektu
• auth list parāda ID
• Konfigurācijas fails atrodas projektā

Uzdevums

Tas izlasīja kodu

• Jautājiet par konkrētu failu
• Pārskatiet tā skaidrojumu
• Izmantojiet /undo, ja tas ir nepareizi

Žurnāli

Redzams vārtejā

• Avots ir OpenCode
• Modeļa ID sakrīt
• Neiekļaujiet atslēgu repozitorijā

Biežākās kļūdas

• OmniProxy neparādās zem /models: Pārbaudiet, vai ID, kas ievadīts zem /connect atbilst atslēgai opencode.json, ka npm ir iestatīts uz @ai-sdk/openai-compatible, un ka baseURL beidzas ar /v1.
• Trūkst akreditācijas datu: Palaidiet opencode auth list. Pakalpojumu sniedzēji, piemēram, Bedrock, kas paļaujas uz vides mainīgajiem, šeit neparādās; pielāgotam pakalpojumu sniedzējam, kas konfigurēts caur /connect jābūt redzamam.
• Windows funkcionalitāte ir nepilnīga: Tā vietā izmantojiet instalēšanas skriptu WSL iekšpusē.
• Modeļa ID nav derīgs: Kopējiet to vēlreiz no OmniProxy pašreizējā saraksta un atjauniniet atbilstošo atslēgu zem models.
• Pieprasījumi dodas uz nepareizu galapunktu: Saglabājiet @ai-sdk/openai-compatible tērzēšanas pabeigšanai. Nemainiet pakotni Responses saskarnei, ja vien šis modelis OmniProxy faktiski neizmanto /v1/responses.

Oficiālās atsauces

Instalēšanai skatiet OpenCode introduction. Pielāgotiem pakalpojumu sniedzējiem skatiet Providers. Lai uzzinātu piemēros izmantotos modeļu ID, skatiet Claude model overview un GPT-6 Luna.

Aizstājiet katru vietniekvērtību ar vērtībām no sava OmniProxy konfigurācijas. Nekad nepublicējiet patieso atslēgu.

Saglabāts rezultāts vai HTTP 200 pats par sevi nepierāda pilnu aģenta saderību. Pārbaudiet avotu un modeli OmniProxy zvanu ierakstā.

Oficiālie avoti · OpenCode ↗