Claude Code Custom API Endpont: Harmonizálás egy harmadik fél kláude-kód API-célpontjával kínai nyílt forráskódos modellekkel

A Claude Code-t lehet konfigurálni úgy, hogy egy Anthropic-kompatibilis célpontra kommunikáljon, nem közvetlenül a szolgáltató célpontján keresztül. Ez lehetővé teszi a gateway által kezelés alatt álló munkálék tesztelését, valamint a modell ID-k megfigyelését, amelyek a gateway által kínált kínai nyílt forráskódos modellek közül jelennek meg ECAIX aktuális modellkatalógusában.

Ez a útmutató egy szolgáltatóspecifikus, harmadik fél kompatibilitás munkálékról szól. Az Anthropic hivatalos Claude Code gateway dokumentációja szerint az Anthropic nem támogatja a Claude Code-t olyan non-Claude modellek irányítására, amelyek egy gatewayen keresztül futnak. Az ECAIX nem állítja elő, hogy ez az útmutató hivatalosan támogatott az Anthropic részéről, és egy non-Claude modell nem biztosítja minden Claude Code képességet.

Rövid kezdés

Ha már érted a kompatibilitási határt, kezdj el a rövid úton:

1. Nyíld meg az aktuális ECAIX modellkatalógus és válasd ki egy aktív modell ID-t.
2. Hozd létre egy ECAIX API kulcsot és tárold el a forráskontrollból távol.
3. Válassz ki egy ANTHROPIC_BASE_URL értéket: https://ecaix.com/api/ai/v1/anthropic.
4. Eljátszd a diagnosztikus kérést és regisztrálj HTTP statuszát.
5. Teszteld a kláude-kódban olvasómodális, csak olvasó teszt projektban: claude -p.
6. Teszteld külön a eszközök, futásmodusokat, kontextus korlátozásokokat és engedélyeket.

Publikációs ellenőrzési állapot

Ez a táblázat szándékosan van: egy konfigurációs példa nem azonosítható egy mért kompatibilitási eredményként.

Milyen változásokat hoz ez meg

A konfiguráció négy különálló részből áll:

1. Claude Code az a klient, amely kodolási feladatok létrehozását és kéréseket küld.
2. Az Anthropic-kompatibilis gateway egy Anthropic-stílusú célponton kapja a kéréseket.
3. A modell ID kiválasztja a gateway által kínált upstream modellt.
4. Az API kulcs az azonosítást és engedélyezést biztosítja, valamint a számlázást és engedélyeket határozza meg.

A célpont változtatása nem változtatja meg a non-Claude modellt Claude-nek. Csak megváltoztatja, hogy melyik kompatibilis API felület kapja a kéréseket. Az eszköz használat, kontextus kezelés, modell aliasok, futásmodusok és engedélyek folyama lehetőlegesen változhatnak a klient verzió és gateway implementáció szerint.

Előzetes feltételek

Necsenek:

• Egy Claude Code telepítés, amely támogatja az környezeti vagy beállítások alapú célpont konfigurációt.
• Egy ECAIX API kulcs.
• Egy modell ID, amely jelenleg jelen van az ECAIX modellkatalógusban.
• Egy terminal, ahol egy kis tesztkérést tudsz eljátszani, és nem kell a kulcsot forráskontrollba behelyezni.

A katalógus változik. A modell ID-t előbb megvizsgáljadd a ECAIX modellkatalógusban és ellenőrizd, hogy aktív és elérhető-e a használatodra a célpont stílusod szerint.

Konfigurálj a gateway célpontot

A Claude Code számos telepítésben a ~/.claude/settings.json fájlban tárolja beállításait. Az adott beállítások szkeletja változhat, ezért kezelj úgy, mint egy kezdeti példát és összehasonlítsd a telepített verzió dokumentációjával.

{
  "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"
}

Ne helyezd be a fájlba egy valós API kulcsot, ha a fájl nyilvános repoban van. Javasolj egy helyi környezeti változó, vagy a segédkezelőket, amelyek a telepített Claude Code által javasoltak.

A célpont konfigurálható is egy tesztolási célpontban:

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"

Az egyes Claude Code verziók által támogatott változónevek és beállítások változhatnak. Ha a klient ignorálja az ANTHROPIC_MODEL beállítást, használj a modell mezőt vagy a modell alias mechanizmust, amelyet a verzió dokumentációja ír le. A gateway mégis meg kell ismernie a végső modell ID-t.

Ellenőrizd az Anthropic-kompatibilis célpontot először

Mielőtt kezdj egy interaktív kodolási munkálékra, küldj egy kis kérést. Ez elválasztja a célpont, azonosítást és modell ID problémákat a kláude-kód specifikus viselkedéstől.

Az alábbi parancs a fejezetek felett és a válasz testében külön tárolja el a fejezet feletti és a válasz testét, majd kiírja az HTTP statuszot. Egy valós engedélyezett kulcs használatával csak a helyi shellben használj, és ne add be a kulcsot egy közösségi logba, vagy egy közösségi problémába, vagy egy közösségi shell történetbe.

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."}
    ]
  }'

Az előrejelzés:

• 200: vizsgáljad a válasz alakját és ellenőrizd, hogy visszaadja-e a modell vagy használati adatok mezőket.
• 401 vagy 403: ellenőrizd a kulcsot, fejléceket, számlát és engedélyezett tartományt, mielőtt változtatnád a kérdést.
• 404: ellenőrizd a alap URL-t, a /messages végpontokat és a célpont telepítését.
• 400: csökkentsd a kérést a legkisebb érvényes testhez és ellenőrizd a modell-specifikus mezőket.
• 5xx vagy időtartam-hiba: regisztráljadd a kérést és a válasz testet, majd elválasztasd a gateway, az upstream és a klient időtartam-hibáit.

Egy sikeres válasz megerősíti, hogy a kulcs, célpont, kérés alakja és modell ID együttműködtek az adott kérésre. Nem bizonyítja, hogy minden Claude Code funkció működik.

Modell ID kiválasztása

Az ECAIX katalógusában kínai szolgáltatók modelljai vannak. A feladatnak megfelelő kezdő modell a feladat és a modell neve mellett.

Kodolás és általános fejlesztés

Kezdj egy jelenlegi DeepSeek, Qwen, GLM vagy Seed kodolóképes modellből, amely jelen van a katalógusban. Például a katalógus lehetővé teszi az deepseek-v4.1-flash, qwen3.8-flash, glm-5.3 vagy seed-2.0-code modell ID-k használatát. A rendelkezésre állás és képességek változhatnak, ezért mindig ellenőrizd a jelenlegi modell oldalt, mielőtt kiadnád egy konfigurációt.

Hosszú kontextus és repository munkálatok

Nagy repositoryk vagy hosszú technikai dokumentumok esetén ellenőrizd a kontextus hosszt, amelyet a modell mutat. Egy nagyobb kontextus ablak nem automatikusan jelentősebb repository eredményekre: a kérdés struktúrája, eszköz támogatása, kiadás korlátozások és a gateway kérés korlátozásai is fontosak.

Eszközhívások és agent munkálatok

Ha a munkálék funkcióhívásokat vagy eszközöket igényel, ellenőrizd a modell és célpont dokumentációját. Some szolgáltatók OpenAI-kompatibilis API-kon keresztül teszik elérhetővé az eszközhívásokat, míg mások más mezőneveket vagy csak egy részletet támogatnak az eszköz viselkedésének. Kezdj egy kis eszközhívási tesztelést, mielőtt adnád a modellnek egy valós repository vagy külső rendszer hozzáférést.

Kínai nyelvű fejlesztés

Kínai nyílt forráskódos modellek hasznosak, ha a kódbázis, dokumentáció, problémamegoldó rendszer vagy csapatmunka kínai nyelvű anyagokat tartalmaz. A modellt saját kérdésekkel és repository mintákkal értékeld, nem csak általános rangsorolások alapján.

Teszteld a Claude Code-t, ha az API kérés sikeres

Ha a közvetlen kérés sikeres, kezdj egy olvasómodális vagy alacsony kockázatú parancsjal:

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

Például:

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

Teszteld egyre nagyobb kockázatú feladatokat:

1. Szövegválasz
2. Rövid kód magyarázat
3. Repository navigáció
4. Egy kontrollált módosítás egy kiszolgálható ágban
5. Eszköz használat vagy több lépésű feladat
6. Futasmodus és hosszú kontextus viselkedés

Ne várj, hogy egy sikeres szövegválasz bizonyítsa, hogy engedélykérő kérdések, eszközhívások, futásmodusok, kontextus korlátozások és fájl módosítás viselkedése azonos a Claude-kódos munkálékkal.

Az megfelelő API útvonal kiválasztása

A Claude Code csak egy klient munkafolyama. Az megfelelő API útvonal a klient és a funkciók szempontjából: