OpenCode'i seadistamine (Bring Your Own Key)
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, ja ühte Automaatselt kinnita muudatused ja tööriistakutsed lülitit.
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 paneeli ülal mudeli rippmenüül. Näed kolme gruppi:
- Claude Code — 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
Kui 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 produtseeris. Kinnitamine on failimuudatuse, mitte sessiooni põhine.
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, pole lülitit — kirjutus blokeeritakse silla kihil.
- Kinnitus on vajalik isegi väikeste muudatuste juures. Ühe märgi muutus toob siiski kinnituskaardi.
Automaatselt kinnita muudatused ja tööriistakutsed
Kui tahad, et OpenCode töötaks käed-vabad — näiteks pika refaktoreerimise või mitmefaililise tõlke ajal — lülita Seaded → OpenCode all sisse Automaatselt kinnita muudatused ja tööriistakutsed lüliti.
Automaatkinnitusega:
- Muudatused tööruumi sees toimuvad ilma kinnituskaardita.
- Tööriistakutsed toimuvad ilma kinnituskaardita.
Automaatkinnitusega kehtib endiselt:
- Tööruumist väljapoole kirjutamised jäävad blokeerituks. Automaatkinnitus ei ava seda teed. Kui sul on vaja, et OpenCode puudutaks faile väljaspool projekti, pead need esmalt tööruumi sisse kolima.
Lülita automaatkinnitus uuesti välja, kui tahad kinnituskaardid tagasi. Lüliti on globaalne kõigi OpenCode'i sessioonide jaoks, mitte vestlusepõhine.
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 | GPT-4o perekond on laialt toetatud |
| 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.
"Plani kinnitamise" kaart näeb blokeeritud välja
Plani kinnitamise kaart renderdab nüüd usaldusväärselt täispiku plaani ja püsib ekraanil ainult sel ajal, kui agent tegelikult sind ootab. Kui näed Kinnita/Lükka tagasi nuppe ilma plaani sisuta, on see vana käitumine — veendu, et töötad versiooniga 1.7.3 või uuemaga.
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 | Klõpsa Kinnita Failimuudatuse kinnitamise kaardil |
| Töötamine käed-vabad | Lülita sisse "Automaatselt kinnita muudatused ja tööriistakutsed" |
| Blokeeri kirjutus tööruumist välja | Automaatne — alati sees, isegi automaatkinnitusega |
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