Перейти к содержимому
NotHolyДокументация

Интеграции

Claude Code

Запускайте Claude Code на моделях NotHoly через notholy run claude или задайте переменные сами.

Открыть как Markdown

Для notholy run claude нужен установленный CLI NotHoly, в котором выполнен вход (Установка CLI), и сам Claude Code: npm i -g @anthropic-ai/claude-code. Для ручной настройки ниже нужен только API-ключ.

Shell
notholy run claude

Команда запускает Claude Code с этими переменными только в его процессе:

Shell
ANTHROPIC_BASE_URL=https://api.notholy.com
ANTHROPIC_AUTH_TOKEN=$NOTHOLY_API_KEY
ANTHROPIC_MODEL='notholy-specter[1m]'
ANTHROPIC_DEFAULT_OPUS_MODEL='notholy-specter[1m]'
ANTHROPIC_DEFAULT_SONNET_MODEL='notholy-specter[1m]'
ANTHROPIC_DEFAULT_HAIKU_MODEL=notholy-specter
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
CLAUDE_CODE_ATTRIBUTION_HEADER=0

Суффикс [1m] сообщает Claude Code, что контекст — миллион токенов. NotHoly убирает его перед маршрутизацией. Реальный лимит этой модели — 1048576 токенов, он указан как context_length в GET /v1/models.

Для ручной настройки задайте те же переменные сами, а API-ключ укажите в ANTHROPIC_AUTH_TOKEN.

Запись конфигурации

notholy connect claude записывает эти значения в .claude/settings.local.json в проекте. Ключ в файл не попадает: Claude Code получает его от notholy token через apiKeyHelper. С --global он пишет в ~/.claude/settings.json. Откат: notholy connect claude --undo.

connect также добавляет MCP-сервер notholy в .mcp.json в проекте и указывает его в enabledMcpjsonServers, поэтому Claude Code не спрашивает подтверждения, когда вы уже доверяете папке. С --global сервер записывается в ~/.claude.json. Путь в .mcp.json абсолютный и действует только на вашей машине, поэтому не добавляйте этот файл в общий репозиторий. notholy run claude передаёт тот же сервер через --mcp-config только для этого процесса.

JSON
{
  "apiKeyHelper": "notholy token",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.notholy.com",
    "ANTHROPIC_MODEL": "notholy-specter[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "notholy-specter[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "notholy-specter[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "notholy-specter",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Проверка

Попросите Claude Code прочитать файл в проекте. Если пришли вызов инструмента и ответ, подключение работает. /status показывает base URL.

Известные ограничения

  • Серверные инструменты вроде веб-поиска Anthropic не выполняются, поэтому MCP-сервер notholy включает web_search. Чтение страниц в Claude Code работает локально и продолжает работать. Для read_url и analyze_file добавьте полный MCP-сервер под другим именем: claude mcp add notholy-full -- notholy mcp.
  • cache_control игнорируется, а кэш работает автоматически, поэтому записи в кэш в /cost остаются нулевыми.

Что дальше