Codex CLI: sariling key sa halip na subscription

Ang Codex ay hindi tagapagpayo sa editor, kundi isang tagapagpatupad na may sariling pagpapasya. Isinasalita mo ang gawain, at siya mismo ang nagpapasya kung aling mga file ang babasahin, aling mga command ang isasagawa, at ano ang babaguhin. Nasa kanyang pagtatapon ang halos isang dosenang tool: pagpapatakbo ng command, pagbasa ng file, paggawa ng plano ng gawain, paghingi ng paglilinaw sa user, paglikha ng mga child agent para sa mga subtask.

Dalawang mode ng paggana. Interactive — codex na walang argumento, usapan sa terminal na may pagpapakita ng bawat hakbang. Non-interactive — codex exec "task", isang beses na pagpapatakbo hanggang resulta: maginhawa sa mga script at CI.

Nakapaloob ang seguridad: bilang default, gumagana ang agent sa sandbox at humihingi ng kumpirmasyon bago ang mga pagbabago. Ang antas ng kontrol ay itinakda sa configuration — mula sa "itanong lahat" hanggang sa ganap na autonomous na pagpapatakbo na may karapatang magsulat sa working directory.

Isa pang katangian — ang kalagayan ng usapan. Hindi hinihiling ng Codex sa server na tumanda ng anuman: hawak niya ang buong feed sa sarili niya at ipinapadala ito nang buo sa bawat hakbang. Para sa iyo, ibig sabihin nito na ang pag-uusap ay hindi namamalagi sa panig ng provider ng modelo, at ang pagpapalit ng endpoint ay hindi sumisira sa nasimulang session.

Ang pagkakaiba mula sa Claude Code at iba pang terminal agent ay mismong ang protocol. Nakikipag-usap ang Codex sa modelo sa pamamagitan ng Responses API, kung saan ang usapan ay inilalarawan hindi ng patag na listahan ng mga mensahe, kundi ng feed ng mga elemento: teksto, tawag sa tool, resulta ng tawag, bloke ng pag-iisip. Sa tool, nagbibigay ito ng mas mahigpit na modelo ng usapan, at sa iyo — ng pangangailangang magkaroon ng endpoint na nakakaintindi sa protocol na ito.

Mabilis na paraan — installer. Ang command na npx @joingonka/setup --tool codex mismo ang magdadagdag sa ~/.codex/config.toml ng block ng provider na may wire_api = "responses", ang modelo at ang totoong context window nito, habang pinapanatili ang iyong mga komento at iba pang settings, at pagkatapos ay susuriin sa live request ang key at modelo. Kung may ibang provider nang napili sa config, hindi ito gagalawin ng installer at magmumungkahi ito ng command para sa one-time run. Inilalagay nito ang key direkta sa file (permissions na 600), sa field na experimental_bearer_token — ang tanging field kung saan pwedeng mag-imbak ang Codex ng key bilang literal; itinuturing mismo ng Codex na experimental ito. Ang manual na bersyon sa ibaba ay gumagamit ng environment variable.

Iniimbak ng Codex ang settings sa ~/.codex/config.toml. Ang sariling provider ay inilalarawan ng block na [model_providers.*], at ang mahalagang field dito ay wire_api: kung wala ito, susubukan ng Codex na magsalita sa Chat Completions at hindi makakabuo ng agentic loop.

# ~/.codex/config.toml
model_provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"

[model_providers.joingonka]
name = "JoinGonka Gateway"
base_url = "https://gate.joingonka.ai/v1"
env_key = "JOINGONKA_API_KEY"
wire_api = "responses"

Hindi isinusulat ang key sa file: pinapangalanan ng env_key ang environment variable kung saan kukunin ito ng Codex. Sariling pangalan ng variable, hindi OPENAI_API_KEY — sa ganoong paraan hindi hinaharang ng setup ang iba mong tools na gumagana sa OpenAI.

export JOINGONKA_API_KEY=jg-your-key

Itinatakda ng field na model ang default na modelo, at ng model_provider kung alin sa mga inilarawang block ang gagamitin. Pareho silang pwedeng i-override sa oras ng paglulunsad, kaya isang config lang ang kayang magsilbi sa maraming provider: pang-trabaho, pang-eksperimento at backup.

Ang key ay ibinibigay sa personal na account pagkatapos ng registration, at doon din makikita ang balanse at gastos. Kung ayaw mong galawin ang shared config, pwedeng ipasa ang parehong block nang isang beses sa pamamagitan ng -c: codex -c model_provider=joingonka …. At para magpanatili ng maraming independiyenteng configuration, itakda ang settings directory gamit ang variable na CODEX_HOME.

Ang pinakamabilis na paraan para makumpirma na gumagana ang setup ay isang beses na pagpapatakbo:

codex exec "Answer in one line: what is 17*3?"

Sa header ng sagot, ipinapakita ng Codex kung kanino ito kumakausap: model, provider: joingonka, ang sandbox mode, at ang session ID. Kung ang provider mo ang nakalagay doon at may sagot sa ibaba — buhay ang koneksyon.

Susunod, subukan ang pinakamahalagang bagay kaya nga ini-install ang Codex — ang paghawak ng mga file. Maglagay ng maliit na file na may halatang bug sa isang directory at ipahanap ito:

codex exec "Read calc.py and tell me in one sentence whether it has a bug."

Dapat mismo i-invoke ng agent ang read tool, buksan ang file, at sumagot nang tuwid — kasama ang linya kung saan ito matatagpuan. Kung nangyari ito, tama ang buong agentic loop (request → tool call → result → response) sa pamamagitan ng gateway.

Kung may nagawang mali, karaniwang mababasa na mismo sa mensahe ang diagnosis:

Maaaring tumagal ng ilang segundo ang unang request sa session: nagpapadala ang Codex ng malaking system prompt at paglalarawan ng lahat ng tools nito, at kailangan pang tanggapin ng node sa network ang task. Mas mabilis nang dumarating ang mga sumunod na sagot.

Lahat ng model ng network ay available sa iisang presyo, kaya ang pagpili ay tungkol sa behavior, hindi sa budget. Sa ibaba ay ang resulta ng live run ng parehong task (pagbabasa ng file at paghahanap ng error) sa pamamagitan ng Codex sa DeepSeek V4 Flash at MiniMax M2.7; ang GLM-5.3 Flash ay pumasok sa network pagkatapos ng run — ang properties ng model ang nakasaad.

Ang default na rekomendasyon ay DeepSeek V4 Flash: ang agent work ay mabilis na nauubos ang context, at ang 380K tokens ay nagbibigay-daan para tandaan ang maraming file nang sabay-sabay. Kung ang task ay nangangailangan ng malalim na lohika — gamitin ang GLM-5.3 Flash, pero maglaan ng buffer sa max_tokens: bahagi ng budget ng sagot ay napupunta sa pag-iisip. Ang model ay nababago sa pamamagitan ng isang linya ng model sa config o flag na -c model=… nang hindi binabago ang file.

Ang aktuwal na listahan ng mga model ng network ay laging makukuha sa GET https://gate.joingonka.ai/v1/models.

Ang mga agent tool ay gumagamit ng tokens nang iba kaysa sa chat: sa bawat parirala mo, nagdaragdag ang Codex ng system prompt at deskripsyon ng lahat ng tools, at pagkatapos ay nagsasagawa ng multi-step na diyalogo sa model. Sa isang live run, ang simpleng task na «basahin ang file at hanapin ang error» ay umabot sa humigit-kumulang 18-20 libong tokens. Normal na kabayaran ito para sa autonomy, at kaya naman mahalaga ang presyo bawat token.

Sa pamamagitan ng JoinGonka Gateway, ang mga token ay nagkakahalaga ng $0.0069 bawat milyon sa input at $0.021 bawat milyon sa output — ang presyo ay pareho para sa lahat ng models ng network at awtomatikong nakukuha sa pahinang ito mula sa live source.

Para sa paghahambing — paano gumagana ang mga bayad na opsyon sa mismong Codex at sa ibang katulad nito:

Ang bayad ay base sa aktwal na konsumo, walang monthly subscription at walang quota sa dami ng requests: walang 5-hour windows, limitasyon sa «prompts», at multipliers sa peak hours. Ang balanse ay pinupunan gamit ang cryptocurrency, at ang natitirang balance at araw-araw na gastos ay makikita sa personal na account. Ang detalyadong pagsusuri ng ekonomiya ay nasa artikulong tungkol sa pinakamurang API.

Ang kasaysayan ng dialogue ay hawak ng Codex mismo. Ipinapadala nito ang buong history sa bawat request at hindi hinihiling sa server na tandaan ang anumang bagay — at hindi namin iniimbak ang mga chat. Ang iyong code at mga prompt ay hindi nananatili sa gateway pagkatapos ng sagot.

Gumagana ang web-search. Nagdedeklara ang Codex ng search tool sa bawat request, at tinatanggap ito ng gateway: ang paghahanap ay ginagawa sa aming panig, at ang mga resulta ay isinasama sa sagot ng model.

Mga tool ay sarili, hindi cloud. Ang Codex ay nagpapatupad ng mga command at nagbabasa ng mga file nang lokal, sa iyong machine, kaya ang access sa proyekto ay hindi nakadepende sa model provider.

Sandbox. Sa Linux, gumagamit ang Codex ng bubblewrap para i-isolate ang mga pinapatakbong command. Kung wala ito sa system, magbabala ang Codex at gagamit ng built-in na kopya — hindi ito nakakaapekto sa trabaho, ngunit mas maginhawang i-install ang package gamit ang standard manager.

Kung kailangan mong magtrabaho sa mga imahe — screenshot ng interface, diagram sa litrato — gumamit ng tool na may vision-capable model para sa ganoong mga gawain: sa Gonka network, ang mga model ay puro text. Para sa code, command, at mga file, hindi ito isang limitasyon.

Iba pang terminal agents, kung hindi angkop ang Codex: quick start para sa API ay nagpapakita kung paano ikonekta ang anumang compatible na tool sa loob ng ilang minuto.