Налаштування власного API-ендпоінту Claude Code через третій бізнес-партнер з китайськими відкритими моделями

Клауд-Код може бути налаштований для спілкування з ендпоінтом, який відповідає стандарту Anthropic, замість прямого використання ендпоінту постачальника. Це дозволяє тестувати роботу шлюзу, керованого третім бізнес-партнером, з ідентифікаторами моделей, які виставляє шлюз, включаючи китайські відкриті моделі, доступні в поточному каталозі моделей ECAIX.

Ця інструкція стосується робочого процесу, специфічного для постачальника, для сумісності з третім бізнес-партнером. Офіційна документація шлюзу Anthropic не підтримує маршрутизацію Клауд-Коду до не-Клауд-моделей через шлюз. ECAIX не стверджує, що цей робочий процес офіційно підтримується Anthropic, і не-Клауд-моделі можуть не забезпечувати всі можливості Клауд-Коду.

Початок роботи

Якщо ви вже розумієте межі сумісності, спробуйте спочатку короткий шлях:

1. Відкрийте поточний каталог моделей ECAIX і виберіть активний ідентифікатор моделі.
2. Створіть ключ API ECAIX і зберігайте його поза контрольом версій.
3. Встановіть ANTHROPIC_BASE_URL до https://ecaix.com/api/ai/v1/anthropic.
4. Відправте діагностичну запит нижче і записуйте статус HTTP.
5. Запустіть Клауд-Код у режимі тестування в чистому проекті з claude -p.
6. Тестуйте інструменти, потокове виведення, обмеження контексту та права доступу окремо.

Статус валідації при публікації

Ця таблиця намічена: приклад конфігурації не є тим самим, що виміряний результат сумісності.

Що зміниться в налаштуванні

Налаштування складається з чотирьох окремих частин:

1. Клауд-Код — це клієнт, який створює завдання з програмування та відправляє запити.
2. Шлюз, сумісний з Anthropic — отримує запити на ендпоінті у стилі Anthropic.
3. Ідентифікатор моделі — вибирає верхню модель, яку виставляє шлюз.
4. Ключ API — аутентифікує запит та визначає обліковий запис, квоти та права доступу.

Зміна ендпоінту не перетворює не-Клауд-модель на Клауд. Це лише змінює, яку сумісну поверхню API отримує запит. Використання інструментів, обробка контексту, імена моделей, поведінка потокового виведення та потоки прав доступу можуть відрізнятися за версією клієнта та реалізацією шлюзу.

Перед початком

Ви повинні мати:

• Установку Клауд-Коду, яка підтримує конфігурацію ендпоінту через середовище або налаштування.
• Ключ API ECAIX.
• Ідентифікатор моделі, який тепер існує в каталозі моделей ECAIX.
• Термінал, де можна запустити невеликий тестовий запит без збереження ключа API в контрольованій версії.

Каталог змінюється з часом. Перед копіюванням ідентифікатора моделі в файл конфігурації відкрийте каталог моделей ECAIX і переконайтеся, що модель активна та доступна для стилю API, який ви плануєте використовувати.

Налаштування шлюзу ендпоінту

Клауд-Код зберігає налаштування в файлі ~/.claude/settings.json на багатьох установках. Точна схема налаштувань може змінюватися, тому слід розглядати наступний шаблон як початок і порівнювати з документацією вашої встановленої версії.

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

Не комітуйте цей файл до публічного репозиторія, якщо він містить реальний ключ API. Переважно використовуйте локальну середовищну змінну, менеджер секретів або механізм аутентифікації, рекомендований вашою установкою Клауд-Коду.

Також можна налаштувати ендпоінт у сесії оболонки під час тестування:

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"

Імена змінних та налаштувань, підтримуваних конкретним випуском Клауд-Коду, можуть змінюватися. Якщо клієнт ігнорує ANTHROPIC_MODEL, використовуйте поле моделі або механізм іменованих моделей, описаний у вашій версії. Шлюз все одно повинен розпізнавати остаточний ідентифікатор моделі.

Перевірка ендпоінту, сумісного з Anthropic

Перед початком інтерактивного сеансу програмування відправте невеликий запит. Це розділить проблеми з ендпоінтом, аутентифікацією та ідентифікатором моделі від специфічних для Клауд-Коду поведінок.

Нижче наведено команду, яка зберігає заголовки відповіді та тіло відповіді окремо, а потім виводить статус HTTP. Використовуйте реальний авторизований ключ лише в вашій локальній оболонці; ніколи не вставляйте його в статтю, запит або спільний лог.

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

Очікувана інтерпретація:

• 200: оцініть форму відповіді та переконайтеся, що повертаються поля моделі або використання.
• 401 або 403: перевірте ключ, заголовки, обліковий запис та сферу прав доступу перед зміною промови.
• 404: перевірте основний URL, суфікс /messages та розгортання ендпоінту.
• 400: зменшіть запит до найменшого валідного тіла та перевірте специфічні поля моделі.
• 5xx або timeout: запишіть час запиту та тіло відповіді, а потім розділіть поведінку шлюзу, верхньої моделі та клієнта.

Успішна відповідь підтверджує, що ключ, ендпоінт, формат запиту та ідентифікатор моделі працювали разом для цього запиту. Це не гарантує, що всі можливості Клауд-Коду працюватимуть.

Вибір ідентифікатора моделі

Каталог ECAIX містить сім'ї моделей від китайських постачальників. Правильна початкова модель залежить від завдання, а не лише від назви моделі.

Програмування та загальне розроблення

Починайте з поточних моделей DeepSeek, Qwen, GLM або Seed, які здатні до програмування та доступні в каталозі. Наприклад, каталог може виставляти ідентифікатори, такі як deepseek-v4.1-flash, qwen3.8-flash, glm-5.3 або seed-2.0-code. Доступність та можливості можуть змінюватися, тому завжди перевіряйте поточну сторінку моделі перед публікацією конфігурації.

Довгий контекст та робота з репозиторіями

Для великих репозиторіїв або довгих технічних документів порівняйте довжину контексту, показану в каталозі моделі. Більший контекстний вік не автоматично означає кращі результати з репозиторіями: структура промови, підтримка інструментів, обмеження виходу та обмеження шлюзу також важливі.

Виклик інструментів та робота агента

Якщо робочий процес потребує виклику функцій або інструментів, перевірте документацію моделі та ендпоінту. Деякі постачальники виставляють виклик інструментів через API, сумісні з OpenAI, тоді як інші виставляють різні назви полів або підтримують лише підмножину поведінки виклику інструментів. Починайте з тесту виклику інструменту, щоб дати моделі доступ до реального репозиторія або зовнішньої системи.

Розробка на китайській мові

Китайські відкриті моделі можуть бути корисними, коли кодова база, документація, трекінг-система або робочий процес команди містить матеріали на китайській мові. Оцінюйте модель за допомогою власних промов та зразків репозиторіїв, а не лише за загальними рейтин

Тест коду після успішного API-запиту

Після успішного безпосереднього запиту розпочніть з читання або низькоризикової команди:

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

Затем перевірте одну вузькоспеціалізовану задачу. Наприклад:

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

Використовуйте все більш вимогливі тести:

1. Відповідь у текстовому форматі.
2. Коротке пояснення коду.
3. Навігація по репозиторію.
4. Контрольоване редагування в тимчасовому гілці.
5. Використання інструментів або багаторівнева задача.
6. Стрімінг та поведінка довгого контексту.

Не вважайте успішну відповідь на текстовий запит доказом того, що поведінка промптів з дозволами, виклики інструментів, стрімінг, обмеження контексту або редагування файлів повністю відповідає сесії на базі Клауде.

Вибір правильного API-маршуру

Клауде Код — це лише один клієнтський робочий процес. Правильний API-маршрут залежить від клієнта та функціоналу, який вам потрібен:

Для ECAIX використовуйте документацію про повідомлення Антропіка для стилізованого шляху Антропіка та документацію про Chat Completions для клієнтів, сумісних з OpenAI. Використовуйте каталог моделей, щоб перевірити поточний ID моделі та сторінку цін, щоб перевірити поточні відображені ціни.

Матриця сумісності

Наведене нижче — це межа публікації як доказ, а не твердження про те, що кожна функція підтримується:

Це розмежування запобігає тому, щоб успішний мінімальний запит представлявся як повне сертифікація сумісності з Клауде Кодом.

Сторінки деталей моделей та поточні ID

Використовуйте сторінки деталей моделей замість копіювання старих імен моделей з блогу:

• DeepSeek v4.1 Flash
• Qwen 3.8 Flash
• GLM 5.3
• Kimi K3

Ці посилання є вхідними точками для перевірки поточного ID моделі, інформації про контекст та сторінкових деталей. Доступність може змінитися після публікації.

Після помилки використовуйте наступну послідовність, а не зміну декількох параметрів одночасно:

1. Збережіть HTTP-статус та тіло відповіді.
2. Підтвердіть базовий URL та суфікс кінцевого пункту.
3. Підтвердіть, що API-ключ присутній локально та має очікувані права.
4. Підтвердіть точний ID моделі в реальному каталозі моделей.
5. Перезапустіть з найменшим валідним запитом.
6. порівняйте результат з запитом, який відправляє Клауде Код.
7. Тільки після цього розслідуйте проблеми маршрутизації, тайм-аут або розбіжності схеми інструментів.

Для Model not found це розрізняє помилку в написанні від проблеми з дозволами, проблеми з маршрутизацією шлюзу та несправності постачальника. Для 401 та 403 зміна моделі, як правило, не є першою проблемою. Для випадку успішного тексту/помилки інструменту наступна перевірка повинна бути схемою інструменту, а не іншим текстом.

Поширені помилки

Безпека та обробка даних

Оцініть шлюз як окрему межу послуг. Перед відправкою джерельного коду або даних клієнтів перевірте:

• Яка служба отримує промпти та зміни файлів.
• Чи логіруються запити та відповіді.
• Як зберігаються та обмінюються API-ключі.
• Чи модельний шлях є реальним підключенням до постачальника чи іншим шлюзом для падіння на іншого постачальника.
• Які інструменти може викликати клієнт.
• Як відкликати ключ після тестування.

Ніколи не вставляйте ключ виробничого API в публічне запитання, статтю, скріншот або історію команд, які поділяються з іншими.

Як це відрізняється від офіційної підтримки Клауде Код

Офіційна документація Антропіка є авторитетом щодо підтримки Клауде Код. Третя сторона шлюз може викристалізувати сумісний формат запитів, але сумісність не є тим самим, що офіційна підтримка. Безпечний спосіб опису цього робочого процесу:

• Підтримується цим конфігурацією шлюзу: кінцевий пункт, заголовки авторизації, ID моделей та функції, які ECAIX перевірив.
• Не автоматично підтримується: всі функції Клауде Код, поведінка не-Клауде моделей, специфічні семантики інструментів постачальника та майбутні версії клієнта.
• Потрібно перевірити після змін: доступність моделей, поля запитів, обмеження контексту, стрімінг, виклики інструментів та ціни.

Питання та відповіді

Чи потрібна підписка на Клауде для цього робочого процесу?

Це залежить від вашої установки Клауде Код, умов користування та конфігурації шлюзу. Ця стаття не змінює вимоги до підписки або продуктів Антропіка. Перевірте поточну офіційну документацію Клауде Код та умови шлюзу, яким ви наміряєтесь використовувати.

Чи можу я використовувати будь-який ID моделі з каталогу?

Ні. Використовуйте ID моделі, які є поточними, активними та сумісними з кінцевим пунктом та рахунком. Модель може бути присутньою в каталозі, але недоступна для певного стилю API та ключа.

Чи гарантує антропічний-сумісний кінцевий пункт виклик інструментів?

Ні. Сумісність протоколу та поведінка інструментів — це окремі перевірки. Запустіть тест виклику однієї функції та перевірте документацію моделі на поточний стан перед використанням інструментів у автоматизованому процесі.

Де перевіряти поточні моделі та ціни?

Використовуйте каталог моделей ECAIX та сторінку цін. Ці сторінки є джерелом правди для поточної доступності та відображеної ціни; не копіюйте старі ID моделей або ціни з цієї статті.

Заключна думка

Безпечна послідовність інтеграції:

1. Прочитайте офіційну документацію Клауде Код та шлюзу.
2. Сформуйте ключ API ECAIX без публічного розголошення.
3. Виберіть поточний доступний ID моделі з /models.
4. Конфігуруйте ANTHROPIC_BASE_URL та ключ локально.
5. Перевірте /api/ai/v1/anthropic/messages з мінімальним запитом.

Практичний перелік сумісності

Перед тим, як вважати інтеграцію корисною для команди, записуйте результат кожного тесту:

Цей перелік корисніший, ніж одне успішне привітання. Ворота можуть приймати текстовий запит, але можуть вимагати різних налаштувань для інструментів, стрімінгу, вікна контексту чи ідентифікаторів моделей.

Коли не використовувати конфігурацію

Не використовуйте цей підхід для чутливих виробничих репозиторіїв до тих пір, поки не зрозумієте логі, тривалість зберігання, маршрутизацію та контроль доступу. Не слід вважати, що ендпоінт, який відповідає вимогам постачальника, забезпечує такий самий рівень безпеки, системні промпти, права на інструменти чи облік контексту, як у оригінальному постачальнику. Для регульованих або конфіденційних робіток завершіть внутрішню перевірку безпеки та використовуйте шлях до розгортання, який схвалила ваша організація.

Підтримання конфігурації

Перевірте налаштування, якщо будь-яке з наступних змін:

• Claude Code оновлено.
• Ворота змінили свою реалізацію, що відповідає стандартам Anthropic.
• Ідентифікатор моделі змінений, видалено або відображений на іншу верхню модель.
• Змінилися параметри стрімінгу, інструментів, обмежень контексту чи поведінки помилок.
• ECAIX змінив моделі чи обмеження API, показані в живому каталозі.

Утримуйте конфігурацію в невеликому, документаційному тестовому проєкті. Це спростить порівняння поведінки після оновлення клієнта чи моделі без викривання виробничого репозиторію.

Джерела

• Anthropic Claude Code: Інші LLM ворота
• Документація DeepSeek API
• Qwen: Початок роботи
• Зміна сумісності OpenAI API від Zhipu