Codex VS Code API-sleutel: gebruik een aangepaste endpoint

Wat je instelt

Coding assistants in VS Code communiceren via HTTP met een model. De meeste gebruiken het OpenAI-API-formaat, waardoor ze een aangepaste basis-URL en sleutel accepteren in plaats van de standaard van de leverancier. Deze dienst is OpenAI-compatibel, dus hij werkt met elke tool die deze optie biedt.

Wees duidelijk over wat er aan de andere kant staat. Het is één open-weight model, uitgevoerd door een onafhankelijke provider, afgestemd op antwoorden zonder content refusals voor wettelijk toegestaan gebruik door volwassenen. Het is niet het Codex-model van OpenAI en geen officiële API van een andere leverancier. Het is alleen tekst, met een contextvenster van 100.000 tokens, tool calling en JSON-modus. Wil je de details van de OpenAI-stijl routes lezen? Lees de docs; heb je alleen het adres nodig? Bekijk de pagina over de Codex API base URL.

Hier zijn de drie waarden die je overal kunt gebruiken:

Haal een sleutel en test hem eerst

Maak een account aan op de API-sleutelpagina met Google of met e-mail en wachtwoord. Nieuwe gebruikers kunnen met één klik na het inloggen $0,50 aan gratis proeftegoed claimen, geldig voor 7 dagen, geen creditcard vereist. Test de sleutel vervolgens in een terminal voordat je VS Code aanraakt. Een werkende curl-oproep bewijst dat de sleutel en URL werken, zodat latere fouten over de extensie gaan.

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

Het antwoord is een JSON van chatcompleties, en de response bevat een X-Balance-USD header met je resterende tegoed. Bewaar de sleutel in een omgevingsvariabele of de geheime opslag van de extensie, nooit in een repository.

Codex-extensie en CLI: configuratiebestand

De OpenAI Codex-tooling ondersteunt aangepaste modelproviders via een TOML-configuratiebestand in je thuismap, en de VS Code-extensie deelt deze configuratie volgens de documentatie met de CLI. Controleer dit tegen de huidige Codex-documentatie voor je versie, omdat het formaat is geëvolueerd.

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

Punten om te controleren:

• base_url eindigt op /v1, zonder /chat/completions.
• env_key is de naam van de environment variable, niet de sleutel zelf.
• wire_api selecteert het request-formaat. Deze service accepteert zowel POST /v1/chat/completions als POST /v1/responses. Probeer eerst "chat"; gebruik "responses" als je Codex-versie dit vereist.
• Start VS Code vanuit een shell waarin de variabele is ingesteld, of herstart hem nadat je de variabele aan je profiel hebt toegevoegd. Een GUI-launch op macOS ziet shell-exporten vaak niet.

Agent-style tools vertrouwen op tool calling. Dit wordt hier ondersteund, inclusief gestreamde tool calls, maar de kwaliteit varieert per model, dus voer eerst een kleine taak uit. De gerelateerde pagina over het API gebruiken in Cursor behandelt een vergelijkbare setup in een andere editor.

Continue, Cline en andere extensies

Derde-partijextensies hebben elk hun eigen scherm, maar het patroon is constant: kies een OpenAI- of "OpenAI-compatible" aanbieder, en vul vervolgens basis-URL, sleutel en model in. Continue gebruikt een YAML-configuratie:

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline en Roo Code bieden een "OpenAI Compatible" provider aan in hun instellingenpaneel met dezelfde drie velden. Namen en menu's veranderen vaak, dus zoek in de documentatie van de extensie zelf naar "OpenAI compatible" of "custom base URL". Als een extensie geen veld heeft voor de base URL, kan deze dit endpoint niet gebruiken.

Tips die tijd besparen:

• Schakel tab-autocompletie uit tegen het gehoste model, tenzij je een verzoek bij elke pauze wilt. Chat- en edit-acties zijn goedkoper.
• Stel een kleiner contextvenster in de extensie in voor dagelijkse edits. Het versturen van hele repositories naar het model kost input tokens elke keer.
• Gebruik een aparte sleutel per tool, zodat je kunt zien welke je tegoed gebruikt.

Welke editor-taken zijn geschikt voor dit model

Een algemeen tekstmodel met een groot venster is een goede keuze voor verschillende dagelijkse taken: het uitleggen van onbekende code, het schrijven van unit tests voor een functie, het converteren van een script tussen talen, het opstellen van docstrings en regex, en het herschrijven van een module wanneer je het hele bestand plakt. Het 100.000-token contextvenster betekent dat een paar middelgrote bestanden plus je instructies in één request passen, en de completion kan gebruiken wat er over is.

Wees realistisch over de rest. Het is geen gespecialiseerd coding model met editor-aware training, dus grote multi-file agent runs kunnen meer guidance en meer controleren nodig hebben dan je zou geven aan een tool die daarvoor is gebouwd. Vraag om diffs in plaats van hele bestanden, controleer elke wijziging voordat je deze accepteert, en voer je tests uit. Als een taak content vereist die een gefilterde assistant weigert, zoals het schrijven van volwassen fictie-scaffolding of security-research tekst voor wettelijk gebruik, is een endpoint zonder content refusals de reden om deze te gebruiken.

Wat het kost in een editor

Prijzen zijn $0,15 per 1M input tokens en $0,50 per 1M output tokens. Coding tools sturen veel context, dus kijk eerst naar input.

Voorbeeld: een edit request met 8.000 tokens aan file context en een 600-token antwoord kost 8.000 x $0,15 / 1M + 600 x $0,50 / 1M = $0,0012 + $0,0003 = $0,0015. Een dag met 150 van dergelijke requests kost 150 x $0,0015 = $0,225. Twintig werkdagen: $4,50.

Een agent die veel bestanden leest, kan 40.000 tokens per stap versturen. Bij die grootte kost één stap $0,006 plus de output, dus 100 stappen kosten ongeveer $0,60 plus output. Houd agent loops in de gaten. Mislukte of geweigerde requests worden niet in rekening gebracht, en tegoed vervalt nooit. Opwaarderingen van $20 tot $500 kunnen worden betaald met een kaart (Visa, Mastercard, Apple Pay, Google Pay) of crypto. Huidige plannen staan op de prijzenpagina.

Probleemoplossing

401 Niet geautoriseerd

De sleutel ontbreekt, heeft een losse spatie, of de environment variable is niet zichtbaar voor VS Code. Herstart de editor vanuit een terminal waarin de variable is ingesteld.

404 of "model niet gevonden"

Gebruik het exacte model uncensored en de base URL met /v1 aan het einde.

429-fouten

Een volledige sleutel staat 8 gelijktijdige requests en 300 per minuut toe; de proefsleutel staat 2 en 60 toe. Een extensie die meerdere gelijktijdige requests afvuurt, zoals autocomplete plus chat, kan de concurrency limit bereiken. De error code is concurrency voor te veel tegelijk en rate_limited voor per-minute limits. Een Retry-After: 5 header betekent tijdelijke overload.

Streaming stagneert

Sommige corporate proxies bufferen server-sent events. Test vanuit een ander netwerk of schakel streaming uit in de extensie.

Antwoorden verschillen van wat je bij een andere assistant zag

Dat is verwacht. Dit is een ander model met eigen sterktes. Geef duidelijke, specifieke instructies en test het op code uit je eigen project.

Meer handleidingen

• Codex API in Python: een Coding LLM aanroepen
• Codex API Base URL: Hoe je client bij de onze te koppelen