OpenCode ఇన్‌స్టాలేషన్ మరియు OmniProxy కాన్ఫిగరేషన్

OpenCode అనేది ఒక ఓపెన్-సోర్స్ కోడింగ్ అసిస్టెంట్, ఇది టెర్మినల్, IDE లేదా డెస్క్‌టాప్ నుండి కోడ్ వ్రాయడానికి మిమ్మల్ని అనుమతిస్తుంది. ఇది మీ కోడ్ లేదా కాంటెక్స్ట్‌ను నిల్వ చేయదు, ఇది గోప్యత-సెన్సిటివ్ ప్రాజెక్ట్‌లకు అనుకూలంగా ఉంటుంది. build ప్రాజెక్ట్‌ను సవరించడానికి ఉపయోగించబడుతుంది, అయితే plan డిఫాల్ట్‌గా రీడ్-ఓన్లీగా ఉంటుంది మరియు తెలియని కోడ్‌ను అర్థం చేసుకోవడానికి మరియు మార్పులు చేసే ముందు ప్లాన్ చేయడానికి ఉపయోగపడుతుంది. మీరు మీ అవసరాలకు అనుగుణంగా మోడల్ సర్వీస్‌ను ఎంచుకోవచ్చు.

ప్రారంభించే ముందు

ఇన్‌స్టాలేషన్ స్క్రిప్ట్ సులభమైన ఎంపిక. మీకు ఆధునిక టెర్మినల్ అవసరం—WezTerm, Alacritty, Ghostty, లేదా Kitty వంటి కమాండ్‌లను రన్ చేయగల మరియు ప్రాజెక్ట్ ఫైళ్లతో పని చేయగల టెర్మినల్ అప్లికేషన్. Windowsలో, WSL ప్రాధాన్యత ఇవ్వబడుతుంది. ఇది Windowsలో Linux ఎన్విరాన్‌మెంట్‌ను మరింత పూర్తి పనితీరు మరియు ఫంక్షనాలిటీతో అందిస్తుంది.

అత్యంత సులభం

ఇన్‌స్టాలేషన్ స్క్రిప్ట్

• curl opencode.ai/install
• macOS Linuxలో నేరుగా ఉపయోగించండి
• Windowsలో WSL సిఫార్సు చేయబడింది

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• ఫార్ములా కంటే తరచుగా అప్‌డేట్ చేయబడుతుంది
• Arch కోసం కూడా ప్యాకేజీ అందుబాటులో ఉంది

నేటివ్ Windows

ప్యాకేజీ మేనేజర్

• choco లేదా scoop
• లేదా npmతో గ్లోబల్‌గా ఇన్‌స్టాల్ చేయండి
• మీరు దీన్ని రిలీజ్‌ల నుండి కూడా డౌన్‌లోడ్ చేసుకోవచ్చు

ప్రస్తుత మోడల్ జాబితా నుండి మోడల్ IDని కూడా సిద్ధం చేసుకోండి. మోడల్ ID అనేది ఒక నిర్దిష్ట మోడల్‌ను ఖచ్చితంగా గుర్తించడానికి సర్వీస్ ఉపయోగించే పేరు.

మొదటిసారి ఇన్‌స్టాల్ చేసి ప్రారంభించడం

అత్యంత సులభమైన ఇన్‌స్టాలేషన్ కమాండ్:

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

మీరు ఈ ఇన్‌స్టాలేషన్ పద్ధతుల్లో ఒకదాన్ని కూడా ఉపయోగించవచ్చు:

• Node.js: npm install -g opencode-ai. Bun, pnpm, మరియు Yarn కూడా సంబంధిత గ్లోబల్ ఇన్‌స్టాలేషన్ కమాండ్‌లను కలిగి ఉన్నాయి; ఈ గైడ్ చివరలో ఉన్న పరిచయ పేజీని చూడండి.
• macOS మరియు Linuxలో Homebrew: brew install anomalyco/tap/opencode. ఈ ట్యాప్‌ను ఉపయోగించండి ఎందుకంటే ఇది Homebrew టీమ్ నిర్వహించే brew install opencode కంటే తరచుగా అప్‌డేట్ చేయబడుతుంది.
• Arch Linux: స్టేబుల్ రిలీజ్ కోసం sudo pacman -S opencodeని, లేదా కొత్త వెర్షన్ కోసం AUR ప్యాకేజీ opencode-binని ఉపయోగించండి.
• Windows: choco install opencode లేదా scoop install opencodeని ఉపయోగించండి. మీరు npm install -g opencode-aiని కూడా ఉపయోగించవచ్చు. బైనరీ ఫైళ్లను రిలీజ్‌ల నుండి కూడా డౌన్‌లోడ్ చేసుకోవచ్చు. Windowsలో 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 అనేది యాక్సెస్ క్రెడెన్షియల్, మరియు Model ID అనేది మోడల్ యొక్క పూర్తి పేరు.

/v1/chat/completions ఉపయోగిస్తున్నప్పుడు, npm ప్యాకేజీని @ai-sdk/openai-compatibleకి సెట్ చేయండి. Chat Completions అనేది ఒక రకమైన చాట్ అభ్యర్థన ఇంటర్‌ఫేస్. మోడల్ /v1/responsesని ఉపయోగిస్తున్నప్పుడు మాత్రమే @ai-sdk/openaiకి మారండి. OmniProxyని చాట్ కంప్లీషన్స్ ఎండ్‌పాయింట్ ద్వారా ఉపయోగించినప్పుడు, కంపాటబిలిటీ ప్యాకేజీని అలాగే ఉంచండి.

OmniProxy యొక్క ప్రస్తుత జాబితా నుండి పూర్తి మోడల్ IDని కాపీ చేయండి, స్లాష్‌లతో సహా. 2026-10-09 నాటికి, రెండు రిఫరెన్స్ IDలు claude-sonnet-5-5 మరియు gpt-6-luna. gpt-6-luna Chat Completionsకు మద్దతు ఇస్తుంది; Chat Completions ద్వారా ఫంక్షన్ కాలింగ్ reasoning_effort అనేది none అయినప్పుడు మాత్రమే మద్దతు ఇవ్వబడుతుంది. జాబితాలో లేని IDని కాపీ చేయవద్దు.

టూల్ కాన్ఫిగరేషన్‌ను నమోదు చేయడం

ప్రొవైడర్‌ను OpenCode మోడల్ సర్వీస్‌కు కనెక్ట్ చేయడానికి ఉపయోగించే కాన్ఫిగరేషన్ విలువల సెట్‌గా అర్థం చేసుకోవచ్చు. ప్రొవైడర్ డాక్యుమెంటేషన్ /connect కింద జాబితా చేయబడని OpenAI-కంపాటబుల్ సర్వీస్‌ను కస్టమ్ ప్రొవైడర్‌గా పరిగణిస్తుంది. OpenAI-కంపాటబుల్ సర్వీస్ అదే అభ్యర్థన ఫార్మాట్‌ను ఉపయోగిస్తుంది మరియు అదే రకమైన క్లయింట్ ద్వారా పిలవబడుతుంది.

1. OpenCodeలో /connectని రన్ చేసి Otherకి స్క్రోల్ చేయండి.
2. ప్రొవైడర్ IDని నమోదు చేయండి. కింది ఉదాహరణ omniproxyని ఉపయోగిస్తుంది. గుర్తుంచుకోవడానికి సులభమైన IDని ఎంచుకోండి ఎందుకంటే మీరు కాన్ఫిగరేషన్ ఫైల్‌లో అదే IDని ఉపయోగించాలి.
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 కింద నమోదు చేసిన ID opencode.jsonలోని కీతో సరిపోలాలి. ఈ ఫైల్‌లో నిజమైన సీక్రెట్ కీని ఉంచవద్దు. మీరు /connectని ఉపయోగించకపోతే, మీరు options.apiKeyలో {env:VARIABLE_NAME} వంటి ఎన్విరాన్‌మెంట్-వేరియబుల్ సింటాక్స్‌ను ఉపయోగించవచ్చు. OpenCode 1.18.34తో 2026-10-09న జరిగిన పరీక్షలో, /connectని ఉపయోగించకుండా కీని నేరుగా ప్రాజెక్ట్ యొక్క options.apiKeyలో ఉంచడం కూడా విజయవంతంగా కనెక్ట్ అయింది. గేట్‌వే కీని ధృవీకరించకపోతే, ఈ విలువ లోకల్ మెషీన్‌లో మాత్రమే ఉపయోగించే ప్లేస్‌హోల్డర్ స్ట్రింగ్ కావచ్చు. models కింద ఉన్న కీలు జాబితా నుండి పూర్తి IDలను ఉపయోగించాలి.

కీ

/connect

• దిగువన Otherని ఎంచుకోండి
• మీ స్వంత ప్రొవైడర్ IDని ఎంచుకోండి
• auth.jsonలో నిల్వ చేయబడింది

ప్రాజెక్ట్

opencode.json

• ప్రొవైడర్ కీ అదే పేరును ఉపయోగించాలి
• కంపాటబుల్ npm ప్యాకేజీని ఉపయోగించండి
• baseURL /v1తో ముగుస్తుంది

ఎంచుకోండి

/models

• మోడల్ జాబితాలో కనిపిస్తుంది
• ప్రశ్న అడిగే ముందు ఒకదాన్ని ఎంచుకోండి
• గేట్‌వే జాబితా నుండి IDని ఉపయోగించండి

నిజమైన టాస్క్‌తో ధృవీకరించడం

ముందుగా ప్రాజెక్ట్ డైరెక్టరీ నుండి ఒక నిజమైన టాస్క్‌ను రన్ చేయండి. మోడల్ రిఫరెన్స్ ఫార్మాట్ Provider ID/model ID; మోడల్ IDలోని ఏవైనా స్లాష్‌లను అలాగే ఉంచండి:

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

--auto ఈ రన్ ఫైల్-రీడింగ్ టూల్స్ వంటి టూల్స్‌ను ఉపయోగించడానికి అనుమతిస్తుంది. OpenCode 1.18.34తో 2026-10-09న జరిగిన పరీక్షలో, ఇది పేర్కొన్న ఫైల్ కంటెంట్‌ను విజయవంతంగా చదివింది. మొదటి రన్‌కు సుమారు రెండు నిమిషాలు పట్టింది.

ఇంటరాక్టివ్ ఉపయోగం కోసం, opencodeని రన్ చేసి, ఆపై /modelsతో మోడల్‌ను ఎంచుకోండి. మీరు ఫైల్స్ కోసం వెతకడానికి @ని ఉపయోగించవచ్చు. /connect ద్వారా సేవ్ చేయబడిన క్రెడెన్షియల్‌ను నిర్ధారించడానికి opencode auth listని ఉపయోగించండి, ఆపై మూలం మరియు మోడల్ IDని ధృవీకరించడానికి OmniProxy యొక్క అభ్యర్థన రికార్డులను తనిఖీ చేయండి.

ప్రారంభించండి

opencode ప్రారంభమవుతుంది

• ముందుగా ప్రాజెక్ట్‌కు cd చేయండి
• auth జాబితా IDని చూపుతుంది
• కాన్ఫిగరేషన్ ఫైల్ ప్రాజెక్ట్‌లో ఉంది

టాస్క్

ఇది కోడ్‌ను చదివింది

• నిర్దిష్ట ఫైల్ గురించి అడగండి
• దాని వివరణను సమీక్షించండి
• తప్పుగా ఉంటే /undoని ఉపయోగించండి

లాగ్స్

గేట్‌వేలో కనిపిస్తాయి

• మూలం OpenCode
• మోడల్ ID సరిపోలింది
• కీని కమిట్ చేయవద్దు

సాధారణ ఎర్రర్లు

• OmniProxy /models కింద కనిపించడం లేదు: /connect కింద నమోదు చేసిన ID opencode.jsonలోని కీతో సరిపోలుతుందని, npm అనేది @ai-sdk/openai-compatibleకి సెట్ చేయబడిందని, మరియు baseURL అనేది /v1తో ముగుస్తుందని తనిఖీ చేయండి.
• క్రెడెన్షియల్ లేదు: opencode auth listని రన్ చేయండి. ఎన్విరాన్‌మెంట్ వేరియబుల్స్‌పై ఆధారపడే Bedrock వంటి ప్రొవైడర్లు ఇక్కడ కనిపించవు; /connect ద్వారా కాన్ఫిగర్ చేయబడిన కస్టమ్ ప్రొవైడర్ కనిపించాలి.
• Windows ఫంక్షనాలిటీ అసంపూర్ణంగా ఉంది: WSL లోపల ఇన్‌స్టాలేషన్ స్క్రిప్ట్‌ను ఉపయోగించండి.
• మోడల్ ID చెల్లదు: OmniProxy యొక్క ప్రస్తుత జాబితా నుండి దాన్ని మళ్లీ కాపీ చేసి, models కింద సంబంధిత కీని అప్‌డేట్ చేయండి.
• అభ్యర్థనలు తప్పు ఎండ్‌పాయింట్‌కు వెళ్తున్నాయి: చాట్ కంప్లీషన్స్ కోసం @ai-sdk/openai-compatibleని ఉంచండి. OmniProxyలోని ఆ మోడల్ నిజంగా /v1/responsesని ఉపయోగిస్తే తప్ప, రెస్పాన్సెస్ ఇంటర్‌ఫేస్ కోసం ప్యాకేజీని మార్చవద్దు.

అధికారిక రిఫరెన్స్‌లు

ఇన్‌స్టాలేషన్ కోసం, OpenCode introduction చూడండి. కస్టమ్ ప్రొవైడర్ల కోసం, Providers చూడండి. ఉదాహరణలలో ఉపయోగించిన మోడల్ IDల కోసం, Claude model overview మరియు GPT-6 Luna చూడండి.

మీ స్వంత OmniProxy కన్ఫిగరేషన్ నుండి విలువలతో ప్రతి ప్లేస్‌హోల్డర్‌ను మార్చండి. నిజమైన కీని ఎప్పుడూ ప్రచురించకండి.

సేవ్ చేసిన ఫలితం లేదా HTTP 200 మాత్రమే పూర్తి ఏజెంట్ అనుకూలతను నిరూపించదు. OmniProxy కాల్ రికార్డ్‌లో వనరు మరియు మాడల్‌ను తనిఖీ చేయండి.

అధికారిక వనరులు · OpenCode ↗