OpenCode on Ritemarki kolmas AI mootor, mis seisab Claude Code'i ja Codexi kõrval. Erinevus on arvelduses. Claude Code ja Codex logivad sisse oma kontodega. OpenCode on bring-your-own-key: suuna ta mistahes pakkuja juurde, kelle API võtme sul juba on, ja vali selle pakkuja mudelitest.
Kui maksad juba otse OpenAI-le API kasutuse eest, või sul on Google AI võti Gemini jaoks, või sul on OpenRouteri konto, lubab OpenCode neid võtmeid Ritemarki sees uuesti kasutada.
Mida sul vaja on
Sul on vaja vähemalt ühte API võtit ühelt järgmistest pakkujatest:
- OpenAI: logi sisse platform.openai.com, loo võti oma profiilimenüü alt.
- Google AI: võtmed antakse välja aadressil aistudio.google.com.
- Anthropic: võtmed antakse välja aadressil console.anthropic.com.
- OpenRouter: registreeru aadressil openrouter.ai; üks OpenRouteri võti annab juurdepääsu kümnetele mudelitele paljudelt pakkujatelt.
Saad konfigureerida nii palju, kui tahad. Mudelivalijasse ilmuvad ainult need pakkujad, kellel on salvestatud võti.
Samm 1: ava Seaded → OpenCode
Ava Ritemarki seaded (Cmd+, macOS-il, või hammasratta ikoon tegevusribal). Leia OpenCode sektsioon. Näed nelja API võtme välja, üks iga pakkuja kohta.
OpenCode'i binaari ennast tarnitakse juba Ritemarkiga koos, eraldi installimist pole. See töötab lapsprotsessina, juhitult Agent Client Protocoli (ACP) kaudu, sama protokolli, mida Codex kasutab. macOS-il on tarnitav binaar Ritemarki enda arendaja ID-ga uuesti allkirjastatud koos hardened runtime'iga, nii et see käivitub puhtalt ilma Gatekeeperi hoiatuseta.
Samm 2: kleebi oma API võtmed
Kleebi iga võti oma pakkuja väljale ja vajuta Enter või klõpsa väljast eemale, et salvestada. Võtmed salvestatakse operatsioonisüsteemi turvalise volituste hoidlasse: macOS-il Keychain, Windowsil Credential Manager.
Hetkel, kui võti on salvestatud, värskendub AI külgriba mudelivalija OpenCode'i grupp. Ritemarki uuesti laadida pole vaja.
Kui võtmeid pole konfigureeritud, palub OpenCode'i sektsioon mudelivalijas hoopis avada seaded, mitte ei näita tühja loendit.
Samm 3: vali OpenCode'i mudel
Ava AI külgriba ja klõpsa sõnumivälja all olevat mudelivalikut. Näed kolme gruppi:
- Claude: sinu olemasoleva Claude'i konto mudelid.
- Codex: sinu olemasoleva ChatGPT konto mudelid.
- OpenCode: iga mudel igalt pakkujalt, kelle oled konfigureerinud.
Vali suvaline OpenCode'i mudel ja hakka vestlema. Vastused voogavad nagu oodatud. Mõtlemine on summeeritud väikese arvu "Thinking" kirjete kujul, mitte sadade üherealiste tegevustena, nii et tegevuslogi jääb loetavaks. Tööriistakutsed ilmuvad tegevustena.
Failimuudatuste kinnitamine
OpenCode järgib režiimi, mille valid sisestusvälja juures. Auto (vaikimisi) puhul lähevad muudatused kausta sees läbi ilma kaardita. Kui valid Manual ja OpenCode tahab muuta avatud faili, saad üksiku Failimuudatuse kinnitamise kaardi sihtfaili teega. Fail kettal jääb puutumatuks, kuni klõpsad Kinnita.
See töötab samamoodi iga OpenCode'i juhitud muudatuse jaoks, sõltumata sellest, milline mudel selle tegi. Manual-režiimis on kinnitamine failimuudatuse-, mitte sessioonipõhine. Plan only valikut OpenCode'il pole.
Kaks olulist piiret:
- Tööruumist väljapoole kirjutamised lükatakse automaatselt tagasi. OpenCode ei saa kirjutada faili väljaspool su praegust Ritemarki tööruumi. Pole küsimust ega lülitit, kirjutus blokeeritakse silla kihil.
- Manual-režiimis on kinnitus vajalik isegi väikeste muudatuste juures. Ühe märgi muutus toob siiski kinnituskaardi.
Käed-vabad töö (Auto)
Kui tahad, et OpenCode töötaks käed-vabad, näiteks pika refaktoreerimise või mitmefaililise tõlke ajal, jäta sisestusvälja režiimiks Auto, mis on vaikimisi valik.
Auto-režiimis:
- Muudatused tööruumi sees toimuvad ilma kinnituskaardita.
- Tööriistakutsed toimuvad ilma kinnituskaardita.
Auto-režiimis kehtib endiselt:
- Tööruumist väljapoole kirjutamised jäävad blokeerituks. Auto ei ava seda teed. Kui sul on vaja, et OpenCode puudutaks faile väljaspool projekti, pead need esmalt tööruumi sisse kolima.
Vali režiimiks Manual, kui tahad kinnituskaardid tagasi. Seaded → OpenCode all on endiselt näha vanem lüliti Automaatselt kinnita muudatused ja tööriistakutsed, kuid seda, kas OpenCode küsib luba, otsustab sisestusvälja režiim.
Mille jaoks iga pakkuja hea on
Üldine juhis. Vali see, mis sobib su tööga.
| Pakkuja | Tugev valdkond | Märkused |
|---|---|---|
| OpenAI | Üldine kirjutamine, koodi mõistmine, kiire vastus | Praegused GPT-mudelid ilmuvad valijasse, kui OpenAI võti on salvestatud |
| Google AI | Pika kontekstiga ülesanded, mitmekeelne sisu | Gemini kontekstiaken on suuremeelne |
| Anthropic | Samad Claude mudelid, mis Claude Code'is, aga makstud su API võtme kaudu | Kasulik, kui tahad Claude'i ilma Claude.ai tellimuseta |
| OpenRouter | Paljude mudelite proovimine ühe võtmega | Koondab kümneid pakkujaid ühe arve taga |
Saad mudeleid vestluse keskel vahetada. Vestluse ajalugu järgib lõnga, mitte mudelit.
Privaatsus
Su API võtmed elavad su OS-i volituste hoidlas. Ritemark ei edasta neid kuhugi mujale kui pakkujale, kelle jaoks sa need konfigureerisid.
Iga voor, mille saadad OpenCode'i kaudu, läheb pakkujale, kellele kuulub valitud mudel. Pole Ritemarki proxyt, pole Ritemarki kontot ega pole Ritemarki pilve. Liiklus läheb otse su masinast valitud pakkujale.
Tõrkeotsing
OpenCode'i grupp näitab "Add API keys to use OpenCode"
Sa pole veel ühtegi pakkuja võtit salvestanud. Ava Seaded → OpenCode ja kleebi vähemalt üks võti.
Uus võti ei ilmu mudelivalijasse
Valija peaks koheselt värskenduma, kui võti salvestatakse. Kui see ei juhtu, vaheta külgriba (Explorerist AI-le ja tagasi), et sundida ümber lugema. Versioonis 1.7.3 loeb valija ka fookuse saamisel uuesti.
Mudel keeldub veaga "out-of-workspace write blocked"
OpenCode püüdis kirjutada faili väljaspool su praegust Ritemarki tööruumi. Kolime sihtfaili tööruumi sisse ja proovi uuesti, või sõnastage päring ümber nii, et agent töötab ainult projektipuus.
macOS-i Gatekeeperi hoiatus OpenCode'i käivitamisel
OpenCode'i binaar, mis tarnitakse v1.7.3 ja hilisematega, on uuesti allkirjastatud Ritemarki arendaja ID-ga koos hardened runtime'iga. Kui näed Gatekeeperi hoiatust, töötad vanema versiooniga. Uuenda Ritemark ja hoiatus kaob.
Kiirviide
| Tegevus | Kuidas |
|---|---|
| Ava OpenCode'i seaded | Seaded → OpenCode |
| Lisa pakkuja võti | Kleebi pakkuja väljale, vajuta Enter |
| Lülitu OpenCode'i mudelile | Mudelivalija → OpenCode'i grupp → vali mudel |
| Kinnita muudatus (Manual) | Klõpsa Kinnita Failimuudatuse kinnitamise kaardil |
| Töötamine käed-vabad | Vali sisestusvälja juures Auto (vaikimisi) |
| Blokeeri kirjutus tööruumist välja | Automaatne, alati sees, ka Auto-režiimis |
Seotud
- AI külgriba: vaheta Claude'i, Codexi ja OpenCode'i vahel
- Agendi konfigureerija: konfigureeri suvaline agent visuaalselt
- Claude Code'i seadistamine: claude'i esmakordne seadistamine
- Codexi seadistamine: openAI Codexi seadistamine