Pag-install ng Aider at Pag-configure ng OmniProxy

Ang Aider ay isang tool na tumutulong sa pag-modify ng code mula sa terminal. Gumagawa ito ng mapa ng buong codebase para matulungan ang model na maunawaan ang mas malalaking proyekto. Ang Git ay isang version control tool na nagtatala ng mga pagbabago sa code, na nagpapahintulot sa iyo na suriin ang mga pagkakaiba at ibalik ang mga nakaraang bersyon. Pagkatapos mong bigyan ang Aider ng gawain, ipoproseso nito ang gawain nang step-by-step at magsusulat ng mga commit message. Kung hindi mo gusto ang mga pagbabago, maaari mo itong bawiin gamit ang /undo.

Bago Ka Magsimula

May dalawang karaniwang opsyon sa pag-install:

• Kung ang iyong computer ay mayroon nang Python 3.8 hanggang 3.13, i-install ang aider-install una. Ang Python ang runtime environment na kailangan ng Aider.

Mac at Linux

install.sh

• Patakbuhin gamit ang sh pagkatapos ng curl
• Nag-i-install ng Python kung kinakailangan
• Gumamit ng wget kung hindi available ang curl

Windows

install.ps1

• Patakbuhin sa PowerShell
• Buksan muli ang terminal pagkatapos ng pag-install
• I-set ang environment variables gamit ang setx

Naka-install na ang Python

aider-install

• I-install muna ang package na ito gamit ang pip
• Pagkatapos ay patakbuhin ang aider-install
• Gumagawa ito ng sarili nitong environment

Siguraduhing tumatakbo ang OmniProxy. Pagkatapos ng pag-install, pumasok sa directory ng proyekto na balak mong i-modify bago simulan ang Aider.

Pag-install at Unang Paglulunsad

Kung Mayroon Ka Nang Python 3.8 Hanggang 3.13

Patakbuhin ang mga command na ito nang sunod-sunod:

python -m pip install aider-install
aider-install

aider-install ini-install ang Aider sa isang hiwalay na Python environment para hindi ito makagulo sa ibang Python projects sa iyong computer. Kung kinakailangan, nag-i-install din ito ng Python 3.12 para magamit ng Aider.

One-Line Installation

Sa Mac at Linux, patakbuhin ang:

curl -LsSf https://aider.chat/install.sh | sh

Kung hindi naka-install ang curl, gamitin ang:

wget -qO- https://aider.chat/install.sh | sh

Sa Windows PowerShell, patakbuhin ang:

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Ang mga one-line command na ito ay base sa uv, isang program para sa pag-install at pamamahala ng mga Python tool at environment. Maaari mo ring gamitin ang sumusunod na command:

uv tool install --force --python python3.12 --with pip aider-chat@latest

Maaari mo ring gamitin ang pipx. Kapag nag-i-install nang direkta gamit ang python -m pip install aider-chat, ang mga suportadong bersyon ng Python ay 3.9 hanggang 3.12. Gayunpaman, ito ay isang alternatibong paraan ng pag-install, kaya mas mainam na gamitin ang mga paraang inilarawan sa itaas. Ang mga Aider package mula sa system package managers ay maaaring magkaroon ng mismatch sa dependency, kaya hindi dapat ito ang iyong unang pagpipilian.

Noong 2026-10-09, ang one-line installation command ay nag-install ng Aider v0.86.2. Sa panahon ng pag-install, maaaring makakita ka ng mensahe na nagsasabing ang cache at destination ay nasa magkaibang disk at ang mga file ay kokopyahin na lamang. Matatapos pa rin ang pag-install.

Pagkatapos ng pag-install, pumasok sa directory ng proyekto. Ang compatible API ay isang interface na nakikipag-ugnayan sa ibang model services gamit ang OpenAI format. Simulan ang Aider gamit ang pattern na ito:

aider --model openai/<model-name>

Palitan ang <model-name> ng buong model ID na kinopya mula sa OmniProxy sa susunod na seksyon. Ang model ID ay ang pangalang ginagamit para tukuyin ang isang model nang eksakto.

Kunin ang Connection Settings mula sa OmniProxy

Kailangan mong i-set ang sumusunod na dalawang environment variables. Ang environment variables ay maaaring ituring bilang isang set ng connection settings na binabasa ng mga terminal program:

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE ay ang API endpoint at dapat isama ang /v1. OPENAI_API_KEY ay ang key na ginagamit para ma-access ang API.

Sa Windows, gamitin ang setx para i-save ang mga variable. Dapat mong buksan muli ang terminal pagkatapos nito:

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

Kopyahin ang buong pangalan ng model mula sa kasalukuyang listahan ng OmniProxy, kasama ang anumang slash sa model ID. Kapag sinisimulan ang Aider, idagdag ang openai/ bago ang buong ID.

Noong 2026-10-09, ang dalawang reference ID sa dokumentasyon ng provider ay gemini-3.8-flash at grok-4.7. Kung ang mga pangalang ito ay wala sa kasalukuyang listahan, huwag silang kopyahin nang direkta. Gumamit ng buong ID na talagang lumalabas sa listahan.

Address

OPENAI_API_BASE

• Ituro ito sa OmniProxy
• Isama ang /v1
• Huwag itong ilagay sa repository

Key

OPENAI_API_KEY

• Gamitin ang ibinigay ng gateway
• Buksan muli ang mga Windows terminal pagkatapos itong baguhin
• Panatilihin ang mga provider key sa gateway

Ilunsad

openai/model

• cd sa directory ng proyekto
• Lagyan ng prefix na openai/ ang pangalan ng model
• Gamitin ang pangalan mula sa listahan ng gateway

Ipasok ang Tool Configuration

Hindi mo na kailangang gumawa ng hiwalay na configuration file. Pumasok sa directory ng proyekto, simulan ang Aider, at palitan ang model ID ng pangalang talagang umiiral sa kasalukuyang listahan ng OmniProxy:

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

Para gamitin ang isa pang halimbawa ng model, patakbuhin ang:

aider --model openai/grok-4.7

Kapag nakatagpo ang Aider ng hindi pamilyar na model, nagpapakita ito ng babala. Ang babalang ito ay hindi nangangahulugan na mali ang endpoint. Suriin ang request logs ng OmniProxy para kumpirmahin kung lumabas ang request.

Ang Aider ay nagdaragdag lamang ng mga file na sinusubaybayan na ng Git sa context. Ang context ay ang code at impormasyon na mababasa ng model sa kasalukuyang gawain. Kung ang kasalukuyang directory ay hindi pa isang Git repository, gagawa ang Aider ng isa, ngunit ang mga file na hindi sinusubaybayan ng Git ay hindi pa rin mababasa. Gamitin ang git add para idagdag ang mga file at i-commit ang mga ito bago simulan ang Aider.

Maaari pa ring i-modify ng Aider ang mga file. --no-auto-commits ay nagdi-disable lamang ng mga awtomatikong commit; hindi nito pinipigilan ang pag-modify ng file. Kapag ginagamit ang Aider sa unang pagkakataon, pumili ng hindi importanteng repository at patakbuhin ang git diff pagkatapos ng gawain para suriin ang mga aktwal na pagbabago.

Huwag maglagay ng mga totoong key sa mga file ng proyekto o sa mga pampublikong pahina. I-store ang mga provider key sa OmniProxy lamang. Kung hindi bina-validate ng gateway ang mga key, maaari mong i-set ang OPENAI_API_KEY sa isang placeholder string na ginagamit lamang sa iyong lokal na computer.

I-verify gamit ang Totoong Gawain

Una, siguraduhin na ang file na gusto mong basahin ng Aider ay na-commit na sa Git. Pagkatapos ay patakbuhin ang sumusunod na command mula sa directory ng proyekto. Palitan ang model ID ng buong ID mula sa kasalukuyang listahan ng OmniProxy:

aider --model openai/gemini-3.8-flash --message "What is the first line of this file? Do not modify the file." --no-auto-commits

--message ay nagpapadala ng gawain nang direkta sa Aider, habang ang --no-auto-commits ay nagsasabi sa Aider na huwag gumawa ng mga Git commit nang awtomatiko sa run na ito.

Noong 2026-10-09, matagumpay na nabasa ng Aider v0.86.2 ang unang linya ng isang tracked file. Kung ang file ay hindi sinusubaybayan ng Git, sasabihin ng Aider na hindi nito makita ang nilalaman. Hindi ito nangangahulugan na mali ang API endpoint. Pagkatapos makumpleto ang query, suriin ang request logs ng OmniProxy para i-verify ang source ng request at model ID.

Ilunsad

naglunsad ang aider

• Available ang command
• Aktibo ang environment variables
• Sa directory ng proyekto

Gawain

Sinuri nito ang file

• Magtanong tungkol sa isang partikular na file
• Suriin ang paliwanag nito
• Ang mga hindi pamilyar na model ay maaaring mag-trigger ng babala

Logs

Makikita sa gateway

• Ang source ay Aider
• Tumutugma ang model ID
• Ang key ay hindi ipinasok sa pahina

Mga Karaniwang Error

• aider hindi mahanap: Buksan muna ang terminal. Kung na-install mo ito nang direkta gamit ang pip, subukan ang python -m aider.
• Ang Windows ay kumokonekta pa rin sa lumang endpoint pagkatapos baguhin ang mga variable: Dapat mong buksan muli ang terminal pagkatapos patakbuhin ang setx. Isang bagong window lamang ang magbabasa ng mga updated na variable.
• Ang pangalan ng model ay hindi nagsisimula sa openai/: Ang compatible API ay nangangailangan ng format na openai/<model-name>.
• May lumalabas na babala tungkol sa hindi pamilyar na model: Ito ay isang normal na babala at hindi nangangahulugan na nabigo ang koneksyon. Suriin kung natanggap ng OmniProxy ang request.
• Ang model ID ay invalid: Kopyahin muli ang kumpletong ID mula sa kasalukuyang listahan ng OmniProxy. Panatilihin ang openai/ prefix at anumang slash na naroroon na sa ID.
• Sinasabi ng Aider na walang nilalaman ang file: Siguraduhin na ang file ay sinusubaybayan ng Git. Ang mga file sa isang bakanteng repository o mga file na hindi sinusubaybayan ay hindi idinaragdag sa context.

Mga Opisyal na Sanggunian

Para sa mga hakbang sa pag-install, tingnan ang Aider installation. Para sa environment variables at model prefix, tingnan ang OpenAI compatible APIs. Ang mga halimbawa ng model ID ay matatagpuan sa Gemini model list at sa xAI models page.

Palagyan ng halaga mula sa iyong sariling konfigurasyon ng OmniProxy ang bawat placeholder. Huwag kailanman ilabas ang tunay na key.

Ang isang na-save na resulta o HTTP 200 lamang ay hindi patunay ng full Agent compatibility. Suriin ang source at modelo sa call log ng OmniProxy.

Mga opisyal na pinagkukunan · Aider ↗