API Hop

Dokumentacja

Dokumentacja API Hop

Integracja z Claude Code

Używaj punktu końcowego API Hop zgodnego z Claude Messages w Claude Code.

Claude Code wywołuje modele przez protokół Anthropic Messages. Ustaw ANTHROPIC_BASE_URL na zgodny z Anthropic bazowy adres URL pokazany na tej stronie.

Claude Sonnet 4.6 (claude-sonnet-4-6) jest obsługiwany przez dostawcę, ale nie jest obecnie opublikowany w API Hop. Nie jest aktywnym domyślnym modelem integracji. Przed wywołaniem dowolnego modelu potwierdź dostęp we własnej odpowiedzi GET https://api.apihop.ai/v1/models.

text
ANTHROPIC_BASE_URL=https://api.apihop.ai/anthropic

Wymagania wstępne

Najpierw przygotuj ważny klucz API API Hop. Klucz zostanie zapisany w lokalnym środowisku powłoki. Nie umieszczaj go w repozytoriach, logach ani na zrzutach ekranu.

Zainstaluj Claude Code

W macOS / Linux użyj natywnego instalatora Claude Code:

bash
curl -fsSL https://claude.ai/install.sh | bash

Jeśli instalator wskazuje ~/.local/bin/claude, ale nie można znaleźć claude, otwórz nowy terminal lub dodaj ~/.local/bin do PATH.

Dla starszych sposobów pracy nadal dostępny jest pakiet npm:

bash
npm install -g @anthropic-ai/claude-code

Nie używaj sudo npm install -g @anthropic-ai/claude-code; może to powodować problemy z uprawnieniami podczas późniejszych aktualizacji.

Sprawdź CLI po instalacji:

bash
claude --version
claude doctor

W Windows zaleca się Git Bash lub WSL do Claude Code. PowerShell również pozwala ustawiać zmienne środowiskowe, ale ich trwałość zależy od terminala.

Skonfiguruj zmienne środowiskowe

Ustawienia tymczasowe dotyczą tylko bieżącej sesji terminala:

bash
export ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"
export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
export ANTHROPIC_MODEL="claude-sonnet-5-5"

macOS domyślnie używa zsh. Aby zachować konfigurację, zapisz zmienne w ~/.zshrc, a następnie uruchom source ~/.zshrc, aby bieżący terminal od razu je odczytał:

bash
printf '%s\n' \
  'export ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"' \
  'export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"' \
  'export ANTHROPIC_MODEL="claude-sonnet-5-5"' \
  >> ~/.zshrc

source ~/.zshrc

W Linux z bash zapisz te same zmienne w ~/.bashrc i uruchom source ~/.bashrc.

Ustawienia tymczasowe w Windows PowerShell:

powershell
$env:ANTHROPIC_AUTH_TOKEN="YOUR_APIHOP_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
$env:ANTHROPIC_MODEL="claude-sonnet-5-5"

Trwałe ustawienia PowerShell na poziomie użytkownika:

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_APIHOP_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.apihop.ai/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5-5", "User")

Otwórz nową sesję PowerShell przed uruchomieniem claude.

Plik ustawień

Alternatywnie do konfiguracji powłoki utwórz lub edytuj ~/.claude/settings.json. Jeśli plik już istnieje, scal env i model z istniejącym JSON zamiast zastępować pozostałe ustawienia:

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_APIHOP_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.apihop.ai/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  },
  "model": "claude-sonnet-5-5"
}

Dostępne modele:

  • claude-fable-5
  • claude-fable-5-1
  • claude-opus-4-6
  • claude-opus-4-7
  • claude-opus-4-8
  • claude-opus-5
  • claude-opus-5-5
  • claude-sonnet-5
  • claude-sonnet-5-5

Użyj GET https://api.apihop.ai/v1/models, aby sprawdzić modele obecnie dostępne dla Twojego klucza API.

Uruchom i przetestuj

Po ustawieniu zmiennych środowiskowych uruchom Claude Code ponownie, a następnie wyślij zwykły prompt:

bash
claude "Reply exactly OK."

Możesz też uruchomić tryb interaktywny:

bash
claude

Przy pierwszym uruchomieniu Claude Code może poprosić o wybór motywu, potwierdzenie bezpieczeństwa, konfigurację terminala lub zaufanie bieżącemu katalogowi. Postępuj zgodnie z komunikatami terminala.

Wybierz model

Ustaw model domyślny zmienną środowiskową lub wybierz model dla pojedynczego polecenia za pomocą --model:

bash
claude --model claude-sonnet-5-5 "Review this PR"

Zachowanie punktu końcowego

Claude Code uwierzytelnia się skonfigurowanym kluczem API API Hop. Usługa przyjmuje obie formy uwierzytelniania:

http
x-api-key: YOUR_APIHOP_API_KEY
anthropic-version: 2023-06-01
http
Authorization: Bearer YOUR_APIHOP_API_KEY
anthropic-version: 2023-06-01

Odpowiedzi zachowują natywny format JSON Anthropic Messages lub zdarzeń SSE. Nie są konwertowane na format OpenAI.

Diagnozowanie problemów

  • ANTHROPIC_BASE_URL musi być publicznym bazowym adresem URL API z tej strony z dopisanym /anthropic.
  • Nie umieszczaj ścieżek punktów końcowych w ANTHROPIC_BASE_URL; potrzebny jest tylko bazowy adres URL zgodny z Anthropic.
  • Po edycji ~/.zshrc w macOS uruchom source ~/.zshrc lub otwórz nowy terminal przed uruchomieniem Claude Code.
  • Jeśli przy claude pojawia się komunikat o nieznalezieniu polecenia, sprawdź, czy katalog instalacji znajduje się w PATH; częsta lokalizacja to ~/.local/bin/claude.
  • Jeśli claude doctor zgłasza brak zmiennych środowiskowych, uruchom echo $ANTHROPIC_BASE_URL i echo $ANTHROPIC_MODEL w tym samym terminalu, aby potwierdzić ich wczytanie.
  • Jeśli otrzymasz 401, sprawdź, czy klucz API jest ważny.
  • Jeśli model jest niedostępny, sprawdź, czy jego nazwa pochodzi z powyższej listy dostępnych modeli.
  • Po zmianie zmiennych środowiskowych uruchom proces Claude Code ponownie.
  • POST https://api.apihop.ai/anthropic/v1/messages: punkt końcowy zgodny z Anthropic Messages.