Mafunzo ya Kusakinisha, Kusanidi na Kufanya Mazungumzo ya Kwanza na Pi Agent

Kusakinisha pi si jambo gumu, ni amri moja tu. Jambo pekee la kuamua kwanza ni njia ya uthibitishaji: kutumia usajili uliopo au API Key. Hapa utaelekezwa kupitia usakinishaji, uthibitishaji na mazungumzo ya kwanza kwa pamoja.

Dhana kuu: njia mbili za uthibitishaji

Baada ya kusakinisha pi, inahitaji kitambulisho kutoka kwa mtoa huduma fulani wa LLM ili kufanya kazi. Kuna njia mbili za uthibitishaji, na tofauti yake ndiyo jambo kuu la kuelewa katika makala hii:

• Kuingia kwa usajili (/login) ｜ API Key

• Kinachotumika｜Usajili kama Claude Pro/Max, ChatGPT Plus/Pro, n.k.｜API Key iliyotolewa na mtoa huduma

• Kutoza｜Kunaweza kuwa changamano (kikomo cha usajili + matumizi ya ziada yanayowezekana)｜Kwa tokeni, unalipa kulingana na matumizi

• Mahali kitambulisho kinahifadhiwa｜~/.pi/agent/auth.json (tokeni ya OAuth, huonyeshwa upya kiotomatiki)｜Vigezo vya mazingira au auth.json

• Inafaa kwa nani｜Wenye usajili tayari, wasiopenda kusimamia Key tofauti｜Wanaotaka kudhibiti gharama kwa usahihi

Kumbuka: Kuingia kwa usajili wa Anthropic (Claude Pro/Max) hupitia njia ya wahusika wengine ya harness na hutozwa kwa tokeni; hakutumi kikomo cha kifurushi cha usajili. Pi huonyesha onyo, na hilo ni jambo la kawaida. Ikiwa unataka udhibiti kamili na kuona gharama wakati wowote, API Key ni rahisi zaidi.

Kuanza kutumia

1. Sakinisha pi

Pi huendeshwa kwenye Node.js, inahitaji 22.19.0 au zaidi. Kwanza thibitisha kwa node --version. Chagua mojawapo ya njia hizi mbili:

# Sakinisha kimataifa kwa npm (--ignore-scripts huruka hati za utegemezi, hivyo ni salama zaidi)
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

# Au tumia kisakinishi cha curl (kitasakinisha Node ikiwa haipo)
curl -fsSL https://pi.dev/install.sh | sh

Baada ya kusakinisha, thibitisha kwa pi --version. Kuondoa pi, tumia npm uninstall -g @earendil-works/pi-coding-agent.

2. Sanidi uthibitishaji

Njia ya kwanza: API Key (inapendekezwa), weka Key kama kigezo cha mazingira:

export ANTHROPIC_API_KEY=sk-ant-...
pi

Au ndani ya pi tumia /login, chagua mtoa huduma wa API Key, kisha uhifadhi Key katika ~/.pi/agent/auth.json (ruhusa 0600, ni wewe pekee unayeweza kusoma au kuandika). Vigezo vya mazingira vya watoa huduma maarufu:

• Mtoa huduma｜Kigezo cha mazingira

• 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

Orodha kamili ina watoa huduma kadhaa; angalia nyaraka rasmi za Providers[1].

Njia ya pili: Kuingia kwa usajili, ikiwa una usajili kama Claude Pro au ChatGPT Plus, tumia /login ndani ya pi, chagua provider husika na ukamilishe OAuth. Tokeni huonyeshwa upya kiotomatiki inapoisha. Chaguo zinapatikana kwa Claude Pro/Max, ChatGPT Plus/Pro(Codex), GitHub Copilot, xAI na OpenRouter. Tumia /logout kuondoka.

Jumuiya ya Pi ina shughuli nyingi, na Pi Agent ya hivi karibuni sasa inatumia tokeni plan ya Qwen.

Baada ya kusanidi modeli, unaweza kutumia /model uchague modeli unayotaka kutumia.

Pi Agent pia ina dhana ya scoped models.

Lengo la scoped models ni kumwezesha mtumiaji kubadilisha haraka kati ya modeli kadhaa kwa ctrl + p. Unaweza pia kutumia ctrl + l kuichagua. Mipangilio yake iko katika faili ~/.pi/agent/settings.json, kwenye sehemu ya enabledModels.

3. Anzisha kwa mara ya kwanza

Nenda kwenye saraka ya mradi na uanze:

cd /path/to/your/project
pi

Unapoingia kwa mara ya kwanza kwenye mradi wenye usanidi wa .pi/, pi itakuuliza ikiwa unaamini mradi huo. Rasilimali za kiwango cha mradi zinaweza kuwa na viendelezi vinavyoweza kutekeleza msimbo wowote, hivyo pi haikuruhusu kuvipakia bila wewe kujua. Uamuzi wa kuamini huhifadhiwa katika ~/.pi/agent/trust.json, na hautaulizwa tena wakati ujao.

Kiolesura kina sehemu nne kutoka juu hadi chini: Header (njia za mkato/rasilimali zilizopakiwa), Messages, Editor (mahali pa kuandika; rangi ya mpaka = kiwango cha kufikiri), Footer (saraka/kikao/matumizi ya tokeni/gharama/modeli ya sasa). Andika moja kwa moja kisha bonyeza Enter, kwa mfano:

Nisaidie kuangalia muundo wa hazina hii na uniambie jinsi ya kuendesha ukaguzi wake.

Kwa chaguo-msingi pi huipa modeli zana nne: read, write, edit na bash. Zana nyingine tatu za kusoma tu, grep/find/ls, zimezimwa kwa chaguo-msingi. Zitumie kwa --tools zinapohitajika, kwa mfano kumwomba pi ikague ubora wa msimbo bila kuandika:

pi --tools read,grep,find,ls -p "Kagua ubora wa msimbo katika hazina hii"

Badilisha modeli kwa Ctrl+L au /model; toka kwa kubonyeza Ctrl+C mara mbili au /quit; endelea na mazungumzo ya awali kwa pi -c.

Kuelewa kanuni ya utendaji

Mpangilio wa kutafuta uthibitishaji: Ikiwa vigezo vya mazingira, auth.json na hoja za mstari wa amri vimesanidiwa kwa wakati mmoja, pi hutumia kwa mpangilio amri --api-key > auth.json > vigezo vya mazingira > models.json. Ili kujaribu Key nyingine kwa muda, tumia pi --api-key xxx bila kubadilisha faili za usanidi.

Uaminifu wa mradi ni ulinzi wa ingizo, si sandbox: Huonyesha dirisha wakati wa kuanza katika hali ya maingiliano pekee. Katika hali isiyo ya maingiliano (pi -p), chaguo-msingi ni ask; unaweza kubadilisha kwa -a/-na. Pi haina sandbox kwa chaguo-msingi, na modeli ikipata bash inaweza kutekeleza amri yoyote. Kwa hazina zisizoaminika, tumia utenganishaji wa kontena; hilo litashughulikiwa katika makala ya usalama baadaye.

Maswali ya kawaida

Swali: pi --version inasema command not found, lakini npm inasema imesakinishwa.
Mara nyingi saraka ya bin ya npm ya kimataifa haipo kwenye PATH. Tumia npm prefix -g kuangalia njia na kuiongeza kwenye PATH. Watumiaji wa nvm wakumbuke kutumia nvm use.

Swali: Wakati wa kuanzisha inasema toleo la Node ni la zamani sana.
Pi inahitaji Node 22.19.0+. Tumia kidhibiti cha matoleo (fnm/mise/nvm) kusasisha, au tumia kisakinishi cha curl kikufanyie usakinishaji.

Swali: Baada ya kuingia kwa Claude Pro, onyo la matumizi ya ziada huonekana kila mara.
Usajili wa Anthropic hupitia njia ya wahusika wengine na hutozwa kwa tokeni. Ili kulizima, ongeza katika ~/.pi/agent/settings.json:

{ "warnings": { "anthropicExtraUsage":false } }

Swali: Shift+Enter haiwezi kuunda mstari mpya.
Pi hutumia itifaki ya kibodi ya Kitty kutambua vitufe vya modifaya. iTerm2, Kitty na Ghostty hufanya kazi bila usanidi; VS Code 1.109.5+ huiunga mkono kwa chaguo-msingi. Windows Terminal, WezTerm na Alacritty zinahitaji uongeze mstari wa usanidi wa kusambaza vitufe; angalia nyaraka za usanidi wa terminal[2].

Swali: Nataka kufanya kazi nje ya mtandao kabisa bila kuunganisha kwenye pi.dev kuangalia masasisho.
PI_OFFLINE=1 huzima shughuli zote za mtandao wakati wa kuanzisha. Ikiwa unataka kuzima ukaguzi wa toleo pekee, tumia PI_SKIP_VERSION_CHECK=1.

Marejeo

• • Nyaraka za kuanza haraka za Pi[3]

• • Nyaraka za Pi Providers[1] - Watoa huduma wote, vigezo vya mazingira na usanidi wa watoa huduma wa wingu

• • Nyaraka za Pi Custom Models[4] - Kusanidi Provider maalum katika models.json

• • Nyaraka za Pi Settings[5]

• • Pi Terminal Setup[2] - Usanidi wa vitufe kwa terminal mbalimbali

• • Hazina ya Pi kwenye GitHub[6]

Viungo vya marejeo

[1] Nyaraka rasmi za Providers: https://pi.dev/docs/latest/providers
[2] Nyaraka za usanidi wa terminal: https://pi.dev/docs/latest/terminal-setup
[3] Nyaraka za kuanza haraka za Pi: https://pi.dev/docs/latest/quickstart
[4] Nyaraka za Pi Custom Models: https://pi.dev/docs/latest/models
[5] Nyaraka za Pi Settings: https://pi.dev/docs/latest/settings
[6] Hazina ya Pi kwenye GitHub: https://github.com/earendil-works/pi