Pi’ni o‘rnatish murakkab emas, buning uchun bitta buyruq kifoya. Avval hal qilinishi kerak bo‘lgan yagona masala — autentifikatsiya usuli: mavjud obunadan foydalanasizmi yoki API Key ishlatasizmi. Quyida o‘rnatish, autentifikatsiya va ilk suhbatni birgalikda ko‘rib chiqamiz.
Asosiy tushuncha: autentifikatsiyaning ikki usuli
Pi o‘rnatilgach, ishlashi uchun ma’lum bir LLM xizmat provayderining hisob ma’lumotlari kerak bo‘ladi. Autentifikatsiyaning ikki yo‘li bor, ushbu maqolada tushunish kerak bo‘lgan asosiy farq ham shu:
Obuna orqali kirish (/login)｜API Key
Nimadan foydalaniladi｜Claude Pro/Max, ChatGPT Plus/Pro kabi obunalar｜Xizmat provayderi bergan API Key
To‘lov｜Murakkab (obuna limiti + ehtimoliy qo‘shimcha foydalanish)｜Token bo‘yicha, qancha ishlatsangiz shuncha to‘laysiz
Hisob ma’lumotlari qayerda saqlanadi｜~/.pi/agent/auth.json (OAuth token, avtomatik yangilanadi)｜Atrof-muhit o‘zgaruvchisi yoki auth.json
Kimlar uchun mos｜Mavjud obunasi bor va Key’ni alohida boshqarishni istamaydiganlar｜Xarajatlarni aniq nazorat qilmoqchi bo‘lganlar
Bir eslatma: Anthropic obunasi orqali kirish (Claude Pro/Max) uchinchi tomon harness kanali orqali ishlaydi va token bo‘yicha hisoblanadi; obuna paketidagi limit sarflanmaydi. Pi ogohlantirish ko‘rsatadi — bu odatiy holat. Xarajatlarni to‘liq nazorat qilish va istalgan vaqtda qancha sarflanganini ko‘rish uchun API Key qulayroq.
Amaliyot
1. Pi’ni o‘rnatish
Pi Node.js’da ishlaydi, 22.19.0 yoki undan yuqori versiya talab qilinadi. Avval node --version buyrug‘i bilan tekshiring. Quyidagi ikki usuldan birini tanlang:
# npm orqali global o‘rnatish (--ignore-scripts bog‘liqlik skriptlarini o‘tkazib yuboradi, xavfsizroq)
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
# yoki curl o‘rnatuvchisidan foydalanish (Node o‘rnatilmagan bo‘lsa, uni ham o‘rnatadi)
curl -fsSL https://pi.dev/install.sh | shO‘rnatilgach, pi --version bilan tekshiring. O‘chirish uchun npm uninstall -g @earendil-works/pi-coding-agent buyrug‘idan foydalaning.
2. Autentifikatsiyani sozlash
Birinchi yo‘l: API Key (tavsiya etiladi). Key’ni atrof-muhit o‘zgaruvchisi sifatida belgilang:
export ANTHROPIC_API_KEY=sk-ant-...
piYoki pi ichida /login buyrug‘i orqali API Key provider’lardan birini tanlab, Key’ni ~/.pi/agent/auth.json fayliga saqlang (0600 huquqlari, faqat o‘zingiz o‘qishingiz va yozishingiz mumkin). Ko‘p ishlatiladigan xizmat provayderlarining atrof-muhit o‘zgaruvchilari:
Provayder｜Atrof-muhit o‘zgaruvchisi
Anthropic｜ANTHROPIC_API_KEY
OpenAI｜OPENAI_API_KEY
DeepSeek｜DEEPSEEK_API_KEY
Google Gemini｜GEMINI_API_KEY
Groq｜GROQ_API_KEY
xAI｜XAI_API_KEY
OpenRouter｜OPENROUTER_API_KEY
To‘liq ro‘yxatda o‘nlab provayderlar bor, rasmiy Providers hujjatiga qarang[1].
Ikkinchi yo‘l: obuna orqali kirish. Claude Pro yoki ChatGPT Plus kabi obunangiz bo‘lsa, pi ichida /login buyrug‘i orqali mos provider’ni tanlang va OAuth jarayonidan o‘ting. Token muddati tugaganda pi uni avtomatik yangilaydi. Mavjud variantlar: Claude Pro/Max, ChatGPT Plus/Pro(Codex), GitHub Copilot, xAI, OpenRouter. Chiqish uchun /logout buyrug‘idan foydalaning.
Pi hamjamiyati juda faol. Pi Agent’ning so‘nggi versiyasi Qianwen token plan’ini ham qo‘llab-quvvatlaydi.
Model sozlangach, foydalanmoqchi bo‘lgan modelingizni /model buyrug‘i orqali tanlashingiz mumkin.
Pi Agent’da scoped models tushunchasi ham mavjud.
scoped models foydalanuvchiga bir nechta model o‘rtasida ctrl + p orqali tez almashish imkonini beradi. Shuningdek, ctrl + l dan foydalanib tanlash mumkin. Tegishli sozlama ~/.pi/agent/settings.json faylining enabledModels maydonida joylashgan.
3. Birinchi ishga tushirish
Loyiha katalogiga kirib ishga tushiring:
cd /path/to/your/project
piBirinchi marta .pi/ sozlamalariga ega loyiha ichiga kirganingizda, pi ishonch so‘raydi — loyiha darajasidagi resurslarda istalgan kodni bajarishi mumkin bo‘lgan kengaytmalar bo‘lishi mumkin. Pi ularni sizdan yashirincha yuklamaydi. Ishonch qarori ~/.pi/agent/trust.json fayliga yoziladi va keyingi safar so‘ralmaydi.
Interfeys yuqoridan pastga to‘rtta qismdan iborat: Header (klaviatura yorliqlari/yuklangan resurslar), Messages, Editor (matn kiritiladigan joy, chegara rangi fikrlash darajasini bildiradi), Footer (katalog/sessiya/token sarfi/xarajat/joriy model). To‘g‘ridan-to‘g‘ri matn kiriting va Enter bosing, masalan:
Ushbu repository tuzilmasini ko‘rib chiqing va tekshiruvni qanday ishga tushirishni ayting.Pi sukut bo‘yicha modelga to‘rtta vosita beradi: read, write, edit, bash. Qolgan uchta faqat o‘qish uchun mo‘ljallangan vosita grep/find/ls sukut bo‘yicha o‘chirilgan. Zarur bo‘lsa, ularni --tools orqali yoqing. Masalan, pi’dan faqat o‘qish rejimida kodni ko‘rib chiqishni so‘rash:
pi --tools read,grep,find,ls -p "Ushbu repository kod sifatini ko‘rib chiqing"Modelni Ctrl+L yoki /model orqali almashtiring; chiqish uchun Ctrl+C tugmasini ikki marta bosing yoki /quit dan foydalaning; oldingi suhbatni davom ettirish uchun pi -c ni ishlating.
Prinsipni tushunish
Autentifikatsiyani aniqlash tartibi: atrof-muhit o‘zgaruvchisi, auth.json va buyruq qatori parametrlari bir vaqtda sozlangan bo‘lsa, pi quyidagi ustuvorlik bo‘yicha foydalanadi: buyruq qatori --api-key > auth.json > atrof-muhit o‘zgaruvchisi > models.json. Key’ni vaqtincha almashtirib sinash uchun konfiguratsiya faylini o‘zgartirmasdan pi --api-key xxx buyrug‘idan foydalaning.
Loyiha ishonchi kirish himoyasi, sandbox emas: u faqat interaktiv ishga tushirishda oynani ko‘rsatadi. Interaktiv bo‘lmagan rejimda (pi -p) sukut bo‘yicha ask ishlatiladi, buni -a/-na orqali almashtirish mumkin. Pi sukut bo‘yicha sandbox’dan foydalanmaydi. Model bash’ga ega bo‘lsa, istalgan buyruqni bajarishi mumkin. Ishonchsiz repository’lar bilan ishlaganda konteyner izolyatsiyasidan foydalanish kerak; bu keyingi xavfsizlik maqolasining mavzusi.
Ko‘p uchraydigan savollar
S:pi --version command not found xatosini beradi, ammo npm o‘rnatilganini aytadi.
Ehtimol, npm’ning global bin katalogi PATH’da yo‘q. Yo‘lni npm prefix -g orqali ko‘rib, PATH’ga qo‘shing. nvm foydalanuvchilari nvm use buyrug‘ini esdan chiqarmasin.
S: Ishga tushirishda Node versiyasi juda eski ekanligi haqida xato chiqadi.
Pi uchun Node 22.19.0+ kerak. Versiya menejeri (fnm/mise/nvm) orqali yangilang yoki curl o‘rnatuvchisidan foydalaning.
S: Claude Pro orqali kirgandan keyin har safar qo‘shimcha foydalanish ogohlantirishi chiqadi.
Anthropic obunasi uchinchi tomon kanali orqali token bo‘yicha hisoblanadi. Uni o‘chirish uchun ~/.pi/agent/settings.json fayliga quyidagini qo‘shing:
{ "warnings": { "anthropicExtraUsage":false } }S: Shift+Enter bilan yangi qatorga o‘tib bo‘lmayapti.
Pi modifikator tugmalarini aniqlash uchun Kitty klaviatura protokolidan foydalanadi. iTerm2, Kitty va Ghostty’da qo‘shimcha sozlama kerak emas; VS Code 1.109.5+ ham sukut bo‘yicha qo‘llab-quvvatlaydi. Windows Terminal, WezTerm va Alacritty’da tugmalarni uzatish uchun qo‘lda bir qator sozlama qo‘shish kerak, terminal sozlamalari hujjatiga qarang[2].
S: To‘liq oflayn ishlashni va pi.dev’ga yangilanishlarni tekshirish uchun ulanmaslikni xohlayman.PI_OFFLINE=1 barcha ishga tushirish paytidagi tarmoq amallarini o‘chiradi. Faqat versiya tekshiruvini o‘chirish uchun PI_SKIP_VERSION_CHECK=1 dan foydalaning.
Manbalar
• Pi tezkor boshlash hujjati[3]
• Pi Providers hujjati[1] - barcha Provider’lar, atrof-muhit o‘zgaruvchilari va bulut provayderlari sozlamalari
• Pi Custom Models hujjati[4] - models.json orqali maxsus Provider sozlash
• Pi Settings hujjati[5]
• Pi Terminal Setup[2] - turli terminallardagi tugma sozlamalari
• Pi GitHub repository[6]
Havolalar
[1] Rasmiy Providers hujjati: https://pi.dev/docs/latest/providers[2] Terminal sozlamalari hujjati: https://pi.dev/docs/latest/terminal-setup[3] Pi tezkor boshlash hujjati: https://pi.dev/docs/latest/quickstart[4] Pi Custom Models hujjati: https://pi.dev/docs/latest/models[5] Pi Settings hujjati: https://pi.dev/docs/latest/settings[6] Pi GitHub repository: https://github.com/earendil-works/pi