Codex CLI: sariling key sa halip na subscription

Ang Codex ay hindi tagabigay ng hint sa editor, kundi isang independiyenteng tagapagpatupad. Binabalangkas mo ang gawain gamit ang mga salita, at siya na ang nagpapasya kung aling mga file ang babasahin, anong mga command ang ipapatupad, at ano ang babaguhin. Mayroon itong mga sampung tool: pagtakbo ng mga command, pagbabasa ng file, pagpapanatili ng plano ng trabaho, pagtatanong ng paglilinaw sa user, at paggawa ng mga sub-agent para sa mga sub-task.

Dalawang mode ng operasyon. Interactive — codex na walang arguments, isang dialogue sa terminal na nagpapakita ng bawat hakbang. Non-interactive — codex exec «task», isang beses na run hanggang sa resulta: maginhawa sa mga script at CI.

Built-in ang seguridad: bilang default, gumagana ang agent sa isang sandbox at humihingi ng kumpirmasyon bago gumawa ng mga pagbabago. Ang antas ng kontrol ay itinatakda sa configuration — mula sa "tanungin ang lahat" hanggang sa ganap na autonomous na pagtakbo na may karapatang magsulat sa working directory.

Isa pang feature ay ang status ng dialogue. Hindi hinihiling ng Codex sa server na tandaan ang anumang bagay: hawak nito ang buong thread at ipinapadala ito nang buo sa bawat step. Para sa iyo, nangangahulugan ito na ang palitan ng mensahe ay hindi naiiwan sa panig ng model provider, at ang pagpapalit ng endpoint ay hindi nakakasira sa sinimulang session.

Ang pagkakaiba mula sa Claude Code at iba pang terminal agent ay ang mismong protocol. Nakikipag-ugnayan ang Codex sa modelo sa pamamagitan ng Responses API, kung saan ang palitan ng mensahe ay inilalarawan hindi bilang isang flat na listahan ng mga mensahe, kundi bilang isang thread ng mga elemento: text, tool call, resulta ng call, at reasoning block. Nagbibigay ito sa tool ng mas mahigpit na modelo ng dialogue, at sa iyo — ang pangangailangan na magkaroon ng endpoint na nauunawaan ang protocol na ito.

Iniimbak ng Codex ang mga setting sa ~/.codex/config.toml. Ang iyong sariling provider ay inilalarawan ng block na [model_providers.*], at ang pangunahing field dito ay wire_api: kung wala ito, susubukan ng Codex na magsalita sa Chat Completions at hindi nito mabubuo ang agentic cycle.

# ~/.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: ang env_key ay tumutukoy sa environment variable kung saan kukunin ng Codex ang key. Ang pangalan ng variable ay sarili nito, hindi OPENAI_API_KEY — sa ganitong paraan, hindi ma-i-intercept ng setting ang iba mong tool na gumagana sa OpenAI.

export JOINGONKA_API_KEY=jg-iyong-key

Itinatakda ng field na model ang default na modelo, at ang model_provider naman ang pipili kung aling inilalarawang block ang gagamitin. Parehong nare-redefine sa oras ng pagtakbo, kaya ang isang config ay madaling makapagsilbi sa maraming provider: work, experimental, at backup.

Ang key ay ibinibigay sa personal na cabinet pagkatapos ng pagpaparehistro; doon mo rin makikita ang balanse at pagkonsumo. Kung mas gusto mong huwag galawin ang general config, ang parehong block ay maaaring ipasa nang isang beses sa pamamagitan ng -c: codex -c model_provider=joingonka …. At para panatilihin ang maraming independiyenteng configuration, tukuyin ang settings directory gamit ang variable na CODEX_HOME.

Ang pinakamabilis na paraan upang matiyak na gumagana ang link ay isang one-time run:

codex exec "Sagutin sa isang linya: magkano ang 17*3?"

Sa header ng tugon, ipinapakita ng Codex kung kanino ito gumagana: model, provider: joingonka, sandbox mode, at session ID. Kung naroon ang iyong provider at may dumating na sagot sa ibaba, buhay ang koneksyon.

Susunod, dapat mong suriin ang pangunahing dahilan kung bakit naka-install ang Codex — ang trabaho sa mga file. Maglagay ng maliit na file na may halatang error sa direktoryo at hilingin na hanapin ito:

codex exec "Basahin ang calc.py at sabihin sa isang pangungusap kung may error."

Dapat kusa ng agent na tawagin ang read tool, buksan ang file, at sagutin ang tanong — na may kasamang numero ng linya. Kung nangyari ito, ang kumpletong agent cycle (request → tool call → result → response) sa pamamagitan ng gateway ay maayos na gumagana.

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

Ang unang request sa session ay maaaring tumagal ng ilang segundo: nagpapadala ang Codex ng malaking system prompt at deskripsyon ng lahat ng tool nito, at kailangan tanggapin ng network node ang task. Ang mga susunod na sagot ay mas mabilis na darating.

Ang lahat ng models ng network ay available sa parehong 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) gamit ang Codex sa bawat model.

Ang default na rekomendasyon ay DeepSeek V4 Flash: ang agent work ay mabilis na nakakaubos ng context volume, at ang 380K tokens ay nagbibigay ng kakayahang humawak ng maraming file nang sabay-sabay. Kung gusto mo ng napakaikling sagot, piliin ang Kimi K2.6. Ang model ay napapalitan sa pamamagitan ng isang linya na model sa config o gamit ang flag na -c model=… nang hindi binabago ang file.

Ang updated na listahan ng models 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.0047 bawat milyon sa input at $0.014 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.