diff --git a/README.md b/README.md
index d265e3a..64534f5 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,7 @@
 
 ```
 .
+├── install-apaw.sh                         # Установщик в любой проект (bash)
 ├── .claude/                                # Claude Code runtime
 │   ├── commands/                           # 13 slash-команд (/project:*)
 │   │   ├── pipeline.md                     # Полный цикл одной командой
@@ -164,18 +165,35 @@
 
 ### Вариант A: Claude Code (рекомендуется)
 
+#### Глобальная установка — команды работают во ВСЕХ проектах
+
 ```bash
 git clone https://git.softuniq.eu/UniqueSoft/APAW.git
-cp -r APAW/.claude /your-project/
+mkdir -p ~/.claude/commands ~/.claude/rules
+cp APAW/.claude/commands/*.md ~/.claude/commands/
+cp APAW/.claude/rules/global.md ~/.claude/rules/
+# Заменить /project: на /user: во внутренних ссылках:
+sed -i 's|/project:|/user:|g' ~/.claude/commands/*.md
 ```
 
-Откройте проект в VS Code с расширением **Claude Code**. Все команды доступны сразу через `/project:*`.
+После этого в **любом проекте** доступны команды `/user:pipeline`, `/user:refine` и т.д.
+
+#### Установка в конкретный проект
+
+```bash
+git clone https://git.softuniq.eu/UniqueSoft/APAW.git
+./APAW/install-apaw.sh /path/to/your-project
+```
+
+Скрипт создаёт `.claude/` в целевом проекте. Команды доступны как `/project:*`.
 
 #### Быстрый старт
 
 ```
 # Полный цикл от идеи до релиза:
 /project:pipeline добавить эндпоинт авторизации через JWT
+# или глобально (после глобальной установки):
+/user:pipeline добавить эндпоинт авторизации через JWT
 
 # Или пошагово:
 /project:refine хочу кнопку экспорта в PDF
diff --git a/install-apaw.sh b/install-apaw.sh
new file mode 100755
index 0000000..76a0773
--- /dev/null
+++ b/install-apaw.sh
@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# APAW — Claude Code Agent Pipeline Installer
+#
+# Usage:
+#   ./install-apaw.sh                  # install in current directory
+#   ./install-apaw.sh /path/to/project # install in target project
+#
+# After install, use /project:pipeline <task> in Claude Code
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TARGET="${1:-.}"
+
+if [ ! -d "$TARGET" ]; then
+  echo "Error: target directory '$TARGET' does not exist"
+  exit 1
+fi
+
+echo "Installing APAW Claude Code pipeline into: $TARGET"
+
+mkdir -p "$TARGET/.claude/commands"
+mkdir -p "$TARGET/.claude/rules"
+mkdir -p "$TARGET/.claude/logs"
+
+cp "$SCRIPT_DIR/.claude/commands/"*.md "$TARGET/.claude/commands/"
+cp "$SCRIPT_DIR/.claude/rules/global.md" "$TARGET/.claude/rules/"
+
+if [ ! -f "$TARGET/.claude/logs/efficiency_score.json" ]; then
+  echo '[]' > "$TARGET/.claude/logs/efficiency_score.json"
+fi
+
+echo ""
+echo "Done. 14 agent commands installed."
+echo ""
+echo "Quick start in Claude Code:"
+echo "  /project:pipeline <describe your task>"
+echo ""
+echo "Or step by step:"
+echo "  /project:refine <vague idea>    — clarify requirements"
+echo "  /project:mine <topic>           — check git history for duplicates"
+echo "  /project:analyze <feature>      — design system (Opus)"
+echo "  /project:tests <feature>        — write failing tests (TDD red)"
+echo "  /project:implement <feature>    — write code (TDD green, Opus)"
+echo "  /project:skeptic <feature>      — adversarial code review"
+echo "  /project:perf <feature>         — performance check"
+echo "  /project:security <feature>     — OWASP audit (Opus)"
+echo "  /project:release <version>      — tag and publish"
+echo "  /project:evaluate <task>        — score agents (Haiku)"