Gabay sa Claude Code Third-Party API: ANTHROPIC_BASE_URL Setup at Troubleshooting

Sa default, ipinapadala ng Claude Code ang lahat ng request sa opisyal na API ng Anthropic. Kapag hindi stable ang opisyal na ruta mula sa iyong network, o gusto mong isang lugar lang ang pamamahala ng keys, billing, at pagpalit ng modelo, ang pagtutok ng Claude Code sa Anthropic-compatible na third-party endpoint ang pinakadirektang solusyon. Saklaw ng gabay na ito ang eksaktong pagbabago, kung paano i-verify, at saan titingnan kapag may problema.

Unawain muna: ang Claude Code ay isang "client"

Kahulugan: Nagbabasa ang Claude Code ng maliit na set ng environment variables para malaman kung saan pupunta ang requests, anong key ang gagamitin, at anong modelo ang tatakbo. Basta nai-implement ng target endpoint ang request/response format ng Anthropic Messages API, gumagana ang Claude Code dito na parang opisyal na API — ang tool calling, streaming, at multi-turn sessions ay nakadepende sa compatibility ng endpoint.

Dokumentadong kakayahan ang base URL override, hindi ito hack. May Anthropic-compatible endpoint ang EXAIV; tingnan ang opisyal na setup page para sa maikling bersyon.

Mga environment variable na mahalaga

Paraan 1: settings.json (inirerekomenda, permanente)

Nagbabasa ang Claude Code ng environment variables mula sa ~/.claude/settings.json. Bumubukas ito sa bawat session at pinakamadaling i-standardize sa buong team. Halimbawa para sa EXAIV:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://exaiv.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "YOUR_EXAIV_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "model": "claude-opus-5-5"
}

I-restart ang claude pagkatapos i-save. Para saklaw lang ng isang proyekto, ilagay ang parehong structure sa .claude/settings.json sa project root.

Paraan 2: pansamantalang environment variables (mabilisang test)

Walang a change sa file — i-export sa kasalukuyang shell:

export ANTHROPIC_BASE_URL="https://exaiv.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="YOUR_EXAIV_API_KEY"

# Pinakamaliit na pag-verify
claude --print "say hi"

Kung may sagot, buhay na ang endpoint. Para permanente, pwedeng ilagay ang dalawang export sa ~/.zshrc o ~/.bashrc — pero apektado lahat ng claude command. Kung may opisyal ka ring subscription, mas mainam ang project-level settings.json para hindi mapasanit ang third-party credits.

Saan makikita ang mga available na modelo

Ang endpoint ang nagtatakda kung anong mga modelo ang umaEsista. Ang buong catalog ng EXAIV (Claude, GPT, Gemini, DeepSeek, Kimi at iba pa) ay nasa models page; palitan ang modelo sa Claude Code via ANTHROPIC_MODEL o ang /model command sa session.

Troubleshooting: sundan ang nakatakdang pagkakasunod

Sino ang nakikinabang sa third-party setup

Hindi lahat ng gumagamit ng Claude Code kailangan nito. Tatlong senaryo ang pinakamalinaw ang kapakinabangan:

Mga may hindi stable na opisyal na ruta. Sa ilang rehiyon, madalas mag-timeout ang opisyal na endpoint — ang paghinto sa gitna ng coding session ay tunay na pumatay sa produktividad. Sa pamamagitan ng mas malapit na compatible gateway, mas maikli ang ruta at halatang gumaganda ang pagpapatuloy ng session.

Mga mabibigat na gumagamit. Kumakain ng napakaraming token ang Claude Code kumpara sa ordinaryong chat — bawat tool call at pagbasa ng file ay pumapasok sa context. Kung araw-araw mong gamit, ang pay-as-you-go na mas mababang presyo kada unit ay maaaring magdulot ng makabuluhang buwanang pagkakaiba. I-estimate ang pagitan gamit ang tunay mong konsumo, hindi ang marketing numbers ng kahit sinong panig.

Mga team na naghahanap ng iisang pintuan. Kapag sabay-sabay gumagamit ang team ng Claude Code, Cursor, at sariling scripts, mas madaling kontrolin ang budget kung lahat ng tool ay nakaturo sa iisang gateway na iisang key at iisang bill. May OpenAI-compatible at Anthropic-compatible na endpoints ang EXAIV — isang key, dalawang protocol.

Paano ang presyo: magsimula sa trial pack

Nisingil ang EXAIV sa credits na bayad kada gamit: bumili ka ng credit pack nang isang beses, ang bawat tawag ay bumabawas ayon sa presyo ng modelo, walang subscription fee. Pinakamababang tier ang pinakamaliit na pack na nakalista sa pricing page — sapat para sa totoong validation loop:

1. Mag-register at gumawa ng API key sa console
2. I-configure ang Claude Code gaya ng nasa itaas
3. Patakbuhin ang iyong pang-araw-araw na gawain nang isang-dalawang oras at panoorin ang balance curve sa console
4. I-extrapolate sa buwanang estimate, bago magdesisyang umakyat ng tier

May kanya-kanyang presyo ang bawat modelo, kaya ang eksaktong numero ay nasa pricing page nang real-time — kaya't hindi kailanman naglalagay ang artikulong ito ng nakatakdang per-call na numero: sumusunod ang presyo sa opisyal na pagbabago, at ang real-time page ang laging pinakatumpak.

Team adoption: iisang config, walang drift

Ang pinakamalaking trapik sa team ay magkakaiba ang config ng bawat isa. Ang gumagana:

Isama ang settings template sa repo. Mag-iwan ng keyless na example file sa project root; ang bagong miyembro, kokopyahin at lagyan ng sariling key. Limang minuto, tapos.

Kada tao ang key, huwag bahagi. Sariling API key ang bawat miyembro, nakikita ang usage sa console. Madaling matunton ang problema, at ang pag-alis ng miyembro ay pag-revoke lang ng isang key.

Hiwalin ang konteksto gamit ang wrapper script. Kung may opisyal na subscription ang miyembro, maliit na alias script na nakaturo sa project-level config ang pipigil sa pagsasama ng dalawang quota.

Mga batayang security

Ang API key ay wallet credential. Apat na batas:

• Hindi kailanman papasok ang key sa git. Ang config file na may tunay na key ay nasa labas ng version control; template lang ang nasa repo
• Regular na rotation. Pana-panahong gumawa ng bagong key sa console at i-revoke ang luma; kung pinaghihinalaang naka-leak, palitan agad
• Least privilege. Huwag i-paste ang key sa CI logs, frontend code, o chat
• Bantayan ang anomalya. Kapag kakaiba ang bilis ng pagkasunog ng balance, i-revoke muna ang key bago mag-imbestiga

Setup quick reference kada OS

Ang lahat ng iba — model mapping, troubleshooting order, security practices — pareho sa lahat ng platform.

Bakit mas mahalaga ang tier mapping kaysa inaakala

Hindi lang ang piniling pangunahing modelo ang tinatawag ng Claude Code. Sa background, maraming maliliit na request ang pinapaputok nito — pagbubuod ng tool output, paggawa ng commit messages, mabilisang lookup — at ang mga request na iyon ay naka-tag na Sonnet-tier o Haiku-tier. Kapag walang eksaktong default na modelo para sa mga tier na iyon ang endpoint mo, bibigo o magfe-fallback nang hindi inaasahan ang mga tawag.

Iyan ang tinutugunan ng ANTHROPIC_DEFAULT_SONNET_MODEL at ANTHROPIC_DEFAULT_HAIKU_MODEL: inire-route nila ang mga tier-tagged request sa modelong talagang meron ang endpoint. Ang pinakasimple at pinakamatatag na pattern: itakda ang pareho sa pangunahing mong modelo. Ang pagmamapa ng Haiku-tier sa mas murang modelo ay karaniwang optimization kapag stable na ang lahat. Parehong lohika sa gateway: tingnan ang models page kung ano ang umaEsista, tapos i-map ang tiers sa mga modelong sigurado kang nandoon.

Timeout at network tuning

Dalawang variable ang gumagawa ng solusyon sa karamihan ng connectivity complaints:

• API_TIMEOUT_MS — ang kumplikadong agent turns ay makatuwirang maaaring tumagal ng minuto; ang masyadong maikling client timeout ay pumapatay sa mga request na sana ay nagtagumpay. Kapag napuputol ang mga turn nang walang error output, itaas ito.
• Proxy overlap — kung nakatakda rin ang HTTP_PROXY/HTTPS_PROXY sa shell mo, maaaring dumadaan muna ang requests sa lokal na proxy bago marating ang gateway. Kapag tama ang base URL pero bigo pa rin ang koneksyon, subukan muna nang hindi nakatakda ang proxy variables bago magpalit ng iba.

Walang required sa dalawa by default — sila ang unang dalawang kandado na iikin kapag tama ang setup pero mali ang network path.

FAQ

Kaugnay na babasahin

• Claude Code setup page — ang mabilisang bersyon sa site
• Anthropic Messages API reference — request/response format
• Presyo — real-time na presyo ng mga modelo