PTah
149 lines
4.1 KiB
Markdown
149 lines
4.1 KiB
Markdown
# Установка 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).
|