ทำงานแบบ local/private
ค่าเริ่มต้นรันผ่าน Docker บนเครื่องของคุณ ใช้ Qdrant และ Ollama สำหรับ index และ embeddings โดยไม่จำเป็นต้องส่งโค้ดออกนอกเครื่อง
คู่มือสำหรับนักพัฒนา Windows + AI Coding
SocratiCode ช่วยเปลี่ยน AI จากผู้ช่วยที่ต้องเดาโครงสร้างโปรเจกต์ ให้กลายเป็นผู้ร่วมงานที่ค้นหา dependency, วิเคราะห์ผลกระทบ และเข้าใจ flow ของระบบได้ก่อนแก้จริง คู่มือนี้พาคุณติดตั้งบน Windows ผ่าน npm/npx และเริ่มใช้กับ workflow สร้างเว็บ แก้บั๊ก และเรียนรู้โค้ดในโปรเจกต์จริง
SocratiCode คือ codebase intelligence engine ที่ทำงานเป็น MCP server เพื่อช่วยให้ AI assistant เข้าใจโค้ดทั้งโปรเจกต์ได้ลึกขึ้น ไม่ใช่แค่อ่านไฟล์ทีละไฟล์ แต่สามารถค้นหา วิเคราะห์ dependency และเชื่อมโยงบริบทของระบบได้เป็นโครงสร้าง
ค่าเริ่มต้นรันผ่าน Docker บนเครื่องของคุณ ใช้ Qdrant และ Ollama สำหรับ index และ embeddings โดยไม่จำเป็นต้องส่งโค้ดออกนอกเครื่อง
ใช้ได้กับ AI coding tools ที่รองรับ MCP เช่น Codex CLI, Claude Desktop, Windsurf, Cline, Roo Code และ host อื่น ๆ
เหมาะกับ repo ขนาดกลางถึงใหญ่ โดยเฉพาะโปรเจกต์ที่ AI ต้องเข้าใจ architecture ก่อนแก้โค้ดหรือเพิ่มฟีเจอร์
จุดแข็งคือทำให้ AI มีเครื่องมือค้นหาและวิเคราะห์โค้ดที่ฉลาดกว่า grep ธรรมดา เหมาะกับคำถามเชิงระบบ เช่น feature นี้อยู่ตรงไหน แก้ไฟล์นี้จะกระทบอะไร หรือ flow การทำงานเริ่มจากจุดไหน
ค้นหาได้ทั้งแบบ semantic และ keyword เหมาะกับคำถามที่ไม่ได้ตรงกับชื่อฟังก์ชันหรือชื่อไฟล์แบบเป๊ะ ๆ
ช่วยให้ AI มองเห็นความสัมพันธ์ของโมดูล ไฟล์ import และการพึ่งพากันใน codebase
ใช้วิเคราะห์ว่าเมื่อแก้ class, function หรือ module หนึ่ง อาจกระทบส่วนใดของระบบบ้าง
ช่วยไล่ flow จาก entry point ไปยังส่วนที่ถูกเรียกต่อ ทำให้เข้าใจระบบก่อนแก้โค้ดได้เร็วขึ้น
หลัง index ครั้งแรก SocratiCode สามารถอัปเดตแบบ incremental และกลับมาใช้ context เดิมได้ในรอบถัดไป
รองรับการค้นหาข้ามโปรเจกต์และช่วยให้หลาย AI agent ใช้ index ร่วมกันได้
สำหรับงานสร้างเว็บหรือแก้โค้ดจริง ความต่างที่เห็นชัดคือ AI เสียเวลาน้อยลงกับการเดาโครงสร้างโปรเจกต์ และมีวิธีค้นหาบริบทที่ตรงคำถามมากขึ้น
วิธีที่ง่ายที่สุดสำหรับนักพัฒนาคือเรียก SocratiCode ผ่าน npm/npx แต่เบื้องหลังยังต้องใช้ Docker เพราะ SocratiCode จะจัดการ Qdrant และ Ollama container ให้โดยอัตโนมัติในครั้งแรก
ติดตั้ง Docker Desktop for Windows และเปิดให้ทำงานอยู่ก่อนเริ่มใช้งาน SocratiCode
ใช้ Node.js เวอร์ชัน 18 หรือใหม่กว่า เพื่อให้คำสั่ง npx เรียกแพ็กเกจได้ถูกต้อง
เช่น OpenAI Codex CLI หรือ MCP host อื่นที่สามารถเพิ่ม server ผ่าน command และ args ได้
node -v
npm -v
docker --versionบน Windows ให้เปิด Docker Desktop ให้พร้อมก่อนใช้งานครั้งแรก เพราะ SocratiCode จะต้อง pull image, start container และดาวน์โหลด embedding model ในขั้นตอนเริ่มต้น
ให้คิดง่าย ๆ ว่าเรากำลังเพิ่ม SocratiCode เข้าไปเป็นผู้ช่วยเบื้องหลังของ AI client เมื่อเปิดใช้งานแล้ว AI จะสามารถเรียก SocratiCode เพื่อ index และค้นหาข้อมูลใน codebase ได้ ทำตามลำดับด้านล่างนี้ได้เลย
SocratiCode ต้องใช้ Docker เพื่อรันบริการที่จำเป็นเบื้องหลัง ให้เปิด Docker Desktop แล้วรอจนสถานะพร้อมใช้งานก่อนค่อยไปขั้นถัดไป
node -v
npm -v
docker --version
เปิดไฟล์ config ของ AI client ที่คุณใช้ แล้วเพิ่ม server ชื่อ socraticode
โดยให้เรียกผ่าน npx -y socraticode
"socraticode": {
"command": "npx",
"args": ["-y", "socraticode"]
}สำหรับ Codex CLI ให้เพิ่ม block ด้านล่างในไฟล์ config ของ Codex จากนั้นปิดและเปิด Codex ใหม่หนึ่งครั้ง เพื่อให้ Codex โหลด MCP server ตัวใหม่
[mcp_servers.socraticode]
command = "npx"
args = ["-y", "socraticode"]หลัง restart แล้ว ให้เปิดโปรเจกต์ที่ต้องการใช้งาน จากนั้นบอก AI ให้ index codebase ครั้งแรกอาจใช้เวลาสักพัก เพราะ SocratiCode ต้องเตรียม container และสร้างข้อมูลค้นหา
Index this codebaseระหว่างรอ indexing คุณถามสถานะได้ ถ้า index เสร็จแล้ว ก็เริ่มถาม AI เกี่ยวกับ architecture, dependency, flow หรือ impact ของการแก้โค้ดได้ทันที
What is the codebase index status?หลัง index เสร็จแล้ว ให้ใช้ SocratiCode เป็นชั้นความเข้าใจ codebase ก่อนสั่ง AI แก้โค้ดจริง โดยเฉพาะงานสร้างเว็บ แก้บั๊ก refactor หรือเรียนรู้โปรเจกต์ใหม่
สรุป architecture ของโปรเจกต์นี้จาก SocratiCode index
แล้วบอก entry points และ module สำคัญค้นหาว่า logic สำหรับ authentication อยู่ส่วนไหน
และไฟล์ใดเกี่ยวข้องมากที่สุดก่อนแก้ module นี้ ช่วยวิเคราะห์ impact ว่าอาจกระทบไฟล์
function หรือ workflow ใดบ้างดูโครงสร้าง frontend ปัจจุบัน แล้วเพิ่มหน้าใหม่ให้ตาม pattern เดิม
ก่อนแก้ให้บอกไฟล์ที่จะเกี่ยวข้องและเหตุผลปัญหาส่วนใหญ่เกิดจาก Docker ยังไม่รัน Node.js เวอร์ชันต่ำ หรือ MCP host ยังไม่ได้ restart หลังแก้ config
เปิด Docker Desktop แล้วรอจนสถานะพร้อมใช้งาน จากนั้น restart AI client อีกครั้ง
อัปเดต Node.js เป็นเวอร์ชันใหม่ แล้วตรวจด้วย node -v ก่อนลองใหม่
ใช้ socraticode@latest ใน args ได้ หากต้องการให้ตรวจเวอร์ชันล่าสุดตอนเริ่ม server
"socraticode": {
"command": "npx",
"args": ["-y", "socraticode@latest"]
}ใช้ SocratiCode เป็นเครื่องมือค้นหาและวิเคราะห์ก่อนให้ AI ลงมือแก้จริง เพื่อให้การตัดสินใจมีบริบทมากขึ้น
จำเป็นสำหรับค่าเริ่มต้น เพราะ SocratiCode ใช้ Docker เพื่อจัดการ Qdrant และ Ollama ให้แบบอัตโนมัติ
ค่าเริ่มต้นไม่ต้องใช้ API key เพราะทำงาน local ผ่าน Docker แต่สามารถตั้งค่า cloud embeddings เพิ่มเองได้ถ้าต้องการความเร็วหรือ workflow เฉพาะทาง
ค่าเริ่มต้นทำงานบนเครื่องของคุณ และไม่จำเป็นต้องส่งโค้ดออกไปยังบริการภายนอก เว้นแต่คุณตั้งค่า provider ภายนอกเอง
ใช้ได้ผ่าน MCP config โดยเพิ่ม server ชื่อ SocratiCode และเรียก command เป็น npx พร้อม args ["-y", "socraticode"]
ไม่จำเป็นต้อง index เต็มทุกครั้ง หลังจาก index ครั้งแรก SocratiCode จะใช้ข้อมูลเดิมและอัปเดตเฉพาะส่วนที่เปลี่ยนตามความสามารถของ watcher และ incremental indexing
ใช้ได้ แต่จะเห็นประโยชน์ชัดขึ้นในโปรเจกต์ที่มีหลาย module, dependency ซับซ้อน หรือมี codebase ที่ AI ต้องทำความเข้าใจก่อนแก้
เราใช้คุกกี้เพื่อพัฒนาประสิทธิภาพ และประสบการณ์ที่ดีในการใช้เว็บไซต์ของคุณ คุณสามารถศึกษารายละเอียดได้ที่ นโยบายความเป็นส่วนตัว และสามารถจัดการความเป็นส่วนตัวเองได้ของคุณได้เองโดยคลิกที่ ตั้งค่า