OpenCode መጫን እና OmniProxy ማዋቀር

OpenCode ፕሮጀክትዎን ከተርሚናል፣ IDE ወይም ዴስክቶፕ ሆነው ኮድ እንዲጽፉ የሚያስችል ክፍት ምንጭ (open-source) የኮዲንግ ረዳት ነው። ኮድዎን ወይም አውድዎን አያከማችም፣ ይህም ለግላዊነት ስሜታዊ ለሆኑ ፕሮጀክቶች ተስማሚ ያደርገዋል። build ፕሮጀክትን ለማሻሻል ጥቅም ላይ ይውላል፣ ሳለ plan በነባሪነት ለንባብ ብቻ ነው እና ያልተለመደ ኮድን ለመረዳት እና ለውጦችን ከማድረግዎ በፊት ለማቀድ ጠቃሚ ነው። እንደ ፍላጎቶችዎ የሞዴል አገልግሎት መምረጥ ይችላሉ።

ከመጀመርዎ በፊት

የመጫኛ ስክሪፕቱ ቀላሉ አማራጭ ነው። ዘመናዊ ተርሚናል ያስፈልግዎታል—ትዕዛዞችን ማሄድ እና ከፕሮጀክት ፋይሎች ጋር መስራት የሚችል ተርሚናል መተግበሪያ—እንደ WezTerm፣ Alacritty፣ Ghostty ወይም Kitty። በዊንዶውስ ላይ፣ WSL ይመረጣል። በዊንዶውስ ውስጥ የበለጠ የተሟላ አፈጻጸም እና ተግባራዊነት ያለው የሊኑክስ አካባቢ ያቀርባል።

ቀላሉ

የመጫኛ ስክሪፕት

• curl opencode.ai/install
• በ macOS Linux ላይ በቀጥታ ይጠቀሙ
• በዊንዶውስ ላይ WSL ይመከራል

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። ሁለትዮሽ ፋይሎች (Binary files) ከ Releases ሊወርዱ ይችላሉ። በዊንዶውስ ላይ በ Bun የመጫን ድጋፍ አሁንም በመካሄድ ላይ ነው።

የፕሮጀክት ማውጫዎን ያስገቡ፣ ከዚያ 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 የመዳረሻ ምስክርነት (credential) ነው፣ እና Model ID የሞዴሉ ሙሉ ስም ነው።

ሲጠቀሙ /v1/chat/completions፣ የ npm ጥቅልን ወደ ያዘጋጁ @ai-sdk/openai-compatible። የውይይት ማጠናቀቂያዎች (Chat Completions) የውይይት ጥያቄ በይነገጽ አይነት ነው። ወደ ይቀይሩ @ai-sdk/openai ሞዴሉ ሲጠቀም ብቻ /v1/responses። OmniProxy በውይይት ማጠናቀቂያዎች የመጨረሻ ነጥብ (endpoint) በኩል ጥቅም ላይ ሲውል፣ የተኳኋኝነት ጥቅሉን ያቆዩ።

ሙሉውን የሞዴል መታወቂያ ከ OmniProxy የአሁኑ ዝርዝር ይቅዱ፣ ማንኛውንም ሰያፍ መስመሮች ጨምሮ። ከ2026-10-09 ጀምሮ፣ ሁለት የማጣቀሻ መታወቂያዎች ነበሩ claude-sonnet-5-5 እና gpt-6-luna. gpt-6-luna የውይይት ማጠናቀቂያዎችን ይደግፋል፤ በውይይት ማጠናቀቂያዎች በኩል የተግባር ጥሪ የሚደገፈው ብቻ ነው reasoning_effort ነው none። በዝርዝሩ ውስጥ የሌለ መታወቂያ አይቅዱ።

የመሳሪያ ውቅር ያስገቡ

አቅራቢ (Provider) እንደ OpenCode ከሞዴል አገልግሎት ጋር ለመገናኘት የሚጠቀምባቸው የውቅር እሴቶች ስብስብ ተደርጎ ሊወሰድ ይችላል። የአቅራቢው ሰነድ በ ውስጥ ያልተዘረዘረ OpenAI-ተኳሃኝ አገልግሎትን ይይዛል /connect እንደ ብጁ አቅራቢ። OpenAI-ተኳሃኝ አገልግሎት ተመሳሳይ የጥያቄ ቅርጸት ይጠቀማል እና በተመሳሳይ የደንበኛ አይነት ሊጠራ ይችላል።

1. ያሂዱ /connect በ OpenCode ውስጥ እና ወደ ሌላ (Other) ይሸብልሉ::
2. የአቅራቢ መታወቂያ ያስገቡ። ከታች ያለው ምሳሌ ይጠቀማል omniproxy። ለማስታወስ ቀላል የሆነ መታወቂያ ይምረጡ ምክንያቱም በውቅር ፋይሉ ውስጥ ተመሳሳይውን መጠቀም አለብዎት።
3. የ OmniProxy API ቁልፍን ያስገቡ። ይህ እርምጃ ምስክርነቱን ብቻ ያስቀምጣል፤ አድራሻው እና ሞዴሎቹ አሁንም መጨመር አለባቸው 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}። በ2026-10-09 በ 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 ይህ ሩጫ እንደ ፋይል-ንባብ መሳሪያዎች ያሉ መሳሪያዎችን እንዲጠቀም ይፈቅዳል። በ2026-10-09 በ OpenCode 1.18.34 በተደረገው ሙከራ፣ የተገለጸውን ፋይል ይዘቶች በተሳካ ሁኔታ አንብቧል። የመጀመሪያው ሩጫ ሁለት ደቂቃ ያህል ወስዷል።

ለበይነተገናኝ አጠቃቀም፣ ያሂዱ opencode፣ ከዚያ ሞዴል ይምረጡ በ /models። መጠቀም ይችላሉ @ ፋይሎችን ለመፈለግ። ይጠቀሙ opencode auth list በኩል የተቀመጠውን ምስክርነት ለማረጋገጥ /connect፣ ከዚያ ምንጩን እና የሞዴል መታወቂያውን ለማረጋገጥ የ OmniProxy ጥያቄ መዝገቦችን ይፈትሹ።

አስጀምር

opencode ይጀምራል

• መጀመሪያ ወደ ፕሮጀክቱ cd ያድርጉ
• auth list መታወቂያውን ያሳያል
• የውቅር ፋይሉ በፕሮጀክቱ ውስጥ ነው

ስራ

ኮዱን አንብቧል

• ስለ አንድ የተወሰነ ፋይል ይጠይቁ
• ማብራሪያውን ይገምግሙ
• ስህተት ከሆነ /undo ይጠቀሙ

ምዝግብ ማስታወሻዎች (Logs)

በጌትዌይ ውስጥ ይታያል

• ምንጩ OpenCode ነው
• የሞዴል መታወቂያ ይዛመዳል
• ቁልፉን ወደ ማከማቻው አይላኩ

የተለመዱ ስህተቶች

• OmniProxy በ ስር አይታይም /models: በ ስር የገባው መታወቂያ መሆኑን ያረጋግጡ /connect በ ውስጥ ካለው ቁልፍ ጋር ይዛመዳል opencode.json፣ ያ npm ወደ ተዘጋጅቷል @ai-sdk/openai-compatible፣ እና ያ baseURL በ ያበቃል /v1።
• ምስክርነቱ ጠፍቷል፡ ያሂዱ opencode auth list። እንደ Bedrock ያሉ በአካባቢ ተለዋዋጮች ላይ የሚመሰረቱ አቅራቢዎች እዚህ አይታዩም፤ በ በኩል የተዋቀረ ብጁ አቅራቢ /connect መታየት አለበት።
• የዊንዶውስ ተግባራዊነት ያልተሟላ ነው፡ በ WSL ውስጥ የመጫኛ ስክሪፕቱን ይጠቀሙ።
• የሞዴል መታወቂያው ልክ ያልሆነ ነው፡ ከ OmniProxy የአሁኑ ዝርዝር እንደገና ይቅዱት እና ተጓዳኝ ቁልፉን በ ስር ያዘምኑ models።
• ጥያቄዎች ወደ የተሳሳተ የመጨረሻ ነጥብ (endpoint) እየሄዱ ነው፡ ያቆዩ @ai-sdk/openai-compatible ለ ውይይት ማጠናቀቂያዎች። በ OmniProxy ላይ ያለው ሞዴል በእርግጥ የሚጠቀም ካልሆነ በስተቀር ለምላሾች በይነገጽ ጥቅሉን አይቀይሩ /v1/responses.

ኦፊሴላዊ ማጣቀሻዎች

ለመጫን፣ OpenCode introduction ይመልከቱ። ለብጁ አቅራቢዎች፣ Providers ይመልከቱ። በምሳሌዎቹ ውስጥ ጥቅም ላይ የዋሉ የሞዴል መታወቂያዎች፣ Claude model overview ይመልከቱ እና GPT-6 Luna.

እያንዳንዱን የቦታ ያዥ (placeholder) በራስዎ የ OmniProxy ውቅር እሴቶች ይተኩ። እውነተኛ ቁልፍን በጭራሽ አያትሙ።

የተቀመጠ ውጤት ወይም HTTP 200 ብቻውን ሙሉ የAgent ተኳኋኝነትን አያረጋግጥም። በ OmniProxy የጥያቄ መዝገብ ውስጥ ምንጩን እና ሞዴሉን ያረጋግጡ።

ኦፊሴላዊ ምንጮች · OpenCode ↗