Nastavení vlastního API koncetru pro Claude Code s otevřeným zdrojovým kódem z Číny

Claude Code může být nakonfigurován tak, aby se spojoval s kompatibilním koncetrem třetí strany namísto přímého použití koncetru poskytovatele. To umožňuje testování workflowu řízeného klientem s modelovými identifikátory, které klient poskytuje, včetně čínských otevřených modelů dostupných v aktuálním katalogu modelů ECAIX.

Tato příručka se zabývá příslušným workflowem pro kompatibilitu s poskytovatelem, který vysvětluje, že oficiální dokumentace Anthropic pro klient Claude Code klade důraz na to, že Anthropic neposkytuje podporu pro routování Claude Code k modelům třetí strany prostřednictvím klienta. ECAIX nehovoří o oficiální podpoře Anthropic a model ne-Claude nemusí poskytovat všechny funkce Claude Code.

Rychlé nastavení

Pokud již porozumíte hranici kompatibility, použijte tento krátký postup:

1. Otevřete aktuální katalog modelů ECAIX a vyberte aktivní identifikátor modelu.
2. Vytvořte klíč API ECAIX a uchovejte ho mimo kontrolu zdrojového kódu.
3. Nastavte ANTHROPIC_BASE_URL na https://ecaix.com/api/ai/v1/anthropic.
4. Posílejte diagnostickou žádost níže a zaznamenávejte HTTP status.
5. Spusťte Claude Code v čistém testovacím projektu s claude -p.
6. Testujte nástroje, streaming, limity kontextu a povolení odděleně.

Status ověření při publikaci

Tato tabulka je záměrná: příklad konfigurace není stejný jako změřená výsledná kompatibilita.

Co se změní v nastavení

Konfigurace má čtyři oddělené části:

1. Claude Code je klient, který vytváří úlohy kódu a posílá žádosti.
2. Kompatibilní klient Anthropic přijímá žádosti na Anthropic-style koncetru.
3. Identifikátor modelu vybere upstream model, který klient poskytuje.
4. API klíč ověřuje žádost a určuje účet, kvóty a povolení.

Změna koncetru nezmění model ne-Claude na Claude. Pouze mění, který kompatibilní API povrch přijímá žádost. Použití nástrojů, zpracování kontextu, aliasů modelů, chování streamingu a toků povolení se může lišit podle verze klienta a implementace klienta.

Před zahájením

Potřebujete:

• Instalaci Claude Code, která podporuje konfiguraci prostředí nebo nastavení založenou na koncetru.
• Klíč API ECAIX.
• Identifikátor modelu, který je aktuálně v katalogu modelů ECAIX.
• Termínál, kde můžete spustit malou testovací žádost bez umístění API klíče do zdrojového kódu.

Katalog se mění. Před kopírováním identifikátoru modelu do souboru konfigurace otevřete katalog modelů ECAIX a potvrďte, že model je aktivní a dostupný pro styl API, který plánujete použít.

Konfigurace klienta Anthropic

Claude Code ukládá nastavení do souboru ~/.claude/settings.json na mnoha instalacích. Přesný schéma nastavení může změnit, takže zacházejte s následujícím jako základním vzorem a porovnejte ho s dokumentací vaší instalované verze.

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

Nezařazujte tento soubor do veřejného repozitáře, pokud obsahuje skutečný API klíč. Preferujte lokální environmentální proměnnou, systém pro správu tajemství nebo mechanismus doporučený vaší instalací Claude Code.

Můžete také nastavit koncetr v shellové seanci při testování:

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"

Název proměnných a nastavení podporovaných v určité verzi Claude Code mohou změnit. Pokud klient ignoruje ANTHROPIC_MODEL, použijte pole modelu nebo mechanismus aliasů modelů, který je v dokumentaci vaší verze popsán. Klient stále potřebuje rozpoznat konečný identifikátor modelu.

Zkontrolujte kompatibilní koncetr Anthropic

Před zahájením interaktivního pracovního procesu posílejte malou žádost. Tím oddělíte problémy s koncetrem, ověřením a identifikátorem modelu od chování specifického pro Claude Code.

Příkaz níže uloží hlavičky odpovědi a tělo odpovědi odděleně a poté vytiskne HTTP status. Používejte skutečný autorizovaný klíč pouze v lokálním shellu; nikdy nekopírujte do článku, příspěvku nebo sdíleného záznamu.

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

Očekávaná interpretace:

• 200: prohlédněte si tvar odpovědi a potvrďte vrácené pole modelu nebo spotřeby.
• 401 nebo 403: zkontrolujte klíč, hlavičku, účet a rozsah povolení před změnou dotazu.
• 404: zkontrolujte základní URL, příponu /messages a deploy koncetru.
• 400: zmenšte žádost na nejmenší platný tvar a zkontrolujte model-specifická pole.
• 5xx nebo timeout: zaznameněte čas žádosti a tělo odpovědi, poté oddělte chyby klienta, timeout klienta a chyby poskytovatele.

Úspěšná odpověď potvrzuje, že klíč, koncetr, tvar žádosti a identifikátor modelu fungovaly společně pro tuto žádost. To však neprokázá, že každá funkce Claude Code bude fungovat.

Výběr identifikátoru modelu

Katalog ECAIX obsahuje rodiny modelů od čínských poskytovatelů. Vhodný začáteční model závisí na úloze, nejen na názvu modelu.

Kódování a obecné vývojové práce

Začněte s aktuálním modelem DeepSeek, Qwen, GLM nebo Seed, který je schopný kódování a je viditelný v katalogu. Například katalog může expozovat identifikátory jako deepseek-v4.1-flash, qwen3.8-flash, glm-5.3 nebo seed-2.0-code. Dostupnost a schopnosti se mohou měnit, takže vždy zkontrolujte aktuální stránku modelu před publikováním konfigurace.

Dlouhý kontext a práce s repozitáři

Pro velké repozitáře nebo dlouhé technické dokumenty porovnejte délku kontextu, která je uvedena v katalogu modelů. Větší okno kontextu neautomaticky znamená lepší výsledky s repozitáři: struktura dotazu, podpora nástrojů, limity výstupu a limity požadavků klienta také hrají roli.

Volání nástrojů a agentových workflowů

Pokud workflow potřebuje volání funkcí nebo nástrojů, zkontrolujte dokumentaci modelu a koncetru. Některé poskytovatele exponují volání nástrojů prostřednictvím API kompatibilního s OpenAI, zatímco jiní exponují různé názvy polí nebo podporují pouze část chování nástrojů. Začněte s malým testem volání nástrojů před tím, než model dostane přístup k reálnému repozitáři nebo externímu systému.

Vývojové práce s čínštinou

Otevřené čínské modely mohou být užitečné, když je kódová báze, dokumentace, trackery problémů nebo workflow týmu obsahuje čínské materiály. Vyhodnoťte model s vaší vlastními dotazy a vzorky repozitářů, nikoli pouze na základě obecných hodnocení.

Testování Claude Code po úspěšném API požadavku

Jakmile se přímá žádost úspěšně podaří, začněte s čistým nebo nízkorizikovým příkazem:

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

Poté testujte úzkou úlohu. Například:

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

Používejte postupně náročnější testy:

1. Odpověď v textu.
2. Krátké vysvětlení kódu.
3. Navigace repozitářů.
4. Kontrolovaná úprava v dočasném větvení.
5. Použití nástrojů nebo víceúrovňové úlohy.
6. Chování streamingu a dlouhého kontextu.

Ne předpokládejte, že úspěšná textová odpověď znamená, že povolení dotazů, volání nástrojů, chování streamingu, limity kontextu nebo úprava souborů chodí identicky jako u sezení Claude.

Vhodný API cesta

Claude Code je pouze jeden workflow klienta. Vhodná cesta API závisí na klientu a funkcích, které potřebujete:

Pro ECAIX používejte Dokumentaci Anthropic Messages pro cesty v stylu Anthropic a Dokumentaci Chat Completions pro klienty kompatibilní s OpenAI. Používejte katalog modelů k potvrzení aktuálního modelu a stránku cen k aktuálnímu zobrazenému cenovému plánu.

Matice kompatibilit

Nás