openclaude-LLM-local/docs/install-openclaude-cli.md

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

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

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

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

Проверка:

node -v
npm -v

Дальше:

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

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

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

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

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

Сайт проекта: https://ollama.com

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

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

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

macOS (Homebrew):

brew install --cask ollama

Windows: установщик с страницы загрузки или:

winget install Ollama.Ollama

Проверка CLI:

ollama --version

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

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

ollama pull qwen2.5-coder:7b

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

ollama run qwen2.5-coder:7b

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

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

macOS / Linux:

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:

$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):

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

4. OpenAI-профиль

macOS / Linux:

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

Windows PowerShell:

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

openclaude

5. DeepSeek-профиль

macOS / Linux:

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:

$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.