Инсталиране на OpenCode и конфигуриране на OmniProxy

OpenCode е асистент за кодиране с отворен код, който ви позволява да пишете код от терминал, IDE или настолен компютър. Той не съхранява вашия код или контекст, което го прави подходящ за проекти, чувствителни към поверителността. build се използва за промяна на проект, докато plan е само за четене по подразбиране и е полезен за разбиране на непознат код и планиране на промени, преди да бъдат направени. Можете да изберете услуга за модели според вашите нужди.

Преди да започнете

Инсталационният скрипт е най-лесната опция. Нуждаете се от модерен терминал — терминално приложение, което може да изпълнява команди и да работи с файлове на проекти — като WezTerm, Alacritty, Ghostty или Kitty. На Windows се предпочита WSL. Той предоставя Linux среда в рамките на Windows с по-пълна производителност и функционалност.

Най-лесно

Инсталационен скрипт

• curl opencode.ai/install
• Използвайте директно на macOS Linux
• WSL се препоръчва на Windows

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Актуализира се по-често от формулата
• Наличен е пакет и за Arch

Native Windows

Мениджър на пакети

• choco или scoop
• Или инсталирайте глобално с npm
• Можете също да го изтеглите от Releases

Също така подгответе идентификатора на модела от текущия списък с модели. Идентификаторът на модела е името, което услугата използва, за да идентифицира точно конкретен модел.

Инсталиране и първо стартиране

Най-лесната команда за инсталиране е:

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

Можете също да използвате един от тези методи за инсталиране:

• Node.js: npm install -g opencode-ai. Bun, pnpm и Yarn също имат съответни команди за глобална инсталация; вижте въвеждащата страница в края на това ръководство.
• Homebrew на macOS и Linux: brew install anomalyco/tap/opencode. Използвайте този tap, защото се актуализира по-често от brew install opencode, който се поддържа от екипа на Homebrew.
• Arch Linux: използвайте sudo pacman -S opencode за стабилното издание или AUR пакета opencode-bin за по-нова версия.
• Windows: използвайте choco install opencode или scoop install opencode. Можете също да използвате npm install -g opencode-ai. Двоичните файлове могат също да бъдат изтеглени от Releases. Поддръжката за инсталиране с Bun на Windows все още е в процес на разработка.

Влезте в директорията на вашия проект, след което стартирайте OpenCode:

cd /path/to/project
opencode

Когато го използвате за първи път, можете да стартирате /init. Той анализира проекта и създава AGENTS.md в корена на проекта. Този файл може да бъде добавен в Git, така че проектът да запази тези инструкции.

Получаване на стойности за връзка от OmniProxy

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

baseURL е адресът на услугата, API Key е идентификационните данни за достъп и Model ID е пълното име на модела.

Когато използвате /v1/chat/completions, задайте npm пакета на @ai-sdk/openai-compatible. Chat Completions е тип интерфейс за заявки за чат. Превключете към @ai-sdk/openai само когато моделът използва /v1/responses. Когато OmniProxy се използва чрез крайната точка за chat completions, запазете пакета за съвместимост.

Копирайте целия идентификатор на модела от текущия списък на OmniProxy, включително всички наклонени черти. Към 09.10.2026 г. две референтни идентификатора бяха claude-sonnet-5-5 и gpt-6-luna. gpt-6-luna поддържа Chat Completions; извикването на функции чрез Chat Completions се поддържа само когато reasoning_effort е none. Не копирайте идентификатор, който не е в списъка.

Въвеждане на конфигурацията на инструмента

Доставчикът (Provider) може да се разбере като набор от конфигурационни стойности, които OpenCode използва за свързване към услуга за модели. Документацията на доставчика третира услуга, съвместима с OpenAI, която не е изброена под /connect като персонализиран доставчик. Услуга, съвместима с OpenAI, използва същия формат на заявката и може да бъде извикана от същия тип клиент.

1. Стартирайте /connect в OpenCode и превъртете до Other.
2. Въведете идентификатор на доставчик. Примерът по-долу използва omniproxy. Изберете идентификатор, който е лесен за запомняне, защото трябва да използвате същия в конфигурационния файл.
3. Въведете API ключа на OmniProxy. Тази стъпка записва само идентификационните данни; адресът и моделите все още трябва да бъдат добавени към opencode.json. Идентификационните данни се съхраняват в ~/.local/share/opencode/auth.json.
4. Създайте или променете opencode.json в директорията на проекта:

{
  "$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. Стартирайте /models. Персонализираният доставчик и неговите модели ще се появят в списъка.

Идентификаторът, въведен под /connect трябва да съвпада с ключа в opencode.json. Не поставяйте реален таен ключ в този файл. Ако не използвате /connect, можете да използвате синтаксис за променливи на средата в options.apiKey, като например {env:VARIABLE_NAME}. При тестване на 09.10.2026 г. с OpenCode 1.18.34, поставянето на ключа директно в options.apiKey на проекта без използване на /connect също се свърза успешно. Ако шлюзът не валидира ключа, тази стойност може да бъде низ-заместител, използван само на локалната машина. Ключовете под models трябва да използват пълните идентификатори от списъка.

Ключ

/connect

• Изберете Other в долната част
• Изберете свой собствен идентификатор на доставчик
• Съхранява се в auth.json

Проект

opencode.json

• Ключът на доставчика трябва да използва същото име
• Използвайте съвместим npm пакет
• baseURL завършва с /v1

Изберете

/models

• Моделът се появява в списъка
• Изберете един, преди да зададете въпрос
• Използвайте идентификатора от списъка на шлюза

Проверка с реална задача

Първо изпълнете една реална задача от директорията на проекта. Форматът на препратката към модела е Provider ID/model ID; запазете всички наклонени черти в идентификатора на модела:

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

--auto позволява на това изпълнение да използва инструменти като инструменти за четене на файлове. При тестване на 09.10.2026 г. с OpenCode 1.18.34, той успешно прочете съдържанието на посочения файл. Първото изпълнение отне около две минути.

За интерактивна употреба стартирайте opencode, след това изберете модел с /models. Можете да използвате @ за търсене на файлове. Използвайте opencode auth list за потвърждаване на идентификационните данни, записани чрез /connect, след това проверете записите на заявките на OmniProxy, за да потвърдите източника и идентификатора на модела.

Стартиране

opencode стартира

• Първо cd до проекта
• auth list показва идентификатора
• Конфигурационният файл е в проекта

Задача

Той прочете кода

• Попитайте за конкретен файл
• Прегледайте неговото обяснение
• Използвайте /undo, ако е грешно

Логове

Видими в шлюза

• Източникът е OpenCode
• Идентификаторът на модела съвпада
• Не добавяйте ключа в хранилището

Чести грешки

• OmniProxy не се появява под /models: Проверете дали идентификаторът, въведен под /connect съвпада с ключа в opencode.json, че npm е зададено на @ai-sdk/openai-compatible, и че baseURL завършва с /v1.
• Идентификационните данни липсват: Стартирайте opencode auth list. Доставчици като Bedrock, които разчитат на променливи на средата, не се появяват тук; персонализиран доставчик, конфигуриран чрез /connect трябва да бъде видим.
• Функционалността на Windows е непълна: Използвайте инсталационния скрипт в рамките на WSL.
• Идентификаторът на модела е невалиден: Копирайте го отново от текущия списък на OmniProxy и актуализирайте съответния ключ под models.
• Заявките отиват към грешна крайна точка: Запазете @ai-sdk/openai-compatible за chat completions. Не променяйте пакета за интерфейса Responses, освен ако този модел в OmniProxy действително не използва /v1/responses.

Официални препратки

За инсталиране вижте OpenCode introduction. За персонализирани доставчици вижте Providers. За идентификаторите на модели, използвани в примерите, вижте Claude model overview и GPT-6 Luna.

Заменете всяка плейсхолдер стойност със стойности от вашата собствена конфигурация на OmniProxy. Никога не публикувайте истински ключ.

Запазен резултат или HTTP 200 сам по себе си не доказва пълна съвместимост на агента. Проверете източника и модела в записа на заявката в OmniProxy.

Официални източници · OpenCode ↗