docs: split handbook into docs/ by topic, slim root README, add docs index

Made-with: Cursor

docs/install-openclaude-cli.md

@@ -0,0 +1,148 @@
+# Установка 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).