การติดตั้ง Aider และการกำหนดค่า OmniProxy

Aider เป็นเครื่องมือที่ช่วยแก้ไขโค้ดผ่านเทอร์มินัล โดยจะสร้างแผนผังของโค้ดทั้งโปรเจกต์เพื่อช่วยให้โมเดลเข้าใจโปรเจกต์ขนาดใหญ่ ส่วน Git คือเครื่องมือควบคุมเวอร์ชันที่ใช้บันทึกการเปลี่ยนแปลงของโค้ด เพื่อให้ตรวจสอบความแตกต่างและกู้คืนการแก้ไขได้ เมื่อมอบหมายงานให้ Aider ระบบจะดำเนินการเป็นขั้นตอนและเขียนข้อความอธิบายคอมมิต หากไม่ต้องการการแก้ไขครั้งนี้ สามารถใช้ /undo เพื่อย้อนคืนได้

การเตรียมพร้อมก่อนติดตั้ง

มีวิธีติดตั้งที่ใช้กันทั่วไปสองแบบ:

• หากคอมพิวเตอร์มี Python 3.8 ถึง 3.13 อยู่แล้ว: ให้ติดตั้ง aider-install ก่อน Python คือสภาพแวดล้อมของโปรแกรมที่ Aider ต้องใช้ในการทำงาน
• หากไม่มี Python เวอร์ชันที่เหมาะสม: ใช้คำสั่งติดตั้งแบบบรรทัดเดียว ซึ่งจะเตรียม Python 3.12 ให้ด้วยเมื่อจำเป็น

Mac และ Linux

install.sh

• ใช้ sh รันหลังจาก curl
• จะติดตั้ง Python เมื่อจำเป็น
• หากไม่มี curl ให้ใช้ wget

Windows

install.ps1

• รันด้วย PowerShell
• เปิดเทอร์มินัลใหม่หลังติดตั้ง
• ตั้งค่าตัวแปรสภาพแวดล้อมด้วย setx

มี Python แล้ว

aider-install

• ติดตั้งแพ็กเกจนี้ด้วย pip ก่อน
• จากนั้นรัน aider-install
• มันจะสร้างสภาพแวดล้อมของตัวเอง

เตรียม OmniProxy ที่กำลังทำงานให้พร้อม หลังติดตั้งเสร็จแล้ว ให้เข้าไปยังไดเรกทอรีของโปรเจกต์ที่ต้องการแก้ไขก่อนเริ่ม Aider

ติดตั้งและเริ่มใช้งานครั้งแรก

มี Python 3.8 ถึง 3.13 อยู่แล้ว

เรียกใช้คำสั่งต่อไปนี้ตามลำดับ:

python -m pip install aider-install
aider-install

aider-install จะติดตั้ง Aider ลงในสภาพแวดล้อม Python แยกต่างหาก เพื่อไม่ให้ปะปนกับโปรเจกต์ Python อื่นในคอมพิวเตอร์ และจะติดตั้ง Python 3.12 สำหรับ Aider เพิ่มเติมเมื่อจำเป็น

การติดตั้งแบบบรรทัดเดียว

สำหรับ Mac และ Linux ให้เรียกใช้:

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

หากคอมพิวเตอร์ไม่มี curl สามารถใช้คำสั่งนี้แทน:

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

สำหรับ Windows PowerShell ให้เรียกใช้:

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

คำสั่งแบบบรรทัดเดียวเหล่านี้ใช้ uv ซึ่งเป็นโปรแกรมสำหรับติดตั้งและจัดการเครื่องมือรวมถึงสภาพแวดล้อม Python นอกจากนี้ยังสามารถใช้คำสั่งต่อไปนี้ได้:

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

อีกทางเลือกหนึ่งคือใช้ pipx หากติดตั้งโดยตรงผ่าน python -m pip install aider-chat จะรองรับ Python เวอร์ชัน 3.9 ถึง 3.12 แต่วิธีนี้ถือเป็นทางเลือกอื่น จึงควรเลือกใช้วิธีติดตั้งก่อนหน้านี้เป็นอันดับแรก Aider ที่มาจากตัวจัดการแพ็กเกจของระบบอาจมีการอ้างอิงแพ็กเกจไม่ตรงกัน จึงไม่ควรใช้เป็นวิธีติดตั้งหลัก

เมื่อวันที่ 2026-10-09 ได้ทดสอบคำสั่งติดตั้งแบบบรรทัดเดียวและติดตั้ง Aider v0.86.2 สำเร็จ ระหว่างการติดตั้ง หากมีข้อความแจ้งว่าแคชและตำแหน่งปลายทางไม่ได้อยู่บนดิสก์เดียวกันและระบบจะเปลี่ยนไปคัดลอกไฟล์ การติดตั้งจะยังคงเสร็จสมบูรณ์

หลังติดตั้งเสร็จ ให้เข้าไปยังไดเรกทอรีของโปรเจกต์ Compatible API หมายถึงอินเทอร์เฟซที่ใช้รูปแบบ OpenAI เพื่อสื่อสารกับบริการโมเดลอื่น โดยมีรูปแบบคำสั่งเริ่มต้นดังนี้:

aider --model openai/<model-name>

ให้แทนที่ <model-name> ด้วย model ID แบบเต็มที่คัดลอกจาก OmniProxy ตามหัวข้อถัดไป model ID คือชื่อที่ใช้ระบุโมเดลอย่างแม่นยำ

รับค่าการเชื่อมต่อจาก OmniProxy

ต้องกำหนด environment variables สองรายการต่อไปนี้ โดย environment variables สามารถเข้าใจได้ว่าเป็นชุดการตั้งค่าการเชื่อมต่อที่โปรแกรมในเทอร์มินัลอ่านมาใช้:

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

OPENAI_API_BASE คือที่อยู่ของ API และต้องลงท้ายด้วย /v1 ส่วน OPENAI_API_KEY คือคีย์ที่ใช้เข้าถึง API

บน Windows ให้ใช้ setx เพื่อบันทึกตัวแปร หลังเรียกใช้แล้วต้องเปิดเทอร์มินัลใหม่:

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

ให้คัดลอกชื่อโมเดลทั้งรายการจากรายการปัจจุบันของ OmniProxy และต้องคงเครื่องหมายทับใน model ID ไว้ เมื่อเริ่ม Aider ให้เติม openai/ ไว้ข้างหน้า ID แบบเต็ม

เมื่อวันที่ 2026-10-09 ID สำหรับอ้างอิงสองรายการในเอกสารของผู้ให้บริการคือ gemini-3.8-flash และ grok-4.7 หากชื่อเหล่านี้ไม่มีอยู่ในรายการปัจจุบัน อย่าคัดลอกไปใช้โดยตรง ให้ใช้ ID แบบเต็มที่มีอยู่จริงในรายการ

ที่อยู่

OPENAI_API_BASE

• ชี้ไปที่ OmniProxy
• ระบุถึง /v1
• อย่าเขียนลงในรีโพซิทอรี

คีย์

OPENAI_API_KEY

• ใช้คีย์ที่เกตเวย์ส่งให้คุณ
• บน Windows ต้องเปิดใหม่หลังแก้ไข
• เก็บคีย์ของผู้ให้บริการไว้ที่เกตเวย์

เริ่มต้น

openai/โมเดล

• cd ไปยังไดเรกทอรีโปรเจกต์
• เติม openai/ หน้าชื่อโมเดล
• ใช้ชื่อตามรายการในเกตเวย์

กรอกการกำหนดค่าของเครื่องมือ

ขั้นตอนนี้ไม่จำเป็นต้องสร้างไฟล์กำหนดค่าเพิ่มเติม ให้เข้าไปยังไดเรกทอรีของโปรเจกต์ก่อน แล้วจึงเริ่ม Aider โดยเปลี่ยน model ID เป็นชื่อที่มีอยู่จริงในรายการปัจจุบันของ OmniProxy:

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

หากต้องการเปลี่ยนไปใช้โมเดลตัวอย่างอีกรายการ ให้เรียกใช้:

aider --model openai/grok-4.7

เมื่อพบโมเดลที่ Aider ไม่รู้จัก อินเทอร์เฟซจะแสดงคำเตือน คำเตือนนี้ไม่ได้หมายความว่ากรอกที่อยู่ผิด ให้ตรวจสอบบันทึกการเรียกใช้ของ OmniProxy ว่ามีคำขอนี้ปรากฏหรือไม่

Aider จะใส่เฉพาะไฟล์ที่ Git ติดตามแล้วลงในบริบท บริบทคือโค้ดและข้อมูลที่โมเดลสามารถอ่านได้ในงานครั้งนี้ หากไดเรกทอรีปัจจุบันยังไม่ใช่ Git repository Aider จะสร้าง repository ให้เอง แต่ไฟล์ที่ Git ยังไม่ได้ติดตามจะยังคงไม่สามารถอ่านได้ ให้เพิ่มไฟล์ด้วย git add และคอมมิตก่อนเริ่ม Aider

Aider ยังคงสามารถแก้ไขไฟล์ได้ --no-auto-commits ปิดเฉพาะการคอมมิตอัตโนมัติเท่านั้น ไม่ได้ป้องกันการแก้ไขไฟล์ สำหรับการใช้งานครั้งแรก แนะนำให้เลือก repository ที่ไม่สำคัญ และเรียกใช้ git diff หลังงานเสร็จเพื่อตรวจสอบการเปลี่ยนแปลงจริง

อย่าเขียนคีย์จริงลงในไฟล์โปรเจกต์หรือหน้าเว็บสาธารณะ คีย์ของผู้ให้บริการควรเก็บไว้ใน OmniProxy เท่านั้น หากเกตเวย์ไม่ได้ตรวจสอบคีย์ สามารถกรอก OPENAI_API_KEY เป็นชุดอักขระตัวแทนที่ใช้เฉพาะในเครื่องได้

ตรวจสอบด้วยงานจริง

ตรวจสอบก่อนว่าไฟล์ที่ต้องการอ่านถูกคอมมิตเข้า Git แล้ว จากนั้นเรียกใช้คำสั่งต่อไปนี้ในไดเรกทอรีของโปรเจกต์ โดยต้องเปลี่ยน model ID เป็น ID แบบเต็มจากรายการปัจจุบันของ OmniProxy:

aider --model openai/gemini-3.8-flash --message "บรรทัดแรกของไฟล์นี้คืออะไร? อย่าแก้ไขไฟล์" --no-auto-commits

--message ใช้ส่งงานให้ Aider โดยตรงหนึ่งครั้ง ส่วน --no-auto-commits หมายถึงไม่ให้สร้าง Git commit โดยอัตโนมัติในการทำงานครั้งนี้

เมื่อวันที่ 2026-10-09 ได้ทดสอบด้วย Aider v0.86.2 และสามารถอ่านบรรทัดแรกของไฟล์ที่ติดตามแล้วได้ หาก Git ยังไม่ได้ติดตามไฟล์ Aider จะตอบว่าไม่สามารถเห็นเนื้อหาได้ ซึ่งไม่ได้หมายความว่าที่อยู่ของ API ไม่ถูกต้อง หลังถามคำถามเสร็จแล้ว ให้ตรวจสอบแหล่งที่มาของคำขอและ model ID ในบันทึกการเรียกใช้ของ OmniProxy

เริ่มต้น

เปิด aider ได้

• พบคำสั่ง
• ตัวแปรสภาพแวดล้อมมีผลแล้ว
• อยู่ในไดเรกทอรีโปรเจกต์

งาน

มันอ่านไฟล์แล้ว

• ถามเกี่ยวกับไฟล์ที่เจาะจง
• ดูคำอธิบายของมัน
• โมเดลที่ไม่รู้จักจะแสดงคำเตือน

บันทึก

มองเห็นได้ในเกตเวย์

• แหล่งที่มาคือ Aider
• ID โมเดลตรงกัน
• คีย์ไม่ปรากฏบนหน้าเว็บ

ข้อผิดพลาดที่พบบ่อย

• ไม่พบ aider: ให้เปิดเทอร์มินัลใหม่ก่อน หากติดตั้งโดยตรงผ่าน pip สามารถลองใช้ python -m aider
• เปลี่ยนตัวแปรบน Windows แล้วแต่ยังเชื่อมต่อไปยังที่อยู่เดิม: หลังเรียกใช้ setx ต้องเปิดเทอร์มินัลใหม่ หน้าต่างใหม่จึงจะอ่านค่าตัวแปรที่อัปเดตแล้ว
• ไม่มี openai/ นำหน้าชื่อโมเดล: compatible API กำหนดให้เขียนเป็น openai/<model-name>
• มีคำเตือนเกี่ยวกับโมเดลที่ไม่รู้จัก: นี่เป็นคำเตือนตามปกติและไม่ได้หมายความว่าการเชื่อมต่อล้มเหลว ให้ตรวจสอบต่อว่า OmniProxy ได้รับคำขอหรือไม่
• model ID ไม่ถูกต้อง: คัดลอก ID แบบเต็มจากรายการปัจจุบันของ OmniProxy อีกครั้ง โดยคงคำนำหน้า openai/ และเครื่องหมายทับเดิมใน ID ไว้
• ระบบแจ้งว่าไม่มีเนื้อหาของไฟล์: ตรวจสอบก่อนว่า Git ติดตามไฟล์นั้นแล้ว repository ว่างหรือไฟล์ที่ยังไม่ถูกติดตามจะไม่รวมอยู่ในบริบท

เอกสารอ้างอิงอย่างเป็นทางการ

ดูขั้นตอนการติดตั้งได้ที่ Aider installation ดู environment variables และคำนำหน้าชื่อโมเดลได้ที่ OpenAI compatible APIs และดู model ID ที่ใช้เป็นตัวอย่างได้จาก รายการโมเดล Gemini และ หน้าโมเดลของ xAI

แทนที่ตัววางตำแหน่งทั้งหมดด้วยค่าจากการกำหนดค่า OmniProxy ของคุณ ห้ามเผยแพร่คีย์จริง

ผลลัพธ์ที่บันทึกหรือ HTTP 200 เพียงอย่างเดียวไม่พิสูจน์ความเข้ากันได้เต็มรูปแบบของเอเจนต์ ตรวจสอบแหล่งที่มาและโมเดลในบันทึกการเรียกใช้ของ OmniProxy

แหล่งทางการ · Aider ↗