Как использовать Claude Code с cloud.ru Foundation Models API

Отislander

Установите Claude Code

Запустите Claude Code.

При первом запуске Claude Code попытается подключиться к API Anthropic. Если у вас нет подписки Claude, аккаунта Anthropic, или серверы Claude недоступны (геоблокировка), то вы получите ошибку ECONNREFUSED или аналогичную.

Решение: запустите Claude Code с пустыми переменными окружения (скопируйте, как есть и вставьте в командную строку: 

ANTHROPIC_BASE_URL="..." ANTHROPIC_AUTH_TOKEN="..." ANTHROPIC_MODEL="..." claude

Это позволит пройти первоначальную инициализацию.

Выйдите из Claude Code

Установите Claude Code Proxy

Claude Code Proxy — прокси-сервер, позволяющий использовать Claude Code CLI с любыми OpenAI-совместимыми провайдерами вместо официального Anthropic API. Например, с cloud.ru Evolution Foundation Models API.

Подготовьте окружение:

mkdir claude-code-proxy && cd claude-code-proxy

Создайте docker-compose.yml

services:
  claude-code-proxy:
    image: legard/claude-code-proxy:latest
    container_name: claude-code-proxy
    ports:
      - "127.0.0.1:8082:8082"                                                                                                                                                 
      - "[::1]:8082:8082"
    env_file:
      - .env
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8082/health"]
      interval: 30s
      timeout: 10s
      retries: 3

Порты привязаны к 127.0.0.1 и [::1], чтобы прокси был доступен только локально. Без этого ограничения любой пользователь в вашей сети сможет обнаружить прокси и использовать ваш API-ключ для своих запросов.

Создайте .env с минимальной конфигурацией

# ОБЯЗАТЕЛЬНО: API ключ OpenAI-совместимого провайдера
OPENAI_API_KEY="КАК ПОЛУЧИТЬ СМОТРИ НИЖЕ"

# URL API эндпоинта (по умолчанию: https://api.openai.com/v1)
OPENAI_BASE_URL="https://foundation-models.api.cloud.ru/v1"

# ============================================
# Маппинг моделей Claude -> OpenAI
# ============================================

# Claude Opus -> эта модель
BIG_MODEL="zai-org/GLM-4.6"

# Claude Sonnet -> эта модель
MIDDLE_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct"

# Claude Haiku -> эта модель
SMALL_MODEL="MiniMaxAI/MiniMax-M2"

# ============================================
# Настройки сервера
# ============================================

HOST="0.0.0.0"
PORT="8082"

# LOG_LEVEL уровня DEBUG позволяет смотреть содержимое всего обмена
LOG_LEVEL="INFO"

Запустите

docker-compose up -d

Проверьте, что все работает

curl http://localhost:8082/health | jq

Настройте Claude Code CLI

Можно задать переменные окружения:

export ANTHROPIC_BASE_URL=http://localhost:8082
export ANTHROPIC_API_KEY="any-key"

и запустите Claude Code

claude

Более удобный способ

позволяющий при необходимости одновременно запускать два экземпляра Claude Code (с оригинальными моделями и с Foundation Models):

Создайте отдельный конфигурационный файл, например: ~/.claude/settings-fm.json

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "0",
    "ANTHROPIC_BASE_URL": "http://localhost:8082",
    "ANTHROPIC_API_KEY": "any-key"
  },
  "model": "opus"
}

Добавьте alias

в свой .bashrc или что там у вас:

alias cfm='claude --settings ~/.claude/settings-fm.json'

и запустите Claude Code

cfm

С помощью cfm можно запускать несколько экземпляров Claude Code.

Как получить OPENAI_API_KEY

Чтобы в .env добавить работающий OPENAI_API_KEY и вставить его в конфигурацию в строку OPENAI_API_KEY="КАК ПОЛУЧИТЬ СМОТРИ НИЖЕ" выполните инструкцию, описанную здесь. На «Шаг 2» в «пункт 7» вы получите нужный ключ.

Похожие записи