Метафора / Перенос

Claude Code через локальный адаптер CCS

Готовимся к запуску

Доступ к API, регистрации и оплате пока закрыт. Инструкции доступны для подготовки.

Локальный CCS переводит запросы Claude Code в Chat Completions. Настройки ниже относятся к CCS 0.65.3 и Claude Code 2.1.284; отдельный запуск сохраняет обычную конфигурацию Claude.

Настройка по шагам

Адрес API: https://api.metaphorai.ru/v1. Для CCS используйте https://api.metaphorai.ru без /v1. Вместо MODEL_ID укажите ID модели после открытия каталога. Ключ храните в окружении или Credentials. Доступ к API, регистрации и оплате пока закрыт. Инструкции доступны для подготовки.

  1. Подготовьте Claude Code и бинарник CCS 0.65.3 для своей системы по официальным ссылкам. Команды ниже рассчитаны на Bash в Linux или macOS.
  2. Создайте отдельную папку настроек. Сохраните JSON как config.json в этой папке; существующие профили CCS и файлы проекта не заменяйте. Если папка уже используется, выберите другое имя и исправьте пути в командах.
  3. В терминале адаптера задайте ROUTER_API_KEY. В JSON оставьте строку $ROUTER_API_KEY: CCS прочитает ключ из окружения. Base URL здесь указан без /v1, адаптер добавляет путь сам.
  4. Запустите CCS в отдельном терминале и оставьте его работать. Порт провайдера для Claude: 7897. Общий порт адаптера: 7896.
  5. В другом терминале откройте рабочий проект и запустите Claude командой ниже. Адрес и токен действуют только для этого процесса; --bare отключает автоподключение пользовательских расширений и MCP для этого запуска.
  6. Начните с короткой задачи. Каждый запрос агента учитывается отдельно. Расход смотрите в кабинете: клиентский счётчик reasoning может отличаться от серверного usage.
  7. CCS сохраняет тела запросов в локальной SQLite. request_log_limit=0 не отключает хранение. После остановки адаптера можно удалить ccs.db, ccs.db-wal и ccs.db-shm только из подготовленной папки, если история не нужна.
  8. Совместимость зависит от версии клиента, адаптера и модели. Начните с небольшой задачи в отдельном проекте и проверьте расходы. Прежний CCR 3.1.3 терял reasoning после инструмента и для этого контракта не используется.

Примеры настройки

Папка настроек CCS · Bash
umask 077
mkdir -p "$HOME/.config/metaphor/ccs"
Конфигурация CCS
{
  "current": "metaphor",
  "listen": "127.0.0.1:7896",
  "request_log_limit": 0,
  "db_path": "ccs.db",
  "providers": {
    "metaphor": {
      "id": "metaphor",
      "base_url": "https://api.metaphorai.ru",
      "api_key": "$ROUTER_API_KEY",
      "api_format": "openai",
      "api_version": "chat_completions",
      "enabled": true,
      "fallback": false,
      "port": 7897,
      "inject_thinking_history": false,
      "strict_thinking_history": false,
      "max_tokens_cap": 1024,
      "model_map": {},
      "routes": [],
      "extra_headers": {},
      "quota_command": null
    }
  }
}
Запуск CCS · отдельный терминал
(
  cd "$HOME/.config/metaphor/ccs" || exit
  CCS_CONFIG_DIR="$PWD" ccs serve --listen 127.0.0.1:7896
)
Запуск Claude Code · терминал проекта
ANTHROPIC_BASE_URL='http://127.0.0.1:7897' \
ANTHROPIC_API_KEY='local-client-token' \
ANTHROPIC_AUTH_TOKEN='' \
CLAUDE_CODE_MAX_RETRIES=0 \
claude --bare --model 'MODEL_ID'

Условия и ограничения

  • Для подключения нужен сторонний локальный адаптер CCS. Подписка Claude действует отдельно от доступа к моделям Метафоры.
  • CCS 0.65.3 сохраняет тела запросов в своей локальной SQLite даже при request_log_limit=0. Не передавайте CCS конфиденциальные данные, если их нельзя хранить локально.
  • Выберите модель с tools. Успех, ошибка и отмена могут приводить к разным состояниям резерва; окончательное состояние смотрите в кабинете. Новые версии клиента и адаптера требуют отдельной проверки.

Документация клиента