Руководство по настройке провайдеров

Это руководство содержит подробные инструкции по настройке всех провайдеров, поддерживаемых Claudex, включая провайдеров с API-ключами, OAuth-подписки, облачные платформы и локальные модели.

Провайдеры с API-ключами

Anthropic

1. Зарегистрируйтесь на console.anthropic.com
2. Перейдите в API Keys и создайте новый ключ (формат: sk-ant-*)

[[profiles]]
name = "anthropic"
provider_type = "DirectAnthropic"
base_url = "https://api.anthropic.com"
api_key = "sk-ant-..."
default_model = "claude-sonnet-4-20250514"

claudex profile test anthropic

MiniMax

1. Зарегистрируйтесь на platform.minimaxi.com
2. Перейдите в API Keys в консоли

[[profiles]]
name = "minimax"
provider_type = "DirectAnthropic"
base_url = "https://api.minimax.io/anthropic"
api_key = "..."
default_model = "claude-sonnet-4-20250514"

claudex profile test minimax

OpenRouter

1. Зарегистрируйтесь на openrouter.ai
2. Получите API-ключ на openrouter.ai/keys

[[profiles]]
name = "openrouter"
provider_type = "OpenAICompatible"
base_url = "https://openrouter.ai/api/v1"
api_key = "sk-or-..."
default_model = "anthropic/claude-sonnet-4"

claudex profile test openrouter

Совет

OpenRouter поддерживает сотни моделей от разных провайдеров. Используйте префикс anthropic/ для моделей Claude.

Grok (xAI)

1. Зарегистрируйтесь на console.x.ai
2. Создайте API-ключ в консоли

[[profiles]]
name = "grok"
provider_type = "OpenAICompatible"
base_url = "https://api.x.ai/v1"
api_key = "xai-..."
default_model = "grok-3-beta"

claudex profile test grok

OpenAI

1. Зарегистрируйтесь на platform.openai.com
2. Создайте API-ключ на platform.openai.com/api-keys

[[profiles]]
name = "chatgpt"
provider_type = "OpenAICompatible"
base_url = "https://api.openai.com/v1"
api_key = "sk-..."
default_model = "gpt-4o"

claudex profile test chatgpt

DeepSeek

1. Зарегистрируйтесь на platform.deepseek.com
2. Создайте API-ключ в консоли

[[profiles]]
name = "deepseek"
provider_type = "OpenAICompatible"
base_url = "https://api.deepseek.com"
api_key = "sk-..."
default_model = "deepseek-chat"

claudex profile test deepseek

Kimi / Moonshot

1. Зарегистрируйтесь на platform.moonshot.cn
2. Создайте API-ключ в консоли

[[profiles]]
name = "kimi"
provider_type = "OpenAICompatible"
base_url = "https://api.moonshot.ai/v1"
api_key = "sk-..."
default_model = "kimi-k2-0905-preview"

claudex profile test kimi

GLM / Zhipu

1. Зарегистрируйтесь на open.bigmodel.cn
2. Создайте API-ключ в консоли

[[profiles]]
name = "glm"
provider_type = "OpenAICompatible"
base_url = "https://api.z.ai/api/paas/v4"
api_key = "..."
default_model = "glm-4.6"

claudex profile test glm

Groq

1. Зарегистрируйтесь на console.groq.com
2. Создайте API-ключ в Settings > API Keys

[[profiles]]
name = "groq"
provider_type = "OpenAICompatible"
base_url = "https://api.groq.com/openai/v1"
api_key = "gsk_..."
default_model = "llama-3.3-70b-versatile"

claudex profile test groq

Совет

Groq обеспечивает крайне быстрый инференс для моделей с открытым кодом. Популярные модели: llama-3.3-70b-versatile, mixtral-8x7b-32768 и gemma2-9b-it.

Mistral AI

1. Зарегистрируйтесь на console.mistral.ai
2. Создайте API-ключ в консоли

[[profiles]]
name = "mistral"
provider_type = "OpenAICompatible"
base_url = "https://api.mistral.ai/v1"
api_key = "..."
default_model = "mistral-large-latest"

claudex profile test mistral

Together AI

1. Зарегистрируйтесь на api.together.ai
2. Создайте API-ключ в панели управления

[[profiles]]
name = "together"
provider_type = "OpenAICompatible"
base_url = "https://api.together.xyz/v1"
api_key = "..."
default_model = "meta-llama/Llama-3.3-70B-Instruct-Turbo"

claudex profile test together

Perplexity

1. Зарегистрируйтесь на perplexity.ai
2. Создайте API-ключ на perplexity.ai/settings/api

[[profiles]]
name = "perplexity"
provider_type = "OpenAICompatible"
base_url = "https://api.perplexity.ai"
api_key = "pplx-..."
default_model = "sonar-pro"

claudex profile test perplexity

Заметка

Модели Perplexity имеют встроенные возможности веб-поиска. Полезно для исследовательских задач.

Cerebras

1. Зарегистрируйтесь на cloud.cerebras.ai
2. Создайте API-ключ в панели управления

[[profiles]]
name = "cerebras"
provider_type = "OpenAICompatible"
base_url = "https://api.cerebras.ai/v1"
api_key = "..."
default_model = "llama-3.3-70b"

claudex profile test cerebras

Облачные платформы

Azure OpenAI

1. Создайте ресурс Azure OpenAI в Azure Portal
2. Разверните модель и запишите имя ресурса и имя развёртывания
3. Получите API-ключ в разделе Keys and Endpoint

[[profiles]]
name = "azure-openai"
provider_type = "OpenAICompatible"
base_url = "https://YOUR_RESOURCE.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT"
api_key = "YOUR_AZURE_KEY"
default_model = "gpt-4o"

[profiles.query_params]
api-version = "2024-12-01-preview"

claudex profile test azure-openai

Заметка

Azure OpenAI автоматически определяется по base_url, содержащему openai.azure.com. Аутентификация использует заголовок api-key вместо Authorization: Bearer. Query-параметр api-version обязателен.

Google Vertex AI

1. Включите API Vertex AI в вашем GCP-проекте
2. Сгенерируйте токен доступа с помощью gcloud auth print-access-token

[[profiles]]
name = "vertex-ai"
provider_type = "DirectAnthropic"
base_url = "https://us-east5-aiplatform.googleapis.com/v1/projects/YOUR_PROJECT/locations/us-east5/publishers/anthropic/models"
api_key = "YOUR_GCLOUD_TOKEN"
default_model = "claude-sonnet-4@20250514"

claudex profile test vertex-ai

Осторожно

Вывод gcloud auth print-access-token истекает примерно через 1 час. Для промышленного использования рассмотрите сервисный аккаунт с автоматическим обновлением токена.

AWS Bedrock (через LiteLLM)

AWS Bedrock поддерживается через прокси LiteLLM:

1. Установите LiteLLM: pip install litellm
2. Запустите прокси:

litellm --model bedrock/anthropic.claude-sonnet-4-20250514-v2:0

3. Настройте Claudex:

[[profiles]]
name = "bedrock"
provider_type = "OpenAICompatible"
base_url = "http://localhost:4000/v1"
api_key = "sk-litellm"
default_model = "bedrock/anthropic.claude-sonnet-4-20250514-v2:0"

OAuth-подписки

OAuth-аутентификация позволяет использовать существующие подписки провайдеров (ChatGPT Plus, Claude Max и т.д.) вместо отдельных API-ключей.

Claude Max / Pro

Используйте существующую подписку Claude через нативную OAuth-сессию Claude Code.

Предварительные условия: Claude Code установлен и выполнен вход (команда claude работает нормально)

[[profiles]]
name = "claude-max"
provider_type = "DirectAnthropic"
base_url = "https://api.claude.ai"
default_model = "claude-sonnet-4-20250514"
auth_type = "oauth"
oauth_provider = "claude"

[profiles.models]
haiku = "claude-haiku-4-20250514"
sonnet = "claude-sonnet-4-20250514"
opus = "claude-opus-4-20250514"

Заметка

OAuth-профили Claude используют специальный режим gateway auth. Claudex пропускает прокси и позволяет Claude Code использовать собственный OAuth напрямую. Отдельный шаг claudex auth login не требуется.

ChatGPT Plus / Codex CLI

Используйте подписку ChatGPT Plus или Pro через токен Codex CLI.

Предварительные условия: Установите Codex CLI и выполните аутентификацию:

# Установить Codex CLI
npm install -g @openai/codex

# Аутентифицироваться (открывает браузер)
codex auth

Затем настройте Claudex:

[[profiles]]
name = "codex-sub"
provider_type = "OpenAIResponses"
base_url = "https://chatgpt.com/backend-api/codex"
default_model = "gpt-5.3-codex"
auth_type = "oauth"
oauth_provider = "openai"

[profiles.models]
haiku = "codex-mini-latest"
sonnet = "gpt-5.3-codex"
opus = "gpt-5.3-codex"

# Считать токен из Codex CLI
claudex auth login openai --profile codex-sub

# Проверить
claudex auth status

# Запустить
claudex run codex-sub

Совет

Поддерживаемые модели на Codex endpoint: gpt-5.3-codex, gpt-5.1-codex, codex-mini-latest. Модель gpt-4o НЕ поддерживается на endpoint chatgpt.com Codex. strip_params = "auto" автоматически обнаруживает этот endpoint и удаляет temperature/top_p/top_k.

Google Gemini

Используйте аккаунт Google через учётные данные Gemini CLI.

[[profiles]]
name = "gemini-sub"
provider_type = "OpenAICompatible"
base_url = "https://generativelanguage.googleapis.com/v1beta/openai"
default_model = "gemini-2.5-pro"
auth_type = "oauth"
oauth_provider = "google"

[profiles.models]
haiku = "gemini-2.0-flash"
sonnet = "gemini-2.5-pro"
opus = "gemini-2.5-pro"

# Логин считывает из учётных данных Gemini CLI
claudex auth login google --profile gemini-sub

# Проверить
claudex auth status

Qwen / Tongyi Qianwen

Используйте аккаунт Qwen через OAuth Device Code flow.

[[profiles]]
name = "qwen-oauth"
provider_type = "OpenAICompatible"
base_url = "https://chat.qwen.ai/api"
default_model = "qwen3-235b-a22b"
auth_type = "oauth"
oauth_provider = "qwen"

# Запустить device code flow
claudex auth login qwen --profile qwen-oauth

# Проверить
claudex auth status

Kimi / Moonshot (OAuth)

Используйте аккаунт Kimi через учётные данные Kimi CLI.

[[profiles]]
name = "kimi-oauth"
provider_type = "OpenAICompatible"
base_url = "https://api.moonshot.cn/v1"
default_model = "moonshot-v1-128k"
auth_type = "oauth"
oauth_provider = "kimi"

# Логин считывает из учётных данных Kimi CLI
claudex auth login kimi --profile kimi-oauth

# Проверить
claudex auth status

GitHub Copilot

Используйте подписку GitHub Copilot через OAuth Device Code flow.

[[profiles]]
name = "copilot"
provider_type = "OpenAICompatible"
base_url = "https://api.githubcopilot.com"
default_model = "gpt-4o"
auth_type = "oauth"
oauth_provider = "github"

# Запустить device code flow (открывает браузер для входа через GitHub)
claudex auth login github --profile copilot

# Проверить
claudex auth status

GitLab Duo

Используйте подписку GitLab Duo через Personal Access Token.

[[profiles]]
name = "gitlab-duo"
provider_type = "OpenAICompatible"
base_url = "https://gitlab.com/api/v4/ai/llm/proxy"
default_model = "claude-sonnet-4-20250514"
auth_type = "oauth"
oauth_provider = "gitlab"

# Установите токен GitLab как переменную окружения
export GITLAB_TOKEN=glpat-...

# Логин
claudex auth login gitlab --profile gitlab-duo

# Проверить
claudex auth status

Заметка

GitLab Duo требует переменную окружения GITLAB_TOKEN с Personal Access Token, имеющим scope ai_features. Для self-managed инстансов GitLab обновите base_url соответственно.

Локальные модели

Ollama

1. Установите Ollama: ollama.com
2. Загрузите модель:

ollama pull qwen2.5:72b

3. Настройте Claudex:

[[profiles]]
name = "local-qwen"
provider_type = "OpenAICompatible"
base_url = "http://localhost:11434/v1"
api_key = ""
default_model = "qwen2.5:72b"

claudex profile test local-qwen

Заметка

Ollama не требует API-ключа. Оставьте api_key пустым или не указывайте его.

vLLM

1. Установите и запустите vLLM:

pip install vllm
vllm serve meta-llama/Llama-3.3-70B-Instruct --port 8000

2. Настройте Claudex:

[[profiles]]
name = "local-llama"
provider_type = "OpenAICompatible"
base_url = "http://localhost:8000/v1"
api_key = ""
default_model = "meta-llama/Llama-3.3-70B-Instruct"

LM Studio

1. Скачайте LM Studio с lmstudio.ai
2. Загрузите модель и запустите локальный сервер (порт по умолчанию: 1234)

[[profiles]]
name = "lm-studio"
provider_type = "OpenAICompatible"
base_url = "http://localhost:1234/v1"
api_key = "lm-studio"
default_model = "local-model"

Проверка настройки

После настройки любого провайдера проверьте подключение:

# Тестировать конкретный профиль
claudex profile test <profile-name>

# Тестировать все профили
claudex profile test all

# Список всех настроенных профилей
claudex profile list