# Установка OpenClaude: предусловия, Ollama, профили провайдеров

Пошагово: Node/npm → CLI → (для локальных моделей) Ollama → переменные окружения для выбранного провайдера.

## 0. Предусловия

Нужны **Node.js 18+** и **npm** (входят в официальную установку Node).

Проверка:

```bash
node -v
npm -v
```

Дальше:

1. установить **OpenClaude CLI** (ниже);
2. для **локальных** моделей через Ollama — установить и запустить **Ollama**, затем локальный профиль;
3. для облака (OpenAI / DeepSeek) достаточно ключей API — см. профили ниже.

Если при запуске OpenClaude появится предупреждение вроде `ripgrep not found`, установите **ripgrep** (`rg`) и проверьте `rg --version` в том же терминале.

## 1. Установка OpenClaude

```bash
npm install -g @gitlawb/openclaude
openclaude --version
```

## 2. Установка и запуск Ollama (для локального профиля)

Сайт проекта: [https://ollama.com](https://ollama.com)

**Linux** (типовой скрипт установки):

```bash
curl -fsSL https://ollama.com/install.sh | sh
```

После установки сервис часто уже включён (`systemctl status ollama`). При необходимости: `sudo systemctl enable --now ollama`.

**macOS** (Homebrew):

```bash
brew install --cask ollama
```

**Windows**: установщик с [страницы загрузки](https://ollama.com/download) или:

```powershell
winget install Ollama.Ollama
```

Проверка CLI:

```bash
ollama --version
```

Убедитесь, что API доступен на `http://127.0.0.1:11434` (на Windows приложение после установки обычно уже поднимает сервер; при сомнении запустите `ollama serve` в отдельном окне терминала).

Скачайте хотя бы одну модель для работы с OpenClaude (пример ниже совпадает с локальным профилем):

```bash
ollama pull qwen2.5-coder:7b
```

Быстрая проверка генерации:

```bash
ollama run qwen2.5-coder:7b
```

Подробнее про выбор и обслуживание моделей: [local-llm-ollama.md](local-llm-ollama.md).

## 3. Локальный Ollama-профиль (бесплатно)

macOS / Linux:

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=http://127.0.0.1:11434/v1
export OPENAI_MODEL=qwen2.5-coder:7b
openclaude
```

Windows PowerShell:

```powershell
$env:CLAUDE_CODE_USE_OPENAI="1"
$env:OPENAI_BASE_URL="http://127.0.0.1:11434/v1"
$env:OPENAI_MODEL="qwen2.5-coder:7b"

openclaude
```

Альтернатива без ручных переменных (если установлен Ollama и доступна команда `ollama launch`):

```bash
ollama launch openclaude --model qwen2.5-coder:7b
```

## 4. OpenAI-профиль

macOS / Linux:

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-...
export OPENAI_MODEL=gpt-4o
openclaude
```

Windows PowerShell:

```powershell
$env:CLAUDE_CODE_USE_OPENAI="1"
$env:OPENAI_API_KEY="sk-..."
$env:OPENAI_MODEL="gpt-4o"

openclaude
```

## 5. DeepSeek-профиль

macOS / Linux:

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=https://api.deepseek.com/v1
export OPENAI_API_KEY=sk-...
export OPENAI_MODEL=deepseek-chat
openclaude
```

Windows PowerShell:

```powershell
$env:CLAUDE_CODE_USE_OPENAI="1"
$env:OPENAI_BASE_URL="https://api.deepseek.com/v1"
$env:OPENAI_API_KEY="sk-..."
$env:OPENAI_MODEL="deepseek-chat"

openclaude
```

Дальше: закрепить профили на диске и автоподстановку в проектах — [configure-profiles-direnv.md](configure-profiles-direnv.md).