# Claude Code с OpenCheese

> Подключите Claude Code к ИИ-шлюзу OpenCheese: ANTHROPIC_BASE_URL, API-ключ, псевдонимы моделей opus, sonnet, haiku и fable, settings.json и решение проблем.
>
> Веб-страница: https://opencheese.dev/ru/docs/claude-code/ · Все страницы документации: https://opencheese.dev/ru/docs.md

Claude Code работает с Anthropic Messages API, который OpenCheese предоставляет по адресу
`https://api.opencheese.dev`. Укажите этот адрес и API-ключ OpenCheese, и Claude Code будет
работать на моделях, включённых для вашего аккаунта.

## Самый быстрый способ: сгенерированный файл

Войдите в аккаунт, откройте страницу **Настройка**, перейдите на вкладку **Claude Code** с
выбранным вариантом **Claude Code (CLI)**, выберите API-ключ и подтвердите пароль. Скопируйте
сгенерированный `settings.json` и объедините его блок `env` со своими пользовательскими настройками:

| Система | Файл |
| --- | --- |
| macOS и Linux | `~/.claude/settings.json` |
| Windows | `%USERPROFILE%\.claude\settings.json` |

Сгенерированный файл закрепляет за псевдонимами моделей Claude Code (`opus`, `sonnet`, `haiku` и
`fable`) самые новые модели Claude из вашего тарифа, поэтому `/model opus` и остальные псевдонимы
указывают на модели, доступные вам. Семейство моделей, которого нет в вашем тарифе, в файл не
попадает.

## Ручная настройка

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.opencheese.dev",
    "ANTHROPIC_API_KEY": "YOUR_OPENCHEESE_API_KEY",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "OPUS_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "SONNET_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "HAIKU_MODEL_ID",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "FABLE_MODEL_ID"
  }
}
```

- `ANTHROPIC_BASE_URL` не должен заканчиваться на `/v1`: Claude Code сам добавляет `/v1/messages`.
- ID моделей возьмите из ответа `GET /v1/models` с вашим ключом (см. [Модели](https://opencheese.dev/ru/docs/models.md)).
- Объедините эти ключи с уже существующим файлом, чтобы сохранить свои разрешения, хуки и
  настройки MCP.
- Храните всё это в пользовательских настройках. Файл `.claude/settings.json`, добавленный в
  репозиторий, открывает ваш API-ключ всем, у кого есть доступ к этому репозиторию.

## Смена модели

В Claude Code используйте `/model` с псевдонимом, например `opus`, `sonnet`, `haiku` или `fable`;
каждый из них указывает на модель, закреплённую в ваших настройках. Claude Code перечитывает
`settings.json` во время работы, но сопоставление псевдонимов читает только при запуске,
поэтому после изменения псевдонима перезапустите его.

Уровень рассуждений, выбранный в Claude Code, отправляется с каждым запросом. Если модель не
поддерживает этот уровень, запрос отклоняется с сообщением, в котором перечислены доступные ей
уровни.

## В VS Code, Cursor и IDE JetBrains

Расширение Claude Code для VS Code и Cursor, а также плагин для JetBrains используют тот же
`~/.claude/settings.json`, поэтому описанная выше настройка подходит и для них. См.
[VS Code и JetBrains](https://opencheese.dev/ru/docs/ide.md).

## Claude Desktop

На той же вкладке **Claude Code** есть переключатель **Claude Desktop**. Claude Desktop использует
файл, который нужно скачать и импортировать в самом приложении; см.
[Claude Desktop](https://opencheese.dev/ru/docs/claude-desktop.md).

## Расход и стоимость

Каждый запрос отображается в панели на странице **Транзакции** с расходом токенов и
стоимостью; запросы одного разговора объединены в одну сессию.

## Решение проблем

- **«Invalid or disabled OpenCheese API key»**: ключ отозван, отключён или скопирован не
  полностью. Проверьте его на странице **API-ключи** и сгенерируйте конфигурацию заново.
- **Вместо API отвечает сайт**: базовый URL должен быть `https://api.opencheese.dev`, а не
  `https://opencheese.dev`.
- **Запросы не проходят из-за удвоенного пути**: с базовым URL, который заканчивается на `/v1`,
  Claude Code обращается к `/v1/v1/messages`. Уберите `/v1`.
- **«Not included in your current plan»**: модель не входит в ваш тариф. Выберите другую модель
  или оставьте включённым переключатель **Использовать модели за баланс** на странице
  **Обзор**, чтобы оплачивать её с баланса.