پرش به محتوا
Phase Console

نصب Pro

سه راه برای نصب Phase Console Pro روی یک دستگاه؛ هر سه با فعال شدن کلید پروانهٔ شما روی همان دستگاه تمام می‌شوند.

Phase Console Pro یک بسته است به نام phase-console-pro که روی npm و در یک tap از Homebrew منتشر شده است. آنچه Pro را باز می‌کند کلید پروانهٔ شماست، روی هر دستگاه جداگانه. در همهٔ فرمان‌های این صفحه، هر جا PCP-XXXX-XXXX-XXXX-XXXX آمده است، کلید خودتان را بگذارید: کلید در ایمیلی است که آن را برایتان آورد، و در صفحهٔ حساب شما هم هست.

پیش‌نیازها

  • یک Mac یا یک دستگاه Linux. در Windows، کنسول داخل WSL2 و با systemd روشن اجرا می‌شود؛ بخش «نصب روی Windows» را در پایان همین صفحه ببینید.
  • Node نسخهٔ 22.18 یا جدیدتر (یا 23.6 یا جدیدتر). اگر دستگاه Node نداشته باشد، یا نسخهٔ قدیمی‌تری داشته باشد، نصب‌کننده خودش آن را می‌آورد.
  • Claude Code؛ کنسول نشست‌هایش را با آن اجرا می‌کند.

یکی از مسیرها را انتخاب کنید

سه مسیر هست و هر سه با فعال شدن Pro روی همین دستگاه تمام می‌شوند. فقط یکی از آن‌ها را اجرا کنید.

با npm

بسته را نصب کنید:

npm install -g phase-console-pro

سپس کلیدتان را روی همین دستگاه فعال کنید:

phase-console license activate PCP-XXXX-XXXX-XXXX-XXXX

با Homebrew

این بسته در zsarir/tap منتشر شده است. آن را نصب کنید:

brew install zsarir/tap/phase-console-pro

سپس کلیدتان را روی همین دستگاه فعال کنید:

phase-console license activate PCP-XXXX-XXXX-XXXX-XXXX

با نصب‌کننده

یک خط همهٔ کار را انجام می‌دهد: Node را اگر نباشد نصب می‌کند، بسته را نصب می‌کند، کلیدتان را فعال می‌کند و عامل ورود را راه می‌اندازد. آن را در پوشهٔ پروژه‌ای اجرا کنید که برایش کنسول می‌خواهید؛ همان پوشه‌ای که docs/plans را در خود دارد.

در macOS و Linux و WSL2:

curl -fsSL https://phase-console-site.vercel.app/install.sh | bash -s -- --key PCP-XXXX-XXXX-XXXX-XXXX

در Windows، در PowerShell:

iwr -UseBasicParsing https://phase-console-site.vercel.app/install.ps1 -OutFile install.ps1; powershell -ExecutionPolicy Bypass -File .\install.ps1 --key PCP-XXXX-XXXX-XXXX-XXXX

نصب‌کننده چه می‌کند

چهار گام برمی‌دارد و هر گامی را که از پیش انجام شده باشد رد می‌کند:

  1. Node. اگر Node نسخهٔ 22.18 یا جدیدتر (یا 23.6 یا جدیدتر) در PATH نباشد، نسخهٔ رسمی را از nodejs.org می‌گیرد، آن را با چکیدهٔ منتشرشده‌اش می‌سنجد و در ~/.local/share/phase-console/node از حالت فشرده خارج می‌کند. سپس سطری را چاپ می‌کند که Node را برای پوسته‌های تازه به PATH می‌افزاید.
  2. بسته. فرمان npm install -g phase-console-pro@latest را اجرا می‌کند، یا نسخه‌ای را نصب می‌کند که --version نام ببرد.
  3. کلید شما. اگر --key داده شده باشد، phase-console license activate را با همان کلید اجرا می‌کند.
  4. عامل ورود. فرمان phase-console --install-agent را برای پروژه اجرا می‌کند؛ این عامل کنسول آن پروژه را هر بار که وارد سیستم می‌شوید راه می‌اندازد: یک عامل launchd در macOS و یک سرویس systemd --user در Linux و WSL2. پروژه همان پوشه‌ای است که نصب‌کننده را در آن اجرا کرده‌اید. اگر آن پوشه docs/plans نداشته باشد، یا کلیدی فعال نباشد، این گام رد می‌شود و فرمانی که بعداً باید اجرا کنید چاپ می‌شود؛ چون عامل ورود یکی از قابلیت‌های Pro است.

چند گزینه رفتار نصب‌کننده را تغییر می‌دهد:

  • --version X.Y.Z به‌جای آخرین نسخه، همان نسخه را نصب می‌کند.
  • --root <folder> پروژه‌ای را که عامل ورود به آن خدمت می‌کند نام می‌برد، به‌جای پوشه‌ای که در آن هستید.
  • --port N پورتی را که کنسول آن پروژه روی آن گوش می‌دهد ثابت می‌کند.
  • --minimal آن کنسول را بدون هیچ‌یک از گزینه‌های --allow-* راه می‌اندازد. به‌طور پیش‌فرض هر هفت گزینه روشن‌اند (--allow-writes، --allow-run و بقیه).
  • --no-agent نصب و فعال‌سازی را انجام می‌دهد و هیچ عامل ورودی راه نمی‌اندازد.
  • --dry-run چاپ می‌کند که هر گام چه خواهد کرد، و چیزی را تغییر نمی‌دهد.

استفاده در Claude Code

برای اینکه بستهٔ نصب‌شده افزونهٔ Claude Code هم باشد، با همان مهارت، اسکریپت‌ها و قلاب‌هایی که یک کلون از مخزن می‌دهد، این را اجرا کنید:

phase-console install-plugin

Claude Code دفعهٔ بعد که اجرا شود آن را برمی‌دارد، یا وقتی /reload-plugins را اجرا کنید.

به‌روزرسانی

با npm:

npm install -g phase-console-pro@latest

با Homebrew:

brew upgrade phase-console-pro

سپس هر کنسول را، از پوشهٔ پروژه‌اش، روی نسخهٔ تازه دوباره راه‌اندازی کنید:

phase-console restart

کنسولی که در میانهٔ یک اجراست راه‌اندازی دوباره را نمی‌پذیرد؛ phase-console restart --when-idle به‌جای آن صبر می‌کند تا نشست‌های زنده‌اش تمام شوند. کلید شما پس از به‌روزرسانی فعال می‌ماند و لازم نیست دوباره فعالش کنید. تا وقتی مدت پروانهٔ شما ادامه دارد، هر نسخهٔ تازه از آنِ شماست. پس از پایان آن، نسخه‌ای که بعد از آن منتشر شود به تمدید نیاز دارد: پرسش‌های رایج دربارهٔ Pro شرایط را توضیح می‌دهد.

نصب روی Windows

Phase Console روی macOS و Linux اجرا می‌شود. روی Windows، داخل WSL2 اجرا می‌شود: سطر مربوط به PowerShell در بالا نصب را به install.sh داخل WSL2 می‌سپارد، و آن اسکریپت بسته را همان‌جا نصب می‌کند، نه در خودِ Windows.

عامل ورود داخل WSL2 به systemd نیاز دارد. این دو سطر را به /etc/wsl.conf بیفزایید، wsl --shutdown را اجرا کنید و سپس نصب‌کننده را دوباره اجرا کنید:

[boot]
systemd=true

هر توزیع WSL2 یک دستگاه جداگانه به شمار می‌آید.