iclaude — Руководство пользователя

Версия: 4.0 | Дата: 2026-05

Что такое iclaude

iclaude — bash-обёртка для запуска Claude Code с расширенными возможностями: управлением прокси, изолированной средой, защитой персональных данных, поддержкой альтернативных LLM-провайдеров и мониторингом сессий.

Claude Code — официальный CLI от Anthropic для работы с ИИ-ассистентом напрямую из терминала. iclaude решает практические проблемы, которые возникают при его использовании в реальных условиях.

Какие проблемы решает

1. Корпоративная сеть и прокси

Claude Code не умеет работать через корпоративные HTTP/HTTPS прокси "из коробки". iclaude:

Сохраняет настройки прокси между сессиями
Поддерживает HTTPS-прокси с кастомными CA-сертификатами
Настраивает git-прокси синхронно с Claude Code

2. Изоляция от системного окружения

Системная установка Claude Code (npm install -g) конкурирует с другими глобальными npm-пакетами, требует sudo, не позволяет контролировать версию. iclaude:

Держит Claude Code в .nvm-isolated/ — полностью изолированном каталоге
Не требует системного npm или sudo для установки
Позволяет воспроизводить точную версию через lockfile

3. Утечка секретов и персональных данных

При работе с реальными проектами в контекст Claude Code попадают: API-ключи, пароли, JWT-токены, персональные данные клиентов. iclaude:

Блокирует доступ к файлам с секретами (.env, .pem, .key, .ssh/)
Автоматически маскирует секреты в аргументах инструментов до отправки в API
Опционально запускает NLP-прокси (Presidio) для маскирования PII в запросах

4. Стоимость API и альтернативные провайдеры

Anthropic API — дорого для фоновых агентов и массовой обработки. iclaude:

Интегрируется с Claude Code Router для маршрутизации запросов на DeepSeek, OpenRouter, Ollama и другие провайдеры
Позволяет запускать фоновые агенты через локальную Ollama (бесплатно)
Отображает стоимость сессии в реальном времени в статуслайне

5. Отсутствие видимости сессии

Нет способа видеть сколько токенов использовано, какая модель работает, есть ли кэш. iclaude:

Добавляет статуслайн с метриками: токены, кэш, стоимость, модель, git-ветка
Адаптирует отображение под ширину терминала
Показывает кликабельные ссылки на историю сессии и память проекта

6. Безопасность выполнения кода

Claude Code может читать, изменять и выполнять файлы с широкими правами. iclaude:

Предоставляет kernel-level изоляцию через Firecracker microVM
Разделяет конфигурацию каждого проекта через CLAUDE_CONFIG_DIR

Реализованные функции

Управление прокси

Флаг	Действие
`--proxy <url>`	Установить HTTP/HTTPS прокси
`--proxy-ca <file>`	Задать CA-сертификат для HTTPS (безопасно)
`--proxy-insecure`	Отключить проверку TLS (не рекомендуется)
`--no-proxy`	Запустить без прокси
`--test`	Проверить подключение через прокси
`--clear`	Очистить сохранённые credentials
`--restore-git-proxy`	Восстановить git-прокси из резервной копии

Настройки сохраняются в .claude_config (chmod 600, не попадает в git).

Поддерживаемые протоколы: HTTP, HTTPS. SOCKS5 не поддерживается — используйте Privoxy как переходник.

Изолированная среда (NVM)

Все компоненты Claude Code устанавливаются в .nvm-isolated/ — изолированный каталог внутри репозитория.

Флаг	Действие
`--isolated-install`	Первичная установка (без системного npm)
`--repair-isolated`	Восстановить симлинки после `git clone`
`--repair-plugins`	Починить пути плагинов после переноса проекта
`--check-isolated`	Статус изолированной среды и версия
`--isolated-update`	Обновить Claude Code (без sudo)
`--install-from-lockfile`	Установить точные версии из lockfile
`--create-symlink`	Создать глобальный симлинк `iclaude`
`--cleanup-isolated`	Удалить среду, сохранив lockfile

Порядок поиска бинарного файла Claude Code:

$npm_prefix/bin/claude (симлинк npm)
bin/claude.exe (нативный бинарник, v2.1.114+)
cli.js через node (legacy)

Безопасность: хуки PreToolUse

Двухуровневая защита активна всегда, без дополнительных настроек.

Слой 1 — block-secrets.py: блокирует доступ к файлам по пути (exit code 2).

Паттерн	Действие
`.env`, `.pem`, `.key`, `.p12`, `.pfx`	Заблокировано
`.ssh/`, `.gnupg/`	Заблокировано
`.env.example`, `.env.sample`	Разрешено (шаблоны)
`.claude-isolated/hooks/`	Разрешено (самоисключение)

Слой 2 — redact-secrets.py: маскирует содержимое через toolInputOverride.

Паттерн	Замена
`sk-ant-...`, `sk-proj-...`	`[ANTHROPIC_API_KEY]`
`AKIA{16}` (AWS)	`[AWS_ACCESS_KEY_ID]`
`ghp_`, `github_pat_`	`[GITHUB_TOKEN]`
`eyJ...` (JWT)	`[JWT_REDACTED]`
`scheme://[CREDENTIALS]@host`	`[CREDENTIALS_REDACTED]`
`.env` переменные (`KEY=значение{20+}`)	`[ENV_VAR_REDACTED]`
PEM приватные ключи	`[PRIVATE_KEY_REDACTED]`

Edit.old_string не маскируется — это поисковый паттерн, маскирование сломает инструмент Edit.

PII-прокси (Presidio NLP)

Локальный HTTP-прокси между Claude Code и Anthropic API. Перехватывает запросы и маскирует персональные данные с помощью Microsoft Presidio (NLP) и regex.

./iclaude.sh --install-pii-proxy   # Установка (Python venv + Presidio, ~587MB)
./iclaude.sh --pii-proxy           # Запустить с PII-маскированием

Уровни маскирования (задаются в .claude_config):

Уровень	Что делает
`standard`	Presidio NLP + regex (по умолчанию)
`secrets`	Только regex: ключи, токены, пароли
`off`	Трафик проходит насквозь (отладка)

В статуслайне при активном PII-прокси появляется иконка 🛡42 — счётчик замаскированных элементов.

Claude Code Router (альтернативные LLM)

Маршрутизирует запросы Claude Code на альтернативные LLM-провайдеры.

./iclaude.sh --install-router   # Установка CCR
./iclaude.sh --router           # Запуск через router
./iclaude.sh --check-router     # Статус

Поддерживаемые провайдеры: DeepSeek, OpenRouter, Ollama, Gemini, OpenAI, Volcengine, SiliconFlow.

Слоты маршрутизации (настраиваются в router.json):

Слот	Назначение
`default`	Основные запросы
`background`	Фоновые агенты (рекомендуется Ollama)
`think`	Plan Mode, reasoning-задачи
`longContext`	Запросы >60K токенов
`webSearch`	Запросы с веб-поиском

Динамическое переключение модели прямо в сессии: /model deepseek,deepseek-chat.

Статуслайн

Отображает метрики Claude Code в строке состояния терминала в реальном времени.

./iclaude.sh --install-statusline   # Установка
./iclaude.sh --install-posh         # Установка oh-my-posh (опционально)

Пример вывода (полный режим, ≥130 колонок):

💳 113K | 📊 51K (26%) | 📦 79K | Sonnet 4.5 | $1.06 🌐 | 🔀 deepseek | 🛡42 | ⛏ | 📄 | 🧠 | main +2

Компонент	Значение
`💳 113K`	Суммарные токены сессии (для биллинга)
`📊 51K (26%)`	Активный контекст (только новые токены, без кэша)
`📦 79K`	Токены в кэше (prompt cache)
`Sonnet 4.5`	Текущая модель
`$1.06`	Стоимость сессии
`🔀 deepseek`	Активный router-провайдер
`🛡42`	PII-прокси: 42 замаскированных элемента
`⛏`	Caveman активен. Счётчик сэкономленных токенов (`⛏ 5.2k`) появляется только после ручного вызова `/caveman-stats`
`📄`	Ссылка на читаемую историю сессии
`🧠`	Ссылка на MEMORY.md проекта
`main +2`	Git-ветка и количество незафиксированных изменений

Адаптивные режимы:

Полный (≥130 колонок): все компоненты
Компактный (110–129): сокращения, скрыт router/git
Минимальный (<110): только токены, модель, стоимость

microVM-изоляция (Firecracker)

Запуск Claude Code внутри изолированной виртуальной машины Firecracker с отдельным Linux-ядром.

./iclaude.sh --install-microvm    # Установка (~1.4 GB)
./iclaude.sh --sandbox-microvm    # Запуск с kernel-изоляцией

Уровни изоляции:

Уровень	Механизм	Активен
Security hooks	block-secrets.py + redact-secrets.py	Всегда
Config isolation	CLAUDE_CONFIG_DIR в `.nvm-isolated/`	Всегда
microVM	Firecracker KVM (отдельный Linux kernel)	`--sandbox-microvm`

OAuth и токены

./iclaude.sh --refresh-token   # Обновить OAuth-токен (~1 год lifetime)

Токен сохраняется в CLAUDE_CONFIG_DIR и автоматически используется при запуске.

Chrome-интеграция

Автоматизация браузерных задач через расширение "Claude in Chrome".

./iclaude.sh --chrome      # Включить Chrome-интеграцию
./iclaude.sh --no-chrome   # Отключить явно

Требования: Google Chrome, расширение v1.0.36+, Claude Code CLI v2.0.73+, платный план.

По умолчанию отключена — включение без выполненных требований вызывает ошибки при старте.

Управление конфигурацией

./iclaude.sh --check-config          # Статус конфигурации
./iclaude.sh --export-config <path>  # Резервная копия
./iclaude.sh --import-config <path>  # Восстановление
./iclaude.sh --isolated-config       # Использовать изолированный конфиг
./iclaude.sh --shared-config         # Использовать системный ~/.claude/

Ключевые переменные (в .claude_config):

Переменная	По умолчанию	Описание
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	32000	Лимит output-токенов (макс. 128000)
`CLAUDE_CODE_ENABLE_TASKS`	true	Tasks-система
`CLAUDE_CODE_NO_CHROME`	false	Отключить Chrome
`CLAUDE_CODE_MODEL`	claude-4-5-sonnet	Модель

Граф знаний проекта (Graphify)

Строит knowledge graph по исходному коду и документации через graphifyy. Используется skill /graphify для архитектурных запросов и автоматически подтягивается в superpowers:brainstorming.

./iclaude.sh --install-graphify    # Установка (uv + graphifyy + skill, ~250MB)
./iclaude.sh --graphify            # Перестроить граф перед запуском Claude Code
./iclaude.sh --check-graphify      # Статус: версии, пути, размер

Конфигурация (.claude_config):

Переменная	По умолчанию	Описание
`GRAPHIFY_OUT`	`graphify-out`	Имя выходного каталога графа
`GRAPHIFY_EXTRA_ARGS`	(пусто)	Доп. флаги `graphify update`, например `--no-video`

Изоляция: uv и Python 3.12 в .nvm-isolated/.claude-isolated/graphify/. Четыре idempotent-патча (lib/graphify/patches/) делают пути в манифесте относительными — граф переносится между машинами через git.

Подробнее: docs/functions/GRAPHIFY.md.

Сжатие токенов (Caveman)

Сокращает использование output-токенов на ~65–75% через caveman — компрессивный стиль ответов модели (drop articles/filler/pleasantries). Не затрагивает код, коммиты, security warnings, error quotes.

./iclaude.sh --install-caveman      # Скачать 4 хука + патчить settings.json
./iclaude.sh --check-caveman        # Статус: установка, версия, режим
./iclaude.sh --uninstall-caveman    # Удалить

Конфигурация (.claude_config):

Переменная	По умолчанию	Описание
`CAVEMAN_DEFAULT_MODE`	`full`	`off` / `lite` / `full` / `ultra` / `wenyan-*` / `commit` / `review` / `compress`
`CAVEMAN_STATUSLINE`	`false`	Badge экономии токенов в статусной строке

В сессии: /caveman lite|full|ultra для переключения, stop caveman для выхода.

Изоляция: хуки ставятся только в $CLAUDE_CONFIG_DIR/hooks/ — ~/.claude/ не затрагивается.

Подробнее: docs/functions/CAVEMAN.md.

Обновление и диагностика

./iclaude.sh --update           # Обновить Claude Code
./iclaude.sh --check-update     # Проверить доступные обновления
./iclaude.sh --check-isolated   # Статус изолированной среды
./iclaude.sh --check-router     # Статус Claude Code Router
./iclaude.sh --check-statusline # Статус статуслайна

Быстрый старт

Первая установка

git clone <repo>
cd iclaude

# Починить симлинки после clone
./iclaude.sh --repair-isolated

# Настроить прокси (если нужно)
./iclaude.sh --proxy https://proxy.example.com:8118

# Проверить подключение
./iclaude.sh --test

# Запустить
./iclaude.sh

Запуск с альтернативным провайдером (DeepSeek + Ollama)

# Установить router
./iclaude.sh --install-router

# Добавить ключ в .claude_config
echo "export DEEPSEEK_API_KEY=sk-..." >> .claude_config

# Запустить через router
./iclaude.sh --router

Запуск с максимальной защитой данных

# Установить PII-прокси
./iclaude.sh --install-pii-proxy

# Запустить с PII-маскированием и microVM
./iclaude.sh --pii-proxy --sandbox-microvm

Архитектура

iclaude.sh
├── lib/core/        — инициализация, глобальные переменные
├── lib/command/     — разбор аргументов, справка
├── lib/proxy/       — HTTP/HTTPS прокси
├── lib/nvm/         — изолированная NVM-среда
├── lib/oauth/       — OAuth-токены
├── lib/router/      — Claude Code Router
├── lib/pii-proxy/   — PII NLP-прокси (Presidio)
├── lib/sandbox/     — Firecracker microVM
├── lib/statusline/  — метрики в статуслайне
├── lib/launcher/    — запуск Claude Code (финальный вызов)
└── lib/graphify/    — граф знаний проекта

Хуки безопасности: .nvm-isolated/.claude-isolated/hooks/ Скрипты статуслайна: .nvm-isolated/.claude-isolated/scripts/

Документация по разделам

Тема	Файл
Прокси	`docs/functions/PROXY.md`
Router и провайдеры	`docs/functions/ROUTER.md`
PII-маскирование	`docs/functions/PII_MASKING.md`
Статуслайн	`docs/functions/STATUSLINE.md`
microVM	`docs/functions/MICROVM.md`
Граф знаний (Graphify)	`docs/functions/GRAPHIFY.md`
Сжатие токенов (Caveman)	`docs/functions/CAVEMAN.md`
Все команды	`docs/functions/CONFIGURATION.md`
Примеры сценариев	`docs/functions/USE_CASES.md`
Телеметрия	`docs/functions/TELEMETRY.md`

Name		Name	Last commit message	Last commit date
Latest commit History 1,066 Commits
.githooks		.githooks
.github		.github
.graphify		.graphify
.nvm-isolated		.nvm-isolated
.wiki		.wiki
docs		docs
lib		lib
scripts		scripts
tests		tests
.claude_config.example		.claude_config.example
.gitattributes		.gitattributes
.gitignore		.gitignore
.graphifyignore		.graphifyignore
.graphifyinclude		.graphifyinclude
.nvm-isolated-lockfile.json		.nvm-isolated-lockfile.json
CLAUDE.md		CLAUDE.md
README.md		README.md
iclaude.sh		iclaude.sh

Folders and files

Latest commit

History

Repository files navigation

iclaude — Руководство пользователя

Что такое iclaude

Какие проблемы решает

1. Корпоративная сеть и прокси

2. Изоляция от системного окружения

3. Утечка секретов и персональных данных

4. Стоимость API и альтернативные провайдеры

5. Отсутствие видимости сессии

6. Безопасность выполнения кода

Реализованные функции

Управление прокси

Изолированная среда (NVM)

Безопасность: хуки PreToolUse

PII-прокси (Presidio NLP)

Claude Code Router (альтернативные LLM)

Статуслайн

microVM-изоляция (Firecracker)

OAuth и токены

Chrome-интеграция

Управление конфигурацией

Граф знаний проекта (Graphify)

Сжатие токенов (Caveman)

Обновление и диагностика

Быстрый старт

Первая установка

Запуск с альтернативным провайдером (DeepSeek + Ollama)

Запуск с максимальной защитой данных

Архитектура

Документация по разделам

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages