> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusapi.link/llms.txt
> Use this file to discover all available pages before exploring further.

# Настройка Claude Code

> Установите Claude Code и подключите его к NexusAPI через нативную конфигурацию Anthropic.

Claude Code использует нативный Anthropic Messages. Base URL NexusAPI — `https://nexusapi.link`; **не добавляйте `/v1`**.

## 1. Установка Claude Code

Используйте официальный установщик:

```bash theme={"system"}
curl -fsSL https://claude.ai/install.sh | bash
```

```powershell theme={"system"}
irm https://claude.ai/install.ps1 | iex
```

Также доступны `winget install Anthropic.ClaudeCode` для Windows и `brew install --cask claude-code` для macOS. Проверьте установку:

```bash theme={"system"}
claude --version
claude doctor
```

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

В **Управлении токенами → Добавить токен** выберите группу с нужной моделью Claude и задайте лимит. Не судите по одному названию модели: проверьте каталог или [матрицу возможностей](/ru/developer/capability-matrix).

## 3. Создайте пользовательскую конфигурацию

| Система             | Путь                                    |
| ------------------- | --------------------------------------- |
| macOS / Linux / WSL | `~/.claude/settings.json`               |
| Windows             | `%USERPROFILE%\\.claude\\settings.json` |

macOS, Linux, WSL и Git Bash:

```bash theme={"system"}
mkdir -p ~/.claude
touch ~/.claude/settings.json
```

Объедините эти значения с существующим `env`, не затирая MCP и разрешения:

```json theme={"system"}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_NEXUSAPI_KEY",
    "ANTHROPIC_BASE_URL": "https://nexusapi.link"
  }
}
```

Сохраняйте это в каталоге пользователя, а не в репозитории проекта.

## 4. Запуск и проверка

Откройте новый терминал, запустите `claude`, затем выполните `/status`. Убедитесь, что **Anthropic base URL** — `https://nexusapi.link`, и отправьте короткий вопрос.

## Частые проблемы

### `Invalid API Key · Please run /login`

Проверьте обе переменные, состояние ключа и перезапуск терминала. Не исправляйте это прямым редактированием внутренних файлов состояния входа Claude.

### `fetch failed`

1. Отправьте обычный короткий запрос. Если он работает, проблема, вероятно, в WebFetch или другой отдельной сетевой функции.
2. Если не работает ни один вызов модели, выполните `claude doctor` и проверьте Base URL через `/status`.
3. Проверьте DNS, firewall, корпоративную сеть или доверенный прокси для `nexusapi.link`.
4. Откройте новый терминал и проверьте один раз. При постоянной ошибке сохраните версию, вывод doctor, текст ошибки и Request ID, затем пройдите [самопроверку](/ru/faq/self-check).

### Статус `offline`

Вспомогательные функции могут проверять отдельные сервисы. Подтвердите реальный вызов через `/status` и короткий запрос к модели, прежде чем считать gateway недоступным.

* [Официальная установка](https://code.claude.com/docs/en/installation)
* [Переменные окружения](https://code.claude.com/docs/en/env-vars)
* [Настройка gateway](https://code.claude.com/docs/en/llm-gateway)