Indlela Yokufaka I-Agentbox Nokusebenzisa i-Claude Code noma i-Codex Esipheqululini Sakho

Yini i-Agentbox?

I-Agentbox iyindawo ephethwe nguwe yokusebenzisa i-Claude Code ne-Codex CLI esipheqululini. Ihlanganisa ingxoxo ye-AI, itheminali, amafayela ephrojekthi, ukubuyekezwa kwe-Git, ukuphathwa kwama-akhawunti, nokulandelelwa kokusetshenziswa ezindaweni zokusebenza eziqhubekayo ezisingathwe kuseva yakho.

Iseva isatshalaliswa njengefayela elilodwa le-Go eline-frontend ye-TypeScript eshumekiwe. Igcina isimo sohlelo nomlando wezingxoxo ku-SQLite futhi isebenzisa iziqukathi ze-Docker ukuhlukanisa izindawo zokusebenza zokubhala ikhodi. Izinkomba eziqhubekayo zigcina amafayela ephrojekthi, ukucushwa kwekhaya, nezinsiza ezabiwe ngokuzimela emjikelezweni wempilo wesiqukathi.

I-Agentbox iwusizo kakhulu lapho ufuna ukuqala umsebenzi wokubhala ikhodi kudivayisi eyodwa bese uqhubekela kuwo kwenye ngaphandle kokwakha kabusha indawo. Ungasebenzisa ingxoxo yewebhu esakaza impendulo emsebenzini ogxile emsebenzini, noma uvule itheminali yesiphequluli ukuze usebenze ngokuqondile nge-Claude Code noma i-Codex CLI yasekuqaleni.

Izici ezibalulekile

• Izindawo zokusebenza eziqhubekayo: Amafayela ephrojekthi, ukucushwa kwekhaya, amafayela abiwe, nomlando wezingxoxo kuhlala kuseva yakho.
• Izindawo ezimbili zokuxhumana nama-agent: Shintsha phakathi kwengxoxo yesiphequluli namathuluzi okuqala omugqa womyalo.
• Ukugeleza komsebenzi okudidiyelwe kokulethwa: Layisha noma u-clone iphrojekthi, yabela umsebenzi, hlola amafayela, buyekeza ama-diff e-Git, bese wenza i-commit noma ulande umphumela.
• Ichibi lama-akhawunti eliphakathi: Abaphathi bangacushisa okubhaliselwe kwe-Claude ne-Codex OAuth, okhiye be-API, iziphetho ze-relay, izikophu zokufinyelela, nama-proxy aphumayo.
• Amarekhodi okusetshenziswa nezindleko: Hlunga ukusetshenziswa ngomsebenzisi, imodeli, nesikhathi ngenkathi uhlola amathokheni, imithombo yamanani, ukubambezeleka, nezindleko ezirekhodiwe.
• Izinsiza ezingasetshenziswa kabusha: Umsebenzisi ngamunye uthola inkomba eyabiwe efakwe njenge-/shared kuzo zonke izindawo zakhe zokusebenza. Kusekelwa namathemplethi asekhaya, amakhono e-Claude, nokucushwa kwe-MCP.
• Ukufinyelela okukhethwayo kunethiwekhi eyimfihlo: Iklayenti le-abox-link lingadalula izinqolobane, o-database, nezinsiza ezivunyelwe ngokusobala ezindaweni zokusebenza ezisingathwe efwini.
• Isixhumi esibonakalayo esivumelana nezikrini: Ikhonsoli isekela izixhumanisi ezijulile, amatimu akhanyayo namnyama, nezakhiwo zeselula.

Qonda ukwakheka kohlelo

Isiphequluli sakho sixhuma kuseva ye-Agentbox nge-HTTP noma i-HTTPS nangoxhumano lwe-WebSocket. Iseva ilawula iziqukathi zezindawo zokusebenza nge-API ye-Docker yasendaweni futhi igcina amarekhodi ohlelo ku-SQLite. Indawo ngayinye yokusebenza inesiqukathi sayo nezinkomba eziqhubekayo.

Indawo yokusebenza ingaba nemicu yezingxoxo eminingi, nakuba kungasebenza ukujika okukodwa kwengxoxo yewebhu ngesikhathi esisodwa kuleyo ndawo. Izindawo eziyinhloko eziqhubekayo yi-/workspace, /home/agent, ne-/shared. Amafayela okufanele asinde ekushintshweni kwesiqukathi kufanele agcinwe kwenye yalezi zindawo.

Okubalulekile: Amafayela aqhubekayo awasho izinqubo eziqhubekayo. Ukuxhuma kabusha ngemva kokuphazamiseka kwenethiwekhi yetheminali kungabuyisela iseshini ye-tmux, kodwa ukumisa noma ukwakha kabusha isiqukathi kuqeda izinqubo ezisebenzayo.

Izidingo zangaphambilini

Indlela esheshayo yokufaka ihlose iseva ye-Linux ene-systemd. Amaphakheji okukhishwa asekela i-Linux x86_64 ne-arm64.

• Ubuntu 22.04 noma entsha, noma i-Debian 12 noma entsha, ingafakelwa ngokuzenzakalelayo iz dependencies ezingekho ne-Docker.
• Ezinye izabelo ze-Linux zidinga i-Python 3.9 noma entsha, i-Git, i-curl, izitifiketi ze-CA, idatha yezindawo zesikhathi, ne-Docker Engine yasendaweni.
• Ukwakhiwa kokuqala kwesithombe sendawo yokusebenza kudinga ukufinyelela kuma-container registry, ezinqolobaneni zamaphakheji e-Debian, naku-npm.
• Ukuze uthole ukufinyelela okukude, imbobo ye-TCP 8180 kufanele ivunyelwe ku-firewall yeseva noma eqenjini lezokuphepha ngaphandle uma usebenzisa i-SSH forwarding noma i-reverse proxy.

Ukufakwa okwakhiwe kusengaphambili akudingi i-Go noma i-Node.js kuseva.

Faka i-Agentbox ngesifaki sokukhishwa

1. Qalisa isifaki

Xhuma kuseva ye-Linux bese usebenzisa:

curl -fsSL https://raw.githubusercontent.com/devilcoolyue/agentbox/main/install.sh | sudo bash

Isifaki sikhetha ukukhishwa okuzinzile kwakamuva ngokuzenzakalelayo. I-README ikhomba i-v0.1.5 njengokukhishwa okuzinzile kwamanje. Ukuze ubophele leyo nguqulo, sebenzisa:

curl -fsSL https://raw.githubusercontent.com/devilcoolyue/agentbox/main/install.sh | sudo bash -s -- --version v0.1.5

Inqubo yokufaka iqinisekisa iphakheji yokukhishwa, yakha isithombe sendawo yokusebenza ngezinguqulo zamathuluzi eziboshiwe, idala ukucushwa, ikhiqize iphasiwedi yomlawuli engahleliwe, bese iqala i-agentbox.service. Ukwakhiwa kwesithombe sokuqala kungathatha imizuzu embalwa.

2. Vula ikhonsoli

Lapho ukufaka sekuqediwe, bhala phansi iphasiwedi yomlawuli ephrintwe etheminali. Vula leli kheli elilandelayo, ubuyisele indawo ebekelwe ikheli leseva:

http://YOUR_SERVER_IP:8180

Ngena ngegama lomsebenzisi elithi boxadmin kanye nephasiwedi ekhiqiziwe. Lungisa i-HTTPS ngaphambi kokudalula i-Agentbox ukuze isetshenziswe esidlangalaleni ngokuqhubekayo.

3. Khawulela i-Agentbox ku-reverse proxy

Uma i-Agentbox kufanele yamukele kuphela ukuxhumana kwasendaweni, engeza inketho yokulalela ngesikhathi sokufaka:

curl -fsSL https://raw.githubusercontent.com/devilcoolyue/agentbox/main/install.sh | sudo bash -s -- --listen 127.0.0.1:8180

Ngemva kwalokho ungabeka i-reverse proxy ye-HTTPS enokusekelwa kwe-WebSocket phambi kwensizakalo. Ukufakwa kokukhishwa kugcina ukucushwa ku-/etc/agentbox nedatha yohlelo ku-/var/lib/agentbox.

Lungisa i-akhawunti ye-Claude noma ye-Codex

Ngemva kokungena, vula Izilungiselelo zesistimu → Ichibi lama-akhawunti, eliboniswa kusixhumi esibonakalayo samanje sesiShayina njenge-系统设置 → 账号池. Engeza i-akhawunti ye-Claude noma ye-Codex.

I-Agentbox isekela izindlela ezilandelayo zokuxhuma:

• Okubhaliselwe ku-Claude: Khetha i-Subscription OAuth bese unamathisela ikhodi yokugunyaza.
• Okubhaliselwe ku-Codex: Khetha i-Subscription OAuth bese unamathisela i-URL ephelele ye-callback.
• I-akhawunti ye-API noma ye-relay: Faka isiphetho somhlinzeki nokhiye. I-Codex relay kufanele ihambisane nephrothokholi elindelwe umhlinzeki.

Bekela i-akhawunti igama elibonakala kalula, i-egress proxy yayo uma kudingeka, kanye nobubanzi bokufinyelela. I-akhawunti ingatholakala kubo bonke abasebenzisi, kubasebenzisi abakhethiwe, noma kubaphathi kuphela. Abaphathi bangasebenzisa wonke ama-akhawunti amisiwe.

Abasebenzisi bendawo yokusebenza abanokufinyelela ku-terminal bangafunda imininingwane yokungena enikezwa amathuluzi omugqa womyalo ngaphakathi kwama-container abo. Ngakho-ke amaqoqo ama-akhawunti abiwe kufanele anqunyelwe kubasebenzisi abathembekile. Ukuhoxisa ukufinyelela kuvimbela imisebenzi emisha nokuvumelaniswa kwemininingwane yokungena, kodwa ukuhoxisa ngokuphelele kungase kudinge nokumisa ama-container athintekile nokushintsha imininingwane yokungena ephezulu.

Dala indawo yakho yokuqala yokusebenza

1. Dala indawo yokusebenza bese uyinika igama elichazayo.
2. Khetha i-Claude Code noma i-Codex CLI njenge-agent.
3. Khetha i-akhawunti umsebenzisi wakho ogunyazwe ukuyisebenzisa.
4. Ngenisa iphrojekthi ngokuyilayisha nge-Files noma ngokuyiclone ku-Terminal.
5. Vula i-Chat bese uthumela umsebenzi wokubhala ikhodi ogxile.
6. Hlola amafayela ahleliwe bese ubuyekeza i-Git diff ngaphansi kwe-Changes.
7. Yenza i-commit yezinguquko endaweni noma ulande amafayela ephrojekthi.

Layisha futhi uhlole amafayela ephrojekthi

Isixhumi esibonakalayo se-Files sinikeza isihlahla sezinkomba, ukulayisha, ukuhlela, ukubuka kuqala, nokulanda ama-archive ezinkomba zephrojekthi nezabiwe. Isibuki somthombo sihlanganisa izinombolo zemigqa, ukugqamisa i-syntax, ukuzulazula ngomugqa nekholomu, ukugqamisa umugqa wamanje, kanye nemodi yesikrini esigcwele.

Imisebenzi yamafayela eWeb isebenzisa izibambo zezinkomba ezikhawulelwe futhi ayilandeli ama-symbolic link. Okulayishiwe kuqinisekiswa ezinkombeni zesikhashana, kanti ukulondolozwa komhleli kusebenzisa ukufaka esikhundleni kwe-athomu. Amathuluzi omugqa womyalo angaphakathi kwe-container asengasebenzisa izixhumanisi ezihlinzekwe ama-template.

Clone i-repository kusuka ku-terminal

Vula i-Terminal bese usebenzisa imiyalo evamile ye-shell. Isibonelo:

cd /workspace
git clone https://github.com/OWNER/PROJECT.git
cd PROJECT
git status

I-Agentbox ihlanganisa ama-CLI e-agent okuqala namathuluzi ajwayelekile okuthuthukisa esithombeni sayo sendawo yokusebenza. Amaseshini e-Terminal asebenzisa i-tmux ukuze ukwazi ukuphinde uxhume ngemva kokunqamuka kwesiphequluli noma kwenethiwekhi.

Yabela umsebenzi ku-Web chat

Vula i-Chat bese uchaza ushintsho oluceliwe, imikhawulo efanele, nokuqinisekisa okulindele. Isibonelo:

Hlola le phrojekthi bese wengeza ukuqinisekiswa kokufakwayo endaweni yokugcina yokubhaliswa kwabasebenzisi. Londoloza ifomethi yempendulo ye-API ekhona, wengeze izivivinyo zamakheli e-imeyili angavumelekile, bese usebenzisa iqoqo lezivivinyo elifanele.

I-Chat isekela ukukhethwa kwemodeli nezinga lomzamo wokucabanga. Impendulo ngayinye igcina isikhathi sayo, imodeli, isifinyezo sezilungiselelo, nezindleko. I-Claude isebenzisa ama-turn angenamakhanda asakazwayo. I-Codex ikhetha ukuhlanganiswa kwayo ne-app-server futhi ibuyela kumodi yokwenza uma i-handshake yehluleka.

Buyekeza bese uletha umphumela

Ngemva kokuba i-agent iqedile, vula i-Changes ukuze uhlole amafayela ashintshiwe nama-diff anemibala. Buyekeza ifayela eliphelele lapho i-diff ingenawo umongo owanele.

Ama-commit eWeb agcinwa endaweni futhi awathumeli ngokuzenzakalelayo ku-repository ekude. Futhi awasebenzisi ama-Git hook noma ukusayina. Sebenzisa i-terminal lapho kudingeka ama-hook noma ama-commit asayiniwe.

I-Agentbox iphinde inikeze ukuphathwa kwe-Git kokuxhumeka kwama-repository, ukuwenza i-clone, ukuwalanda, ama-fast-forward pull, ama-push aboniswa kusengaphambili, imisebenzi yama-branch, nokudala ama-pull request nama-merge request e-GitHub noma e-GitLab. Ukuxhumeka kwama-repository kungasebenzisa amathokheni e-HTTPS noma okhiye abayimfihlo be-SSH.

Yakha futhi usebenzise kusuka emthonjeni

Sebenzisa ukuhamba komsebenzi komthombo lapho uhlela ukulungisa i-Agentbox noma ukufaka isandla kuphrojekthi. Indawo yokwakha ebhaliwe isebenzisa i-Linux ene-Docker, i-Go 1.26.6 noma i-toolchain ezenzakalelayo ehambisanayo, i-Git, i-Python 3, i-curl, iproute2, ne-OpenSSL. I-Node.js 22 ne-npm kudingeka kuphela lapho uhlela ikhonsoli enkulu ye-TypeScript.

1. Yenza i-clone bese wakha

git clone https://github.com/devilcoolyue/agentbox.git
cd agentbox

go build -o agentbox ./cmd/agentbox
./scripts/build-image.sh

Umsebenzisi osebenzisa ukwakhiwa kwesithombe udinga ukufinyelela ku-Docker. Ekuqaleni, iseva kufanele futhi isethe ubunikazi benkomba efakiwe ku-1000:1000; isevisi ye-systemd enikeziwe isebenza njenge-root.

2. Dala ukumiswa

cp config.example.json config.json
openssl rand -hex 24

Kopisha inani elingahleliwe elikhiqiziwe ku-auth_token. Ekuhlolweni kokuqala, shiya accounts ne-proxies zingenalutho bese wengeza ama-akhawunti angempela kamuva nge-Web UI.

{
  "listen": "127.0.0.1:8180",
  "auth_token": "CHANGE_ME_TO_A_LONG_RANDOM_TOKEN",
  "data_dir": "data",
  "agent_image": "agentbox-agent:latest",
  "accounts": [],
  "proxies": []
}

Faka esikhundleni sesibambi ngaphambi kokuqalisa ngoba ukuqinisekiswa kokumiswa kuyasenqaba.

3. Qalisa iseva

sudo ./agentbox -config config.json

Ukuze uthole iseva elalela ku-localhost kuphela, dala i-SSH tunnel kusuka kukhompyutha yakho:

ssh -N -L 8180:127.0.0.1:8180 user@your-server

Vula http://127.0.0.1:8180 ekhompyutheni yangakini bese ungena usebenzisa boxadmin kanye ne-auth_token elungiselelwe. Uma i-akhawunti yomlawuli isidaliwe, iphasiwedi yayo igcinwa ku-SQLite; ukushintsha i-auth_token kamuva akuyisethi kabusha leyo phasiwedi.

4. Faka isevisi ye-systemd

Ngemva kokumisa inqubo esebenza ngaphambili, faka futhi usabalalise isevisi usuka endaweni yokugcina ikhodi:

sudo ./deploy/install.sh
sudo ./deploy/deploy.sh

Isikripthi sokuqala sifaka isevisi nezibali-sikhathi. Esesibili sakha futhi sishintshe ama-binary, siqale kabusha isevisi, bese senza ukuhlola impilo.

Qapha ukusetshenziswa nezindleko

Ikhasi Lokusetshenziswa lirekhoda umsebenzi wamamodeli futhi livumela abalawuli ukuthi bahlunge ngomsebenzisi, imodeli, nangesikhathi. Amarekhodi ngamanye afaka ukusetshenziswa kwamathokheni, imithombo yezindleko, kanye nesikhathi sokuphendula. Abasebenzisi abajwayelekile bangabona amarekhodi abo, kanti abalawuli bangabona amarekhodi abo bonke abasebenzisi.

Amakhathalogi entengo angasebenzisa i-preset yomthombo we-models.dev noma imithombo yangokwezifiso ye-HTTPS. Izibuyekezo zentengo zigcina izithombe zomlando, futhi amanani angokwezifiso ahlala evikelekile. Ama-Web turn anentengo kusetshenziswa ithebula eliphiniwe ngesikhathi kuqala i-turn.

Imikhawulo yamakhredithi ayiyona imikhawulo eqinile yesikhathi sangempela. I-Web turn ikhokhelwa ngemva kokuphela kwayo, ngakho i-turn eqeda ibhalansi ingase isebenzise imali eyeqile. Ukusetshenziswa kwe-terminal okufakwe emuva kuyarekhodwa kodwa akudonsi amakhredithi.

Amathiphu athuthukile

Sebenzisa izinsiza ezabiwe kuwo wonke ama-workspace

Uhla lwemibhalo olwabiwe lomsebenzisi ngamunye lufakwa ku-/shared kuwo wonke ama-workspace alowo msebenzisi. Gcina izikripthi ezisebenziseka kabusha, amafayela ayinkomba, noma ama-artifact lapho esikhundleni sokuwakopisha kuwo wonke amaphrojekthi. I-Agentbox iphinde isekele amatemplate asekhaya esistimu nawowomsebenzisi ngamunye.

Finyelela izinsiza eziyimfihlo nge-abox-link

Iklayenti le-abox-link elingakhethwa livumela i-cloud workspace ukuthi ifinyelele izinsiza ezisohlwini oluvunyelwe ezitholakala kukhompyutha yakho noma komunye umshini oyimfihlo. Lingasebenza ngephaneli yangakini noma ngemodi yeseva yomugqa womyalo nge---server.

Sebenzisa uhlu oluncane lwezinsiza ezivunyelwe futhi uveze kuphela amakhosombe, izizindalwazi, noma izinsiza ezidingwa yi-workspace. I-Agentbox ibonisa ukulungela kokuxhumeka kweklayenti ne-workspace. Ukusebenzisa isiphequluli okuvamile akudingi i-abox-link.

Hlela umthamo we-container

I-container ngayinye ye-workspace ngokuzenzakalelayo inememori engu-2048 MiB, ama-CPU angu-2, nezinqubo ezingu-512. Linganisa iseva ngenani elilindelekile lama-workspace asebenza ngesikhathi esisodwa. Abalawuli bangaphinda balungiselele imikhawulo yomhlaba wonke neyomsebenzisi ngamunye yama-container kanye nesikhala sediski esibekelwe.

Yenza ikhophi eyisipele yedatha efanele

Amakhophi ayisipele esistimu azenzakalelayo afaka isizindalwazi, ukucushwa, imininingwane yokungena kuma-akhawunti, nezendlalelo zamatemplate, kodwa awafaki idatha ye-workspace. Sebenzisa agentbox backup --full lapho amafayela omlbenzisi nomlando nawo kufanele athathwe. Ikhophi eyisipele ephelele idinga ukuthi isevisi nama-container afanele kumiswe kuqala. Sebenzisa backup-verify ukuqinisekisa ingobo yomlando kanye ne-restore --to ukuyibuyisela kuhla lwemibhalo olusha.

Qonda umngcele wokuphepha

Ama-agent angasebenzisa ikhodi ngaphakathi kwama-container e-workspace. Imodi yemvume ezenzakalelayo yi-bypassPermissions. Ama-container asebenza njengomsebenzisi ongeyena u-root anemikhawulo yezinsiza kanye ne-no-new-privileges, kodwa iseva ye-Agentbox ngokwayo inokufinyelela ku-Docker. Ngakho-ke ukuthunyelwa nokuphathwa kufanele kuhlale kusezandleni zabasebenzisi abathembekile.

Sebenzisa isiphequluli esikude esingakhethwa ngokucophelela

I-Agentbox inganikeza isiphequluli sedeskithophu esigcwele ngaphakathi kwe-workspace, okuhlanganisa isimo sokungena esigciniwe, amathebhu, isikrini esigcwele, ikhwalithi yesithombe eguquguqukayo, ukwesekwa kwe-clipboard, nokulanda. Abalawuli kufanele bakhe futhi bakhethe i-image engakhethwa ye-agentbox-agent:browser. Ukuqinisekiswa kwewebhusayithi kuhlala kwehlukile ekugunyazweni kwe-Claude noma kwe-Codex CLI.

Imikhawulo yokusebenza okufanele uyikhumbule

• Inqubo eyodwa kuphela ye-Agentbox engasebenzisa i-data_dir ethile.
• Isakhiwo samanje sokukhiqiza sisebenzisa umshini owodwa, inqubo yeseva eyodwa, kanye ne-daemon ye-Docker yangakini.
• Ukuthunyelwa nokuqaliswa kabusha kunqamula amaklayenti axhunyiwe isikhashana.
• Ukuvuselela isimo se-Git esikude akulandi; amanani okuthi ngaphambili nangemuva avela kunqolobane yangakini.
• Ukuhoxisa i-akhawunti akususi imininingwane yokungena esivele idluliselwe ku-container esebenzayo.
• Ukumisa noma ukwakha kabusha i-container ye-workspace kuqeda izinqubo zayo nakuba amafayela aqhubekayo esala.
• Ukubuyekeza i-Git kungaqalisa i-workspace emisiwe futhi kusebenzisa ukuhlolwa okufanayo kokwamukelwa kwamakhredithi njengokufinyelela ku-terminal.

Isiphetho

I-Agentbox iguqula iseva ye-Linux ibe yindawo yokubhala ikhodi ephikelelayo esekelwe kusiphequluli ye-Claude Code ne-Codex CLI. Qala ngesifaki sokukhishwa, engeza i-akhawunti, dala i-workspace, bese usuka emsebenzini wengxoxo uye kukhodi ebuyekeziwe ngokusebenzisa ukubuka okuhlanganisiwe kwe-Files, Terminal, ne-Changes. Ekusetshenzisweni kokukhiqiza, engeza i-HTTPS, lawula ukufinyelela kuma-akhawunti ngokucophelela, qapha ukusetshenziswa kwezinsiza, futhi usungule uhlelo lwekhophi eyisipele olufaka idatha ye-workspace lapho kudingeka.

Ukuze uthole ukucushwa okujulile nesiqondiso sokusebenza, bheka indawo yokugcina ikhodi ye-Agentbox, inkomba yamadokhumenti, kanye nomhlahlandlela wokuthunyelwa nokusebenza.