# Claude Code

Claude Code говорит по протоколу Anthropic Messages, а API моделей отвечает на нём по `POST /v1/messages`. Поэтому Claude Code нужны только наш адрес и ключ API моделей: больше ничего ставить не надо. Модель `auto` сама выбирает модель каталога для разговора.

Что нужно: Claude Code (версию показывает `claude --version`), ключ API моделей и деньги на [балансе организации](https://console.samreshuuu.ru).

## 1. Создайте ключ

В [консоли разработчика](https://console.samreshuuu.ru) откройте «Ключи API», оставьте в поле **Доступ** вариант **Ключ API моделей** и создайте ключ. Скопируйте его: секрет показывается один раз.

## 2. Задайте переменные

Claude Code читает объект `env` из `~/.claude/settings.json` (или из `settings.json` в папке, которую называет `CLAUDE_CONFIG_DIR`), и в терминале, и в расширениях IDE. Если файла нет, создайте его. Если в нём уже есть объект `env`, добавьте ключи в него, а не заменяйте его. Если ключ не хочется держать в файле, задайте те же переменные в профиле оболочки (`~/.zshrc`, `~/.bashrc`): это вкладка **Shell**.

**settings.json**

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.samreshuuu.ru",
    "ANTHROPIC_AUTH_TOKEN": "sk-org-your_api_key",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "auto",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "auto",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "auto",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "auto",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "auto",
    "CLAUDE_CODE_SUBAGENT_MODEL": "auto"
  }
}
```

**Shell**

```bash
export ANTHROPIC_BASE_URL="https://api.samreshuuu.ru"
export ANTHROPIC_AUTH_TOKEN="$SAMRESHUUU_API_KEY"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="auto"
export ANTHROPIC_DEFAULT_FABLE_MODEL="auto"
export ANTHROPIC_DEFAULT_OPUS_MODEL="auto"
export ANTHROPIC_DEFAULT_SONNET_MODEL="auto"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="auto"
export CLAUDE_CODE_SUBAGENT_MODEL="auto"
claude
```

| Переменная | Что делает |
| --- | --- |
| `ANTHROPIC_BASE_URL` | Направляет запросы Claude Code в API моделей. Адрес без `/v1`: Claude Code сам дописывает `/v1/messages`. |
| `ANTHROPIC_AUTH_TOKEN` | Ключ API моделей, уходит как `Authorization: Bearer`. |
| `ANTHROPIC_API_KEY` | Остаётся пустой. Эту переменную Claude Code шлёт как `x-api-key` и принимает за ключ самой Anthropic, поэтому настоящий ключ, оставшийся в оболочке, перебил бы токен. |
| `ANTHROPIC_MODEL` | Модель, с которой начинается сессия. |
| `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Модели уровней Claude Code: `/model opus`, режим плана и сабагент со своим уровнем просят уровень, а не `ANTHROPIC_MODEL`, а фоновые задачи идут в уровень Haiku. Без них такой вызов называет модель Anthropic, которой нет в каталоге, и получает `model_not_found`. |
| `CLAUDE_CODE_SUBAGENT_MODEL` | Модель сабагентов, которые не называют своего уровня. |

Если вы входили в Claude Code с аккаунтом Anthropic, один раз выполните `/logout` и запустите `claude` заново: сохранённый вход спорит с токеном.

## 3. Проверьте подключение

Запустите `claude` в папке проекта и выполните `/status`. Строка токена называет `ANTHROPIC_AUTH_TOKEN`, строка адреса называет `https://api.samreshuuu.ru`. Если вместо этого там аккаунт Anthropic или `ANTHROPIC_API_KEY`, переменные не дошли до сессии: перезагрузите оболочку или проверьте JSON в `settings.json`.

Отправьте запрос. Вызов появится в журнале вызовов [консоли](https://console.samreshuuu.ru) с моделью, которую выбрал `auto`, и его стоимостью.

## Модели

`auto` выбирает модель сам и держит её на весь разговор, чтобы работал кэш; как он выбирает, описано в [«Выбор модели auto»](/docs/model-api-routing#выбор-модели-auto). В любую переменную блока можно поставить id модели: со страницы [«Модели»](/models) или из `GET /v1/models`, например модель подешевле для уровня Haiku. На одну сессию модель называет `claude --model <id>` при запуске. Суффикс `[1m]` у имени модели, как его пишет руководство OpenRouter, отбрасывается до поиска модели.

Claude Code не знает окна `auto` и моделей каталога и держит разговор в том окне, которое предполагает, сжимая его по мере надобности. Если вы закрепили модель с окном меньше, задайте `CLAUDE_CODE_AUTO_COMPACT_WINDOW` равным её `context_length` из `GET /v1/models`.

## Рассуждения и усилие

Со сменённым адресом Claude Code принимает API моделей за API Anthropic и шлёт `thinking` и уровень `/effort` (`output_config.effort`) для любой модели. API читает их так же, как `reasoning` на проводе OpenAI: уровень, которого ответивший хост не принимает, приводится к ближайшему (см. [reasoning](/docs/model-api-requests#reasoning)), а модель, которая не рассуждает, отвечает без рассуждений.

## Кэш и стоимость

Claude Code шлёт заголовок `x-claude-code-session-id`: по нему вызовы одного сеанса попадают в один [кэш](/docs/model-api-routing#кэш-промпта). Строку атрибуции, которую Claude Code ставит первой в системный промпт, он меняет в каждом запросе, и мы убираем её до хоста, поэтому кэш она не ломает.

Каждый вызов оплачивается с баланса по цене хоста, который ответил, и ответ называет её в `usage.cost`. Claude Code это поле не читает: `/cost` показывает его собственную оценку по прайсу Anthropic, а не то, что списано с баланса. Списанное выводит в строку статуса скрипт из раздела ниже. Журнал вызовов [консоли](https://console.samreshuuu.ru) показывает каждый вызов сессии с моделью, хостом и стоимостью; из кода `GET /v1/generation?id=gen-…` отдаёт один вызов, `gen-…` берётся из заголовка `x-request-id` ответа (см. [«Ответ и стоимость»](/docs/model-api-anthropic#ответ-и-стоимость)).

## Стоимость в строке статуса

Строку статуса Claude Code рисует команда, которую вы назначите. Скрипт ниже берёт из журнала сессии id ответов, спрашивает о каждом новом `GET /v1/generation` и показывает модель, которую выбрал `auto`, хост и сумму, списанную с баланса за сессию: `glm-5.3 · deepinfra · 12,40 ₽`. Ключ и адрес он берёт из тех же `ANTHROPIC_BASE_URL` и `ANTHROPIC_AUTH_TOKEN`. Нужен Node.js 18 или новее.

Сохраните скрипт в `~/.claude/statusline-cost.mjs`:

```js
import { readFileSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";

const base = (process.env.ANTHROPIC_BASE_URL ?? "").replace(/\/+$/, "");
const token = process.env.ANTHROPIC_AUTH_TOKEN ?? "";
const perRefresh = 50;

function readState(path) {
  try {
    return JSON.parse(readFileSync(path, "utf8"));
  } catch {
    return { seen: [], kop: 0, model: "", host: "" };
  }
}

function callIds(transcriptPath) {
  let text = "";
  try {
    text = readFileSync(transcriptPath, "utf8");
  } catch {
    return [];
  }
  const ids = new Set();
  for (const line of text.split("\n")) {
    try {
      const id = JSON.parse(line)?.message?.id;
      if (typeof id === "string" && id.startsWith("msg_")) ids.add(`gen-${id.slice(4)}`);
    } catch {}
  }
  return [...ids];
}

async function generation(id) {
  try {
    const res = await fetch(`${base}/v1/generation?id=${id}`, {
      headers: { Authorization: `Bearer ${token}` },
    });
    return res.ok ? (await res.json()).data : null;
  } catch {
    return null;
  }
}

let input = "";
for await (const chunk of process.stdin) input += chunk;
const { session_id: sessionId, transcript_path: transcriptPath } = JSON.parse(input);

if (!base || !token) {
  process.stdout.write("ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN?");
} else {
  const statePath = join(tmpdir(), `claude-cost-${sessionId}.json`);
  const state = readState(statePath);
  const seen = new Set(state.seen);
  const fresh = callIds(transcriptPath).filter((id) => !seen.has(id));
  const batch = fresh.slice(0, perRefresh);
  const answers = await Promise.all(batch.map(generation));
  batch.forEach((id, i) => {
    const data = answers[i];
    if (!data) return;
    seen.add(id);
    state.kop += Math.round((data.total_cost ?? 0) * 100);
    state.model = data.model ?? state.model;
    state.host = data.provider_name ?? state.host;
  });
  state.seen = [...seen];
  writeFileSync(statePath, JSON.stringify(state));
  const rub = (state.kop / 100).toLocaleString("ru-RU", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
  const parts = [state.model, state.host, `${rub} ₽`].filter(Boolean);
  const pending = fresh.length - answers.filter(Boolean).length;
  process.stdout.write(parts.join(" · ") + (pending > 0 ? ` · +${pending}…` : ""));
}
```

Добавьте в `~/.claude/settings.json` рядом с `env`:

```json
{
  "statusLine": {
    "type": "command",
    "command": "node ~/.claude/statusline-cost.mjs"
  }
}
```

Строка обновляется после каждого ответа. Вызов, который ещё не попал в журнал, скрипт спросит при следующем обновлении, а пока показывает их число после суммы: `+1…`. Сумма сессии хранится во временной папке системы в файле `claude-cost-<id сессии>.json`, его можно удалить в любой момент. В `settings.json` бывает одна строка статуса, поэтому эта заменит вашу, если она была.

## Как отменить настройку

Уберите добавленные ключи из `env` в `settings.json` или строки `export` из профиля оболочки. Claude Code вернётся к вашему аккаунту Anthropic.

## Если что-то не так

| Что видно | Что проверить |
| --- | --- |
| Claude Code просит войти в Anthropic | `ANTHROPIC_BASE_URL` и `ANTHROPIC_AUTH_TOKEN` читаются не обе. Проверьте, что они в объекте `env` того файла, который загружает Claude Code, и что JSON корректен. |
| Предупреждение о конфликте входа при запуске | Сохранённый вход Anthropic или настоящий `ANTHROPIC_API_KEY`. Выполните `/logout`, оставьте `ANTHROPIC_API_KEY` пустой и перезапустите `claude`. |
| `401` | Ключ неверный или отозван. Проверьте его в «Ключах API» консоли. |
| `model_not_found` с моделью `claude-…` | Не задана одна из переменных `ANTHROPIC_DEFAULT_*_MODEL`: уровень попросил своё имя у Anthropic. Ошибка называет переменные; другая модель не подставляется. |
| `402` | Баланс не покрывает резерв вызова или исчерпан лимит расхода ключа. |

| HTTP | type | Код | message | Повтор |
| --- | --- | --- | --- | --- |
| 401 | `authentication_error` | `invalid_api_key` | The API key is unknown, disabled, revoked or expired. Switch a disabled key back on in the developer console; create a new one in place of a revoked or expired key. | нет |
| 404 | `not_found_error` | `model_not_found` | The model does not exist. GET /v1/models lists the models this API sells. | нет |
| 400 | `invalid_request_error` | `no_auto_model` | No model meets the request for auto. | нет |
| 402 | `billing_error` | `insufficient_balance` | The organization balance does not cover this request (max_tokens is held in full until the answer is settled). Top up the balance or lower max_tokens. | нет |
| 402 | `billing_error` | `key_limit_exceeded` | This API key has reached its spending limit. Raise the limit or use another key. | нет |

Если ошибка не проходит, напишите в поддержку и приложите `x-request-id` ответа.
