Umhlahlandlela Wokufaka, Ukulungisa Nokwenza Ingxoxo Yokuqala nge-Pi Agent

Ukufaka i-Pi akunzima, kudinga umyalo owodwa kuphela. Okubalulekile ukuqonda kuqala indlela yokuqinisekisa: uzosebenzisa okubhalisele kakade, noma i-API Key? Ngezansi sizodlula ekufakeni, ekuqinisekiseni nasezingxoxweni zokuqala konke kanye.

Umqondo oyinhloko: izindlela ezimbili zokuqinisekisa

Ngemva kokufaka i-Pi, idinga imininingwane yomnikezeli othile we-LLM ukuze isebenze. Kunezindlela ezimbili zokuqinisekisa, futhi umehluko wazo yiwona kuphela okudingeka uwuqonde kulesi sihloko:

• Ukungena ngokubhalisele (/login)｜I-API Key

• Okusetshenziswayo｜Okubhaliselwe ku-Claude Pro/Max, ChatGPT Plus/Pro, njll.｜I-API Key ekhishwa umnikezeli

• Ukukhokhisa｜Kuyinkimbinkimbi (umkhawulo wokubhalisele + ukusetshenziswa okwengeziwe okungenzeka)｜Nge-token, ukhokha ngokusetshenziswa

• Lapho kugcinwa khona imininingwane｜~/.pi/agent/auth.json (i-OAuth token, ivuselelwa ngokuzenzakalelayo)｜Kokuguquguqukayo kwemvelo noma ku-auth.json

• Kufanele bani｜Abanokubhalisele kakade, abangafuni ukuphatha i-Key ngokwehlukana｜Abafuna ukulawula izindleko ngokunembile

Isikhumbuzo: Ukungena ngokubhalisele kwe-Anthropic (Claude Pro/Max) kusebenzisa isiteshi se-harness senkampani yangaphandle futhi kukhokhiswa nge-token; akudli umkhawulo wohlelo lokubhalisele. I-Pi izoveza isexwayiso, okuyinto evamile. Uma ufuna ukulawula ngokuphelele futhi ubone noma nini ukuthi usebenzise malini, i-API Key ilula kakhulu.

Ukusebenza

1. Faka i-Pi

I-Pi isebenza ku-Node.js, idinga u-22.19.0 noma ngaphezulu. Qala ngokuqinisekisa nge-node --version. Khetha noma iyiphi kulezi zindlela ezimbili zokufaka:

# Ukufaka emhlabeni wonke nge-npm (--ignore-scripts yeqa imibhalo yokuncika, kuphephe kakhulu)
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

# Noma sebenzisa isifaki se-curl (sizokufakela i-Node uma ingekho)
curl -fsSL https://pi.dev/install.sh | sh

Ngemva kokufaka, qinisekisa nge-pi --version. Ukuwukhipha sebenzisa npm uninstall -g @earendil-works/pi-coding-agent.

2. Lungisa ukuqinisekiswa

Indlela yokuqala: I-API Key (iyanconywa). Setha i-Key njengokuguquguqukayo kwemvelo:

export ANTHROPIC_API_KEY=sk-ant-...
pi

Noma ku-Pi sebenzisa /login, ukhethe umnikezeli we-API Key, bese ugcina i-Key ku-~/.pi/agent/auth.json (izimvume ezingu-0600, nguwe kuphela ongayifunda noma ukuyibhala). Okuguquguqukayo kwemvelo kwabahlinzeki abavamile:

• Umnikezeli｜Okuguquguqukayo kwemvelo

• 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

Uhlu oluphelele lunabahlinzeki abaningi, bheka imibhalo esemthethweni ye-Providers[1].

Indlela yesibili: Ukungena ngokubhalisele. Uma usunokubhalisele okufana ne-Claude Pro noma i-ChatGPT Plus, ku-Pi sebenzisa /login, ukhethe umnikezeli ohambisanayo, bese uqedela i-OAuth. I-Pi ivuselela ngokuzenzakalelayo ama-token aphelelwe yisikhathi. Okukhethwayo: Claude Pro/Max, ChatGPT Plus/Pro(Codex), GitHub Copilot, xAI, OpenRouter. Sebenzisa /logout ukuze uphume.

Umphakathi we-Pi uyasebenza kakhulu; i-Pi Agent yakamuva manje isekela ne-token plan ye-Qianwen.

Ngemva kokulungisa imodeli, sebenzisa /model ukuze ukhethe imodeli ofuna ukuyisebenzisa.

I-Pi Agent inomqondo obizwa nge-scoped models.

Inhloso yama-scoped models ukuvumela abasebenzisi ukuthi bashintshe ngokushesha phakathi kwamamodeli amaningana nge-ctrl + p. Ungasebenzisa futhi ctrl + l ukuze ukhethe. Ukulungiselelwa okuhambisanayo kutholakala kufayela ~/.pi/agent/settings.json, enkambini ethi enabledModels.

3. Ukuqalisa okokuqala

Yiya enkombeni yephrojekthi bese uyiqalisa:

cd /path/to/your/project
pi

Lapho uqala okokuqala iphrojekthi equkethe ukulungiselelwa kwe-.pi/, i-Pi izokubuza ukuthi uyayethemba yini. Izinsiza ezisezingeni lephrojekthi zingase ziqukathe izandiso ezikwazi ukusebenzisa noma iyiphi ikhodi, ngakho i-Pi ayikuvumeli ukuzilayisha ungazi. Isinqumo sokwethemba sigcinwa ku-~/.pi/agent/trust.json; ngeke iphinde ibuze ngokuzayo.

Isixhumi esibonakalayo sinezingxenye ezine ukusuka phezulu kuye phansi: i-Header (izinqamuleli/izinsiza ezilayishiwe), i-Messages, i-Editor (lapho uthayipha khona; umbala womngcele ubonisa izinga lokucabanga), ne-Footer (inkomba, iseshini, ukusetshenziswa kwama-token, izindleko, nemodeli yamanje). Thayipha ngokuqondile bese ucindezela u-Enter, isibonelo:

Ngisize ngibheke ukwakheka kwale nqolobane, ungitshele ukuthi ngingazisebenzisa kanjani izivivinyo zayo.

Ngokuzenzakalelayo i-Pi inikeza imodeli amathuluzi amane: read, write, edit, ne-bash. Amanye amathuluzi amathathu okufunda kuphela, i-grep/find/ls, avaliwe ngokuzenzakalelayo. Uma uwadinga, wavule nge---tools, ngokwesibonelo ukwenza ukubuyekezwa kwekhodi okufunda kuphela:

pi --tools read,grep,find,ls -p "Buyekeza ikhwalithi yekhodi yale nqolobane"

Shintsha imodeli ngo-Ctrl+L noma nge-/model; phuma ngokucindezela u-Ctrl+C kabili noma usebenzise /quit; ukuze uqhubeke nengxoxo yokugcina sebenzisa pi -c.

Ukuqonda ukuthi kusebenza kanjani

Uhlelo lokuhlaziya ukuqinisekiswa: Uma kumisiwe kokubili okuguquguqukayo kwemvelo, i-auth.json, namapharamitha omugqa womyalo, i-Pi isebenzisa ngokulandelana umyalo --api-key > auth.json > okuguquguqukayo kwemvelo > models.json. Ukuhlola i-Key yesikhashana sebenzisa ngokuqondile pi --api-key xxx, ngaphandle kokushintsha amafayela okulungiselela.

Ukwethembeka kwephrojekthi kuyisivikelo sokufaka, akusona i-sandbox: Kuvela ibhokisi kuphela ekuqaleni kokuxhumana. Kumodi engasebenzisi ukuxhumana (pi -p) ngokuzenzakalelayo kusetshenziswa i-ask, futhi ungakushintsha nge--a/-na. I-Pi ayinayo i-sandbox ngokuzenzakalelayo; uma imodeli ithola i-bash, ingasebenzisa noma yimuphi umyalo. Ukuphatha izinqolobane ongazethembi kudinga ukuhlukaniswa nge-container, okuyisihloko sesahluko sokuphepha esizayo.

Imibuzo evamile

Q: pi --version ithi command not found, kodwa i-npm ithi ifakiwe.
Ngokuvamile inkomba ye-npm global bin ayikho ku-PATH. Sebenzisa npm prefix -g ukuze ubone indlela bese uyifaka ku-PATH; abasebenzisi be-nvm mabakhumbule ukusebenzisa nvm use.

Q: Lapho ngiqalisa ithi inguqulo ye-Node iphansi kakhulu.
I-Pi idinga i-Node 22.19.0+. Sebenzisa umphathi wezinguqulo (fnm/mise/nvm) ukuze uthuthukise, noma sebenzisa isifaki se-curl.

Q: Ngemva kokungena nge-Claude Pro ngithola isexwayiso sokusetshenziswa okwengeziwe njalo.
Ukubhalisele kwe-Anthropic kusebenzisa isiteshi senkampani yangaphandle futhi kukhokhiswa nge-token. Ukuvala lokhu, engeza okulandelayo ku-~/.pi/agent/settings.json:

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

Q: I-Shift+Enter ayikwazi ukwehlisa umugqa.
I-Pi isebenzisa i-Kitty keyboard protocol ukuze ibone izinkinobho eziguquliwe. I-iTerm2, Kitty ne-Ghostty zisebenza ngaphandle kokulungiselelwa; i-VS Code 1.109.5+ iyayisekela ngokuzenzakalelayo. I-Windows Terminal, WezTerm ne-Alacritty kudinga ukuthi wengeze umugqa wokudlulisa izinkinobho; bheka imibhalo yokulungiselela i-terminal[2].

Q: Ngifuna ukusebenza ngaphandle kokuxhumeka, ngaphandle kokuxhumana ne-pi.dev ukuze ihlole izibuyekezo.
PI_OFFLINE=1 ivala yonke imisebenzi yenethiwekhi ngesikhathi sokuqalisa. Uma ufuna ukuvala kuphela ukuhlola inguqulo, sebenzisa PI_SKIP_VERSION_CHECK=1.

Izinsiza zokubhekisela

• • Imibhalo yokuqalisa ngokushesha ye-Pi[3]

• • Imibhalo ye-Pi Providers[1] - Bonke abahlinzeki, okuguquguqukayo kwemvelo, nokulungiselelwa kwabahlinzeki bamafu

• • Imibhalo ye-Pi Custom Models[4] - Ukwenza umnikezeli ngokwezifiso nge-models.json

• • Imibhalo ye-Pi Settings[5]

• • Pi Terminal Setup[2] - Ukulungiselela izinkinobho kuma-terminal ahlukahlukene

• • Inqolobane ye-Pi ku-GitHub[6]

Izixhumanisi ezicashuniwe

[1] Imibhalo esemthethweni ye-Providers: https://pi.dev/docs/latest/providers
[2] Imibhalo yokulungiselela i-terminal: https://pi.dev/docs/latest/terminal-setup
[3] Imibhalo yokuqalisa ngokushesha ye-Pi: https://pi.dev/docs/latest/quickstart
[4] Imibhalo ye-Pi Custom Models: https://pi.dev/docs/latest/models
[5] Imibhalo ye-Pi Settings: https://pi.dev/docs/latest/settings
[6] Inqolobane ye-Pi ku-GitHub: https://github.com/earendil-works/pi