← Cloudflare AI Gateway / ai-gateway / integrations / coding-agents

GitHub Copilot CLI

GitHub Copilot CLI ↗ podporuje poskytovatele modelů typu bring-your-own-key (BYOK) konfigurované pomocí proměnných prostředí. Směrujte je přes AI Gateway REST API, kompatibilní s OpenAI /chat/completions koncový bod ověřený pomocí tokenu Cloudflare API. Modely třetích stran jsou účtovány prostřednictvím Unified Billing, takže ve vašem prostředí nejsou potřeba žádné API klíče poskytovatele. Případně si můžete vlastní API klíče poskytovatele uložit v AI Gateway pomocí BYOK (ukládání klíčů) a k autentizaci použijte stejný Cloudflare API token. AI Gateway při každém požadavku načte uložený klíč.

Na rozdíl od Claude Code, GitHub Copilot CLI ověří poskytovatele modelu pomocí jediného Authorization hlavičku a nemůže odesílat vlastní hlavičky požadavků. Proto tato konfigurace používá REST API: přijímá token Cloudflare API ve standardní Authorization hlavičku namísto tokenu brány a cf-aig-authorization tok hlaviček používaný pro Claude Code. Protože Copilot CLI nemůže nastavit cf-aig-gateway-id hlavičku, požadavky se směrují přes výchozí bránu vašeho účtu výchozí gateway.

Předpoklady

Než začnete, budete potřebovat:

Nainstalovaný GitHub Copilot CLI. Pokyny k instalaci najdete v Instalace GitHub Copilot CLI ↗.
A Token Cloudflare API hodnotou AI Gateway oprávnění.
Načtené kredity ve vašem účtu pro modely třetích stran.
Model, který podporuje volání nástrojů (tool calling) a streamování. Pro nejlepší výsledky použijte model s kontextovým oknem alespoň 128k tokenů.

Nastavte proměnné prostředí poskytovatele. GitHub Copilot CLI je při spuštění načte a připojí /chat/completions na základní URL. Tyto příkazy nastaví uvedené proměnné pro aktuální relaci. Chcete-li je zachovat trvale, přidejte je do profilu shellu (například ~/.zshrc nebo ~/.bashrc).

Nahraďte <ACCOUNT_ID> s ID vašeho účtu Cloudflare a <CF_API_TOKEN> svým Cloudflare API tokenem. Nastavte COPILOT_MODEL na libovolný podporovaný model v provider/model formát.
export COPILOT_PROVIDER_TYPE="openai" export COPILOT_PROVIDER_BASE_URL="https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai/v1" export COPILOT_PROVIDER_API_KEY="<CF_API_TOKEN>" export COPILOT_MODEL="openai/gpt-4.1"
$env:COPILOT_PROVIDER_TYPE = "openai" $env:COPILOT_PROVIDER_BASE_URL = "https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai/v1" $env:COPILOT_PROVIDER_API_KEY = "<CF_API_TOKEN>" $env:COPILOT_MODEL = "openai/gpt-4.1"
Spusťte GitHub Copilot CLI a odešlete prompt. Požadavky nyní směřují přes AI Gateway.
```
copilot
```

Poznámka

GitHub Copilot CLI si udržuje vestavěný katalog známých modelů a jejich limitů tokenů. Pokud vybraný model není v katalogu, Copilot CLI vypíše varování a použije výchozí limity tokenů. Toto varování můžete ignorovat, nebo nastavit limity explicitně tak, aby odpovídaly vašemu modelu:

export COPILOT_PROVIDER_MAX_PROMPT_TOKENS="200000"
export COPILOT_PROVIDER_MAX_OUTPUT_TOKENS="32000"

Chcete-li potvrdit, že provoz dorazí do AI Gateway, projděte si Ověřte, že to funguje.