Pagsasalin ng Custom API Endpoint ng Claude Code sa Gateway ng Third-Party na May Model ng Open-Source sa Tsino

Ang Claude Code ay maaaring mag-setup ng isang endpoint na kompatibo sa Anthropic sa lugar ng direktang paggamit ng endpoint ng provider. Ito ay nagbibigay-daan sa pagtest ng isang workflow na may mga model ID na ibinibigay ng gateway, kabilang ang mga model ng open-source sa Tsino na mayroong mga bagong model na nasa katalog ng ECAIX.

Ang guidelin na ito ay tungkol sa isang pagsasaling-pamamagitan ng provider-specific, workflow ng kompatibilidad ng third-party. Ang dokumentasyon ng official na gateway ng Claude Code ng Anthropic ay nagpapahayag na hindi pinapayagan ng Anthropic ang pagroute ng Claude Code sa mga non-Claude model sa pamamagitan ng isang gateway. Ang ECAIX hindi nagpapaalam na ang workflow na ito ay may pagpapalabas ng support ng Anthropic, at isang non-Claude model ay maaaring hindi makapagbigay ng lahat ng mga capability ng Claude Code.

Mga Bagong Simula

Bago magsimula, kung nais mong malaman ang mga batayan ng kompatibilidad, gamitin ang mga sumusunod na hakbang:

1. Panoorin ang presenteng katalog ng mga model ng ECAIX at pilin ang isang aktibong model ID.
2. Isulat ang isang API key ng ECAIX at ipagpatuloy ito sa buong kontrol ng source code.
3. Iset ang ANTHROPIC_BASE_URL sa https://ecaix.com/api/ai/v1/anthropic.
4. Isagawa ang sumusunod na request ng diagnostic at ipagpatuloy ang HTTP status.
5. Isagawa ang Claude Code sa isang project na may mga limitasyon sa pagbabasa lamang sa claude -p.
6. Test ang mga tool, streaming, mga batayan ng kontekto, at mga permision sa mga isseparado.

Mga Status ng Pagverify sa Pagsasulat

Ang mga table na ito ay mayroong mga intentong makapagpahiwatig: isang example ng pag-setup ay hindi magkakaiba sa mga resulta ng kompatibilidad na may measurement.

Ang mga Bagong Pagbabago sa Pag-setup

Ang pag-setup ay mayroong apat na mga bahagi na mayroong mga bagong pagkakahalintulad:

1. Claude Code ay ang klient na nagbibigay ng mga task ng coding at nagpapadala ng mga request.
2. Ang gateway na kompatibo sa Anthropic ay nag-aalok ng mga request sa isang endpoint na may estilo ng Anthropic.
3. Ang model ID ay nagse-selektahan ng mga upstream model na ibinibigay ng gateway.
4. Ang API key ay nag-aauthenticate ng mga request at nagbibigay ng mga account, quota, at mga permision.

Ang pagbabago ng endpoint ay hindi nagpapalit ng isang non-Claude model sa Claude. Ito lamang nagbabago sa mga kompatibong mga surface ng API na nag-aalok ng mga request.

BeFORE magsimula

Kailangan mo ang mga sumusunod:

• Ang isang installation ng Claude Code na may suporta sa pag-setup ng endpoint sa pamamagitan ng mga environment o mga setting.
• Ang isang API key ng ECAIX.
• Ang isang model ID na mayroong kasalukuyang aktibong pagkakalista sa katalog ng mga model ng ECAIX.
• Ang isang terminal na may mga kapansin-pansin na makapagtest ng isang maliit na request na hindi magpapalabas ng API key sa source code.

Ang katalog ay nagbabago sa panahon. Bago kopya ang isang model ID sa isang file ng pag-setup, panoorin ang direktoriyong mga model ng ECAIX at mag-confirma na ang model ay aktibong mayroon at mayroon ang mga API style na ginagamit mo.

Pag-setup ng Gateway Endpoint

Ang Claude Code ay nagbibigay ng mga setting sa ~/.claude/settings.json sa maraming mga installation. Ang mga schema ng mga setting ay maaaring magbabago, kaya tiyakin ang mga sumusunod na mga pattern at mag-compare sa dokumentasyon ng iyong sariling version.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ecaix.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "YOUR_ECAIX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT": "1"
  },
  "model": "deepseek-v4.1-flash"
}

Hindi kailangan mong ipapalabas ang file na ito sa isang public na repository kung mayroon itong isang real na API key. Mas mahusay na gamitin ang isang environment variable, isang secrets manager, o ang mekanismo ng credential na kinakapusahan ng iyong installation ng Claude Code.

Maari ring mag-setup ang endpoint sa isang shell session sa pagtest:

export ANTHROPIC_BASE_URL="https://ecaix.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="YOUR_ECAIX_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash"

Ang mga pangalan ng variable at mga setting na may suporta sa isang partikular na release ng Claude Code ay maaaring magbabago. Baka hindi mo makakapag-apply ang ANTHROPIC_MODEL kung ang klient ay hindi nagtutugon. Gamitin ang field ng model o ang mekanismo ng alias ng model na kinakapusahan ng iyong version. Ang gateway ay pa rin kailangan ng pagkakapagkaloob ng final na model ID.

Magverify ang Anthropic-compatible endpoint

Bago magsimula ng isang interaktibong coding session, isagawa ang isang maliit na request. Ito ay nagpapahayag ng mga problema sa endpoint, authentication, at model-ID sa mga bagay na hindi kabilang sa mga bagay ng Claude Code.

Ang sumusunod na command ay nagpapalabas ng mga headers ng response at ang body ng response sa mga separated na file, at nagpapalabas ng HTTP status. Gamitin ang isang real na authorized key lamang sa iyong lokal na shell; hindi kailangan mong ipapalabas ito sa isang artikulo, issue, o shared log.

curl -sS -D /tmp/ecaix-anthropic-headers.txt \
  -o /tmp/ecaix-anthropic-response.json \
  -w '\nHTTP %{http_code}\n' \
  "${ANTHROPIC_BASE_URL}/messages" \
  -H "x-api-key: ${ANTHROPIC_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 128,
    "messages": [
      {"role": "user", "content": "Reply with one short sentence."}
    ]
  }'

Ang mga interpretasyon na mayroon:

• 200: Panoorin ang shape ng response at mag-confirma na ang ibinibigay na model o mga field ng usage.
• 401 o 403: Mag-check sa key, header, account, at mga batayan ng permision bago magbabago ang prompt.
• 404: Mag-check sa base URL, suffix ng /messages, at deployment ng endpoint.
• 400: Mag-reduce ang request sa pinakamaliit na valid na body at mag-check sa mga field na mayroon ang mga model.
• 5xx o timeout: Mag-record ang mga panahon ng request at response body, at mag-separate ang mga timeout ng gateway, upstream, at klient.

Ang isang matagumpay na response ay nagpapahiwatig na ang key, endpoint, format ng request, at model ID ay gumagana sa isang request. Hindi ito nagpapahiwatig na lahat ng mga feature ng Claude Code ay gumagana.

Pagpilihan ng Model ID

Ang katalog ng ECAIX ay may mga family ng mga model mula sa mga provider sa Tsino. Ang pinakamahusay na model na maging start ay depende sa task, hindi lamang sa pangalan ng model.

Coding at mga pagtatangka sa pagbuo ng mga bagong development

Pilihan ang isang kasalukuyang DeepSeek, Qwen, GLM, o Seed na model na may capability sa coding at mayroon ang mga ID na mayroon sa katalog. Halimbawa, ang katalog ay maaaring ibigay ang mga ID tulad ng deepseek-v4.1-flash, qwen3.8-flash, glm-5.3, o seed-2.0-code. Ang availability at mga capability ay maaaring magbabago, kaya mag-confirma ang kasalukuyang model page bago magpublika ng isang configuration.

Long context at mga pagtatangka sa repository

Para sa mga malaking repository o mga dokumentong teknikal na may mga panahon ng kontekto, mag-compare ang mga batayan ng kontekto na ibinibigay sa mga model directory. Ang isang mas malaking batayan ng kontekto ay hindi automatically ang mas magandang mga resulta sa repository: ang mga structure ng prompt, mga support sa tool, mga limitasyon ng output, at mga limitasyon ng request ng gateway ay pati na rin naglalaman.

Tool calling at mga workflow ng agent

Bago maging isang workflow na may mga function call o mga tool, mag-check sa mga dokumentasyon ng model at endpoint. Mga provider ay maaaring ibigay ang mga support sa tool calling sa pamamagitan ng mga API na kompatibo sa OpenAI, habang iba ay maaaring ibigay ang mga field na mayroon ang mga iba't ibang mga pagkakahalintulad o lamang suporta sa isang subset ng mga behavior ng tool. Pilihan ang isang maliit na test sa mga tool call bago magbigay ng access sa isang real na repository o isang sistema na mayroon ang mga external na system.

Pagtatangka sa mga development na may mga materyal sa Tsino

Ang mga model ng open-source sa Tsino ay maaaring maging kapaki-pakinabang kung ang iyong repository, dokumentasyon, track ng mga issue, o workflow ng team ay mayroon ang mga materyal na mayroon sa Tsino. Mag-evaluate ang model sa iyong sariling mga prompt at mga sample ng repository sa halip na lamang mag-relyo sa mga ranking.

Test ang Claude Code pagkatapos na matagumpay ang API request

Bago ang isang direct na request ay matagumpay, simulan sa isang command na may mga limitasyon sa pagbabasa o low-risk:

claude -p "Explain what this repository does without editing files."

Pagkatapos, testin ang isang malayong task. Halimbawa:

claude -p "List the likely entry points for the web application. Do not modify files."

Gamitin ang mga test na may mas mataas na mga demand:

1. Mga response sa text na plain.
2. Mga pag-explain sa code na short.
3. Mga navigation sa repository.
4. Ang isang controlled na edit sa isang disposable na branch.
5. Mga tool use o mga multi-step task.
6. Mga behavior ng streaming at long context.

Hindi kailangan mong mag-assert na ang isang matagumpay na response sa text ay nagpapahiwatig na ang mga permision ng prompt, tool calls, streaming, mga batayan ng kontekto, at pag-edit ng file ay magkakaibang mga kompatibilidad sa isang session ng Claude-backed.

Ang Mga Pinakamahusay na API Path

Ang Claude Code ay lamang isang workflow ng klient. Ang pinakamahusay na API path ay depende sa iyong klient at mga feature set na ginagamit mo:

Para sa ECAIX, gamitin ang [Anthropic Messages documentation](/docs/api/anthropic-m