# OpenCode: การติดตั้ง โมเดล และการเริ่มต้นใช้งานครั้งแรก > การติดตั้งบน macOS, Linux และ Windows, OpenCode 1.x และ 2.0, การเชื่อมต่อผู้ให้บริการและ Ollama, การกำหนดค่า ค่าใช้จ่าย และการแก้ไขปัญหา Source: https://ailoot.ai/blog/th/opencode-installation-models/ Canonical: https://ailoot.ai/blog/th/opencode-installation-models/ Language: th Publisher: Ailoot (https://ailoot.ai/) Translation: guide-190 Revision: sha256-9c49abc65c74d788d72a53682e4187f131eb3e5d5daaebb06ec65e503b117f49 OpenCode คือเอเจนต์เขียนโค้ด AI แบบโอเพนซอร์สสำหรับเทอร์มินัล: ตัวเครื่องมือใช้ฟรี (สัญญาอนุญาต MIT) และคุณเชื่อมต่อโมเดลใดก็ได้ ตั้งแต่ Claude และ GPT ไปจนถึงโมเดลในเครื่องผ่าน Ollama คลังโปรเจกต์นี้มีดาวบน GitHub เกินสองแสนดวงแล้ว วลี “Claude Code ฟรีที่ใช้กับโมเดลใดก็ได้” ฟังดูน่าสนใจ แต่ต้องชี้แจงให้ชัดว่าเครื่องมือฟรี ส่วนเงื่อนไขการใช้งานขึ้นอยู่กับโมเดลที่คุณเลือก ด้านล่างนี้คือข้อมูลทั้งหมดตามเอกสารอย่างเป็นทางการ: เครื่องมือนี้คืออะไร ติดตั้งบน macOS, Linux หรือ Windows อย่างไร เชื่อมต่อโมเดลอย่างไร และควรทำอะไรเมื่อเปิดใช้งานครั้งแรก มีหัวข้อค่าใช้จ่ายแยกต่างหาก เพราะคำว่า “ฟรี” ในที่นี้ใช้กับตัวเครื่องมือเท่านั้น โมเดลมีค่าใช้จ่าย และนี่คือสิ่งที่ทำให้เกิดความสับสนบ่อยที่สุด [ข้อมูลที่ใช้ได้จริงเกี่ยวกับการทำงานกับ Ailoot อยู่ในเอกสารประกอบ](https://ailoot.ai/docs/) ## OpenCode คืออะไร อธิบายง่าย ๆ ได้อย่างไร?
ประเด็นสำคัญ OpenCode คือเอเจนต์เขียนโค้ด AI แบบโอเพนซอร์ส (สัญญาอนุญาต MIT) จากทีม Anomaly ทำงานในเทอร์มินัล และยังมีให้ใช้เป็นแอปเดสก์ท็อป ส่วนขยายสำหรับเอดิเตอร์ และเวอร์ชันเว็บ คุณบอกว่าต้องการให้ทำอะไรในโปรเจกต์ แล้วเอเจนต์จะอ่านไฟล์ แก้โค้ด และเรียกใช้คำสั่งเอง ตัวเครื่องมือใช้ฟรี คุณเชื่อมต่อโมเดลของคุณเองได้ ทั้งโมเดลบนคลาวด์หรือโมเดลในเครื่อง
พูดสั้น ๆ คือ OpenCode ทำสิ่งเดียวกับ Claude Code: รับงานเป็นภาษาธรรมดาแล้วลงมือทำในโปรเจกต์ของคุณ ทั้งสองต่างกันอยู่สองด้าน โค้ดเปิดเผยทั้งหมด คุณจึงอ่านและตรวจสอบได้ และเครื่องมือไม่ได้ผูกกับผู้ให้บริการโมเดลรายเดียว แต่ทำงานกับผู้ให้บริการมากกว่า 75 ราย ตั้งแต่ Anthropic และ OpenAI ไปจนถึงโมเดลในเครื่องที่ทำงานบนฮาร์ดแวร์ของคุณ ทีม Anomaly เป็นผู้พัฒนาโปรเจกต์นี้ คลังถูกสร้างเมื่อวันที่ 30 เมษายน 2025 และ ณ วันที่ 4 ตุลาคม 2026 มี [ดาวมากกว่า 211,000 ดวงและ forks 28,000 รายการ](https://github.com/anomalyco/opencode) (ตรวจสอบด้วยคำขอ GitHub API) ภาษาที่ใช้คือ TypeScript เอกสารประกอบได้รับการปรับปรุงอย่างต่อเนื่อง ดังนั้นคำแนะนำด้านล่างจึงอ้างอิงเวอร์ชันปัจจุบัน อย่าสับสนกับชื่อ: แพ็กเกจ npm สำหรับสายเวอร์ชันปัจจุบันชื่อ `opencode-ai` คลังชื่อ `anomalyco/opencode` และคำสั่งในเทอร์มินัลคือ `opencode` บทความเก่าอาจใช้ที่อยู่ `sst/opencode`: องค์กรเปลี่ยนชื่อแล้ว และลิงก์เดิมเปลี่ยนเส้นทางไปยังลิงก์ใหม่ **อัปเดต 4 ตุลาคม 2026:** ทีมเปิดตัว OpenCode 2.0 ซึ่งเป็นรุ่นหลักเจเนอเรชันถัดไปของเครื่องมือ คำแนะนำการติดตั้งและการเชื่อมต่อโมเดลด้านล่างยังเขียนสำหรับสาย 1.x ปัจจุบัน (ติดตั้งด้วยคำสั่ง `curl -fsSL https://opencode.ai/install | bash`; เวอร์ชันปัจจุบัน ณ วันที่ 30 กันยายน 2026 คือ 1.18.34): เวอร์ชันนี้ยังได้รับการสนับสนุนอย่างต่อเนื่อง และเป็นเวอร์ชันที่ติดตั้งตามเอกสารอย่างเป็นทางการที่ opencode.ai/docs ส่วนที่แยกไว้ด้านล่างจะอธิบายว่าเวอร์ชันที่สองเปลี่ยนอะไรบ้างและควรเปลี่ยนไปใช้เมื่อใด ## OpenCode แตกต่างจาก Claude Code และ Codex อย่างไร?
ประเด็นสำคัญ Claude Code ใช้ได้เฉพาะกับโมเดลของ Anthropic ส่วน Codex เป็นเอเจนต์ของ OpenAI ที่ผูกกับระบบนิเวศ ChatGPT OpenCode เป็นเครื่องมือเปิดที่ไม่ผูกติดกับผู้ให้บริการ: ใช้ฟรี คุณเลือกโมเดลจากผู้ให้บริการกว่า 75 ราย รวมถึงการสมัครสมาชิก ChatGPT Plus และ GitHub Copilot ตลอดจนโมเดลในเครื่องได้
| คุณสมบัติ | OpenCode | Claude Code | Codex | |----|----|----|----| | โค้ด | เปิด, MIT | ปิด | เปิด | | โมเดล | ผู้ให้บริการกว่า 75 รายและโมเดลในเครื่อง | เฉพาะ Claude | โมเดล OpenAI | | ราคาเครื่องมือ | ฟรี | การสมัครสมาชิกหรือโทเค็น | การสมัคร ChatGPT หรือโทเค็น | | การเข้าถึงผ่านการสมัครสมาชิก | ChatGPT Plus, GitHub Copilot, GitLab Duo | Claude Pro/Max (การสมัครของตนเอง) | ChatGPT (การสมัครของตนเอง) | | ใช้งานที่ไหน | เทอร์มินัล, เดสก์ท็อป, เอดิเตอร์, เบราว์เซอร์ | เทอร์มินัลและเอดิเตอร์ | เทอร์มินัล, เว็บ, เอดิเตอร์ | | การกำหนดค่าโปรเจกต์ | AGENTS.md | CLAUDE.md | AGENTS.md | หากคุณมีการสมัคร Claude อยู่แล้ว การใช้ Claude Code เป็นเครื่องมือหลักต่อไปก็สมเหตุสมผล เรามี[คู่มือติดตั้งโดยละเอียด](https://ailoot.ai/blog/th/install-claude-code/) หากต้องการทำงานผ่านการสมัคร ChatGPT Plus หรือ GitHub Copilot ใช้โมเดลในเครื่องโดยไม่มีค่า API หรือมีอินเทอร์เฟซเดียวสำหรับหลายโมเดล OpenCode ก็เหมาะเช่นกัน นอกจากนี้เรายังมี[รีวิวและคู่มือติดตั้ง](https://ailoot.ai/blog/th/openai-codex-install/)สำหรับ Codex หากยังเลือกเครื่องมืออยู่ ให้เริ่มจากภาพรวมนี้: [ผู้คนใช้เครื่องมืออะไรเขียนโค้ดในปี 2026](https://ailoot.ai/blog/th/ai-coding-tools/) และหากติดตั้ง OpenCode ไว้แล้วและต้องการเชื่อมต่อกับเอเจนต์อื่นใน Devin Desktop ผ่าน ACP โปรดดู[คู่มือการตั้งค่านั้น](https://ailoot.ai/blog/th/codex-claude-agent-opencode-devin-desktop-acp/) ## OpenCode 2.0 เปลี่ยนอะไรบ้าง?
ประเด็นสำคัญ ณ วันที่ 4 ตุลาคม 2026 OpenCode 2.0 พร้อมให้ใช้งานที่ opencode.ai โดยมีตัวติดตั้งของตัวเองและแพ็กเกจ npm ใหม่ชื่อ `@opencode/cli` เวอร์ชันแรก ซึ่งเป็นเวอร์ชันที่บทความนี้ติดตั้ง ยังไม่ได้หายไป: เป็นสาขา `V1` แยกต่างหากในเอกสาร ได้รับการสนับสนุนอย่างต่อเนื่อง และยังเป็นตัวเลือกเริ่มต้น ใน v2 มีสามส่วนที่นักพัฒนาตั้งใจไม่รักษาความเข้ากันได้กับเวอร์ชันแรก ได้แก่ plugin API, โปรโตคอลเซิร์ฟเวอร์ และไฟล์ตั้งค่าเทอร์มินัล
ติดตั้งเวอร์ชันที่สองด้วยคำสั่ง `curl -fsSL https://opencode.ai/v2/install | bash` ตามคู่มือย้ายเวอร์ชันอย่างเป็นทางการ (`opencode.ai/v2/docs/migrate-v1`) ทั้งสองเวอร์ชันใช้คำสั่ง `opencode` เดียวกัน และโดยค่าเริ่มต้นจะไม่ติดตั้งควบคู่กันอีกต่อไป: ตัวติดตั้ง v2 จะแทนที่ไบนารี v1 และก่อนติดตั้ง v2 ผ่านตัวจัดการแพ็กเกจ เอกสารระบุชัดเจนให้ลบเวอร์ชัน v1 ก่อน อย่างไรก็ตาม ทั้งสองเวอร์ชันอ่านการกำหนดค่าจากไฟล์ชุดเดียวกัน คือ `~/.config/opencode/` และ `/.opencode/` ดังนั้นการตั้งค่า เอเจนต์ และเซิร์ฟเวอร์ MCP จึงย้ายไปได้โดยไม่ต้องเขียนใหม่ มีสามสิ่งที่ต้องเขียนใหม่: ปลั๊กอิน (มี API ใหม่), การผสานรวมกับ server API (โปรโตคอลเปลี่ยนไป) และการตั้งค่าเทอร์มินัล (ตอนนี้ใช้ไฟล์ `cli.json` ร่วมกันไฟล์เดียว แทนไฟล์ `tui.json` หลายไฟล์) คุณสมบัติใหม่ที่โดดเด่นที่สุดสองอย่างใน v2 มีดังนี้ อย่างแรกคือ Console บริการแบบชำระเงินสำหรับทีมที่มีการติดตามการใช้งาน งบประมาณ และนโยบายร่วมสำหรับสมาชิกทุกคน อย่างที่สอง ทีมประกาศราคาการสมัคร Go ในที่สุด: \$10 ต่อเดือนสำหรับ Go และ \$40 ต่อเดือนสำหรับ Go Plus ที่มีขีดจำกัดสูงกว่า (หน้า `opencode.ai/go` ตรวจสอบเมื่อวันที่ 4 ตุลาคม 2026) ก่อนหน้านี้เอกสารเพียงระบุว่าเป็น “การสมัครราคาประหยัด” โดยไม่แจ้งตัวเลข หากเพิ่งเริ่มต้นและต้องการติดตั้งเอเจนต์เท่านั้น ให้ทำตามคำแนะนำด้านล่าง ซึ่งครอบคลุมเวอร์ชันแรกปัจจุบันที่เอกสารแนะนำเอง พิจารณาใช้ v2 หากต้องการคุณสมบัติปลั๊กอินใหม่หรือ Console สำหรับทีม แต่เตรียมเขียนปลั๊กอินเก่าบางตัวใหม่ให้ใช้ API ใหม่ หากสนใจแอปเดสก์ท็อปโอเพนซอร์สที่ไม่ต้องใช้เทอร์มินัลมากกว่า เรามี[รีวิว ZCode](https://ailoot.ai/blog/th/zcode-claude-code-alternative/) ซึ่งเป็นเอเจนต์ลักษณะคล้ายกันที่มีอินเทอร์เฟซของตัวเอง ## ต้องเตรียมอะไรก่อนติดตั้ง?
ประเด็นสำคัญ คุณต้องมีสองอย่าง: โปรแกรมจำลองเทอร์มินัลรุ่นใหม่ (เอกสารระบุ WezTerm, Alacritty, Ghostty หรือ Kitty) และสิทธิ์เข้าถึงโมเดล ไม่ว่าจะเป็น API key ของผู้ให้บริการ การสมัครสมาชิกที่รองรับ หรือโมเดลในเครื่องผ่าน Ollama คุณจะต้องใช้โมเดลหลังติดตั้ง โดยจะเชื่อมต่อในครั้งแรกที่เปิดใช้งาน
ขออธิบายเรื่องเทอร์มินัลเพิ่มเติม เพราะเป็นจุดเดียวที่การติดตั้งอาจไม่เป็นไปตามแผน OpenCode แสดงอินเทอร์เฟซเต็มรูปแบบพร้อมแผงและการเน้นข้อความในเทอร์มินัล เอกสารจึงขอให้ใช้โปรแกรมจำลองรุ่นใหม่ หากอินเทอร์เฟซดูผิดปกติหลังเปิดใช้งาน ให้ติดตั้งหนึ่งในสี่ตัวเลือกที่ระบุไว้ก่อน ได้แก่ WezTerm (ใช้ได้ทุกระบบ), Alacritty, Ghostty หรือ Kitty บน Windows เส้นทางหลักคือผ่าน WSL ซึ่งมีหัวข้อของตัวเองด้านล่าง อีกสิ่งหนึ่งคือโมเดล OpenCode ทำงานผ่านโมเดลที่คุณเชื่อมต่อ โดยตัวมันเองไม่ได้ประมวลผลคำขอ มีสี่ตัวเลือก ได้แก่ การสมัครสมาชิก (ChatGPT Plus, GitHub Copilot, GitLab Duo), API key จากผู้ให้บริการใดก็ได้, OpenCode Zen ซึ่งเป็นตัวรวบรวมของทีมเอง หรือโมเดลในเครื่องผ่าน Ollama ตัวเลือกทั้งสี่จะอธิบายในหัวข้อการเชื่อมต่อโมเดล หากไม่มีคำอธิบายโปรเจกต์ เอเจนต์ต้องเดาคำสั่ง build โครงสร้างไฟล์ และแนวทางที่ใช้อยู่ จึงเกิด “ภาพหลอน” OpenCode ใช้ไฟล์ AGENTS.md สำหรับเรื่องนี้ แนวทางเดียวกันใช้ได้กับ Claude Code และเอเจนต์อื่น ๆ ชื่อไฟล์คำแนะนำเท่านั้นที่ต่างกัน ## ติดตั้ง OpenCode บน macOS และ Linux อย่างไร?
ประเด็นสำคัญ ใช้คำสั่งเดียวในเทอร์มินัล: curl -fsSL \| bash เอกสารระบุว่านี่เป็นวิธีที่ง่ายที่สุด ทางเลือกอื่น: brew install anomalyco/tap/opencode, npm install -g opencode-ai และบน Arch Linux ใช้ pacman หรือ paru
วิธีที่แนะนำคือใช้ตัวติดตั้งอย่างเป็นทางการ: 1. ### เรียกใช้ตัวติดตั้ง ```bash curl -fsSL https://opencode.ai/install | bash ``` สคริปต์ตรวจหาระบบของคุณและดาวน์โหลด OpenCode หากไม่พบคำสั่งหลังติดตั้ง ให้ปิดแล้วเปิดเทอร์มินัลใหม่ ระบบจะค้นพบ path ในเซสชันใหม่ 2. ### ตรวจสอบว่าติดตั้งสำเร็จ ```bash opencode --version ``` คำสั่งจะแสดงหมายเลขเวอร์ชัน ซึ่งหมายความว่าติดตั้งสำเร็จ หากได้รับข้อความ “command not found” ให้กลับไปทำขั้นแรก: เริ่มเซสชันเทอร์มินัลใหม่หรือแก้ PATH ด้วยตนเอง หากต้องการจัดการแพ็กเกจเอง มีตัวเลือกดังนี้: ```bash brew install anomalyco/tap/opencode ``` ```bash npm install -g opencode-ai ``` คำสั่ง Homebrew เริ่มด้วย `anomalyco/tap/` โดยตั้งใจ: เอกสารแนะนำ tap ของทีม เพราะทีม Homebrew อัปเดตสูตรสำหรับ `brew install opencode` ไม่บ่อยเท่า ชื่อแพ็กเกจเดียวกันคือ `opencode-ai` ยังใช้ได้กับ bun, pnpm และ yarn (`bun install -g opencode-ai`, `yarn global add opencode-ai`) บน Arch Linux ใช้ `sudo pacman -S opencode` จากคลัง stable หรือ `paru -S opencode-bin` เพื่อรับเวอร์ชันล่าสุดจาก AUR อัปเดต OpenCode ด้วย `opencode upgrade`; เมื่อเปิดใช้งาน โปรแกรมจะดาวน์โหลดอัปเดตเองด้วยหากเปิดการอัปเดตอัตโนมัติไว้ หลังอัปเดต ตรวจสอบเวอร์ชันด้วยคำสั่งเดิม `opencode --version` นอกจากนี้ยังมีคำสั่งถอนการติดตั้งในตัว: ```bash opencode uninstall ``` คำสั่งจะแสดงสิ่งที่จะลบอย่างชัดเจนและขอการยืนยัน หากต้องการ คุณสามารถเก็บการกำหนดค่าและข้อมูลเซสชันไว้ได้โดยใช้แฟล็ก `--keep-config` และ `--keep-data` ## ติดตั้ง OpenCode บน Windows อย่างไร?
ประเด็นสำคัญ เอกสารแนะนำ WSL เพื่อประสิทธิภาพและความเข้ากันได้อย่างเต็มที่: ติดตั้ง Windows Subsystem for Linux แล้วติดตั้ง OpenCode ภายใน WSL ด้วยคำสั่ง Linux ตามปกติ หากไม่ใช้ WSL ก็เลือก Chocolatey (`choco install opencode`), Scoop (`scoop install opencode`), npm หรือแอปเดสก์ท็อปได้
ตัวเลือกแรกที่นักพัฒนาแนะนำเองคือ WSL ติดตั้งด้วยคำสั่งเดียวใน PowerShell ที่เปิดสิทธิ์ผู้ดูแลระบบ: ```powershell wsl --install ``` หลังรีบูต เปิด Ubuntu จากเมนู Start แล้วเรียกใช้คำสั่งเดิมภายในนั้น: ```bash curl -fsSL https://opencode.ai/install | bash ``` ไฟล์ในไดรฟ์ Windows ใช้ได้จาก WSL ผ่าน `/mnt/` โดยไดรฟ์ C: อยู่ที่ `/mnt/c/` และไดรฟ์ D: อยู่ที่ `/mnt/d/` ดังนั้นจึงเปิดโปรเจกต์ที่ `C:\Users\Name\project` ได้ดังนี้: ```bash cd /mnt/c/Users/Name/project opencode ``` ตัวเลือกที่สองคือข้าม WSL แล้วใช้ตัวจัดการแพ็กเกจของ Windows ใน PowerShell: ```powershell choco install opencode ``` ```powershell scoop install opencode ``` ตัวเลือกที่สามคือแอปเดสก์ท็อปและเวอร์ชันเว็บ แอปติดตั้งเหมือนโปรแกรมทั่วไปและแสดงอินเทอร์เฟซในหน้าต่างโดยไม่ต้องใช้เทอร์มินัล เวอร์ชันเว็บเริ่มด้วยคำสั่ง `opencode web`: คำสั่งนี้เปิด OpenCode ในเบราว์เซอร์ และเอกสารแนะนำให้เปิดจาก WSL ด้วย เพื่อหลีกเลี่ยงปัญหาการเข้าถึงไฟล์ เอกสารยังระบุตัวเลือกที่พบไม่บ่อย ได้แก่ mise, Docker และไบนารีสำเร็จรูปจากหน้า GitHub releases การติดตั้งผ่าน bun บน Windows ยังอยู่ระหว่างพัฒนา หาก bun เป็นตัวจัดการแพ็กเกจหลัก ให้ใช้ตัวเลือก npm ## เชื่อมต่อโมเดลกับ OpenCode อย่างไร?
ประเด็นสำคัญ ในอินเทอร์เฟซเทอร์มินัล พิมพ์ `/connect` แล้วเลือกผู้ให้บริการจากรายการ: OpenCode Zen เพื่อเริ่มต้นโดยไม่ต้องมีคีย์ของตัวเอง, Anthropic หรือ OpenAI ด้วย API key, ChatGPT Plus หรือ GitHub Copilot ด้วยการสมัครสมาชิก หรือ Ollama สำหรับโมเดลในเครื่อง คีย์จะถูกบันทึกในไฟล์ auth.json; เลือกโมเดลที่ต้องการด้วย `/models`
OpenCode รองรับผู้ให้บริการกว่า 75 รายผ่าน AI SDK และ Models.dev รวมถึงโมเดลในเครื่อง ส่วนใหญ่เชื่อมต่อด้วยคำสั่ง `/connect` ภายในอินเทอร์เฟซ สำหรับโมเดลในเครื่องต้องระบุที่อยู่เซิร์ฟเวอร์ในการกำหนดค่าด้วย ตัวเลือกต่างกันทั้งวิธีชำระเงินและข้อกำหนดด้านคอมพิวเตอร์: | ตัวเลือก | คืออะไร | ค่าใช้จ่าย | |----|----|----| | OpenCode Zen | ตัวรวบรวมโมเดลที่ทีม OpenCode ตรวจสอบแล้ว | จ่ายต่อคำขอ เติมเงินเข้ายอดคงเหลือ | | OpenCode Go | แผนสมัครสมาชิกสำหรับโมเดลเปิดจากทีม | \$10 ต่อเดือน (Go) หรือ \$40 ต่อเดือน (Go Plus, ขีดจำกัดสูงกว่า) | | API key | Anthropic, OpenAI, Google, DeepSeek และรายอื่น ๆ | จ่ายให้ผู้ให้บริการตามการใช้งาน | | การสมัครสมาชิก | ChatGPT Plus, GitHub Copilot, GitLab Duo | ชำระไว้แล้ว | | Ollama / LM Studio | โมเดลในเครื่องของคุณ | ไม่มีค่า API แต่ต้องมีคอมพิวเตอร์ที่มีประสิทธิภาพพอสมควร | เอกสารแนะนำให้ผู้เริ่มต้นใช้ OpenCode Zen ก่อน ทีมคัดเลือกโมเดลที่ทำงานได้ดีเป็นพิเศษในฐานะเอเจนต์ และทดสอบการทำงานร่วมกับผู้ให้บริการด้วยงานของทีมเอง. ขั้นตอนเชื่อมต่อคือ พิมพ์ `/connect` เลือก OpenCode Zen ลงชื่อเข้าใช้และเพิ่มวิธีชำระเงินที่ opencode.ai/auth รับคีย์แล้ววางลงไป จากนั้น `/models` จะแสดงรายชื่อโมเดลที่แนะนำ ณ วันที่ 4 ตุลาคม 2026 รายชื่อดังกล่าวมีตัวอย่างเช่น GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 และ Kimi K2.5 เอกสารเตือนอย่างตรงไปตรงมาว่ารายชื่อไม่ครอบคลุมทั้งหมดและล้าสมัยได้อย่างรวดเร็ว เพราะมีโมเดลใหม่ออกทุกสัปดาห์ เชื่อมต่อการสมัครสมาชิกด้วยคำสั่ง `/connect` เดียวกัน: เลือก ChatGPT Plus หรือ GitHub Copilot จากรายการแล้วลงชื่อเข้าใช้บัญชี ไม่ต้องตั้งค่าเพิ่มเติม หากเลือก Anthropic คำสั่ง `/connect` จะเสนอทางเลือกสองแบบ: ป้อน API key ด้วยตนเอง หรือเลือก Claude Pro/Max แล้วพิสูจน์ตัวตนผ่านเบราว์เซอร์ อย่างไรก็ตาม Anthropic ห้ามใช้ปลั๊กอินของบุคคลที่สามเพื่อใช้งานการสมัคร Claude Pro/Max และปลั๊กอินในตัวลักษณะนี้ถูกนำออกจาก OpenCode ตั้งแต่เวอร์ชัน 1.3.0 หากพบบทความเก่าที่พูดถึง “OpenCode ผ่านการสมัคร Claude” บทความนั้นหมายถึงปลั๊กอินที่ถูกนำออกแล้ว ไม่ใช่การอนุญาตอย่างเป็นทางการ การสมัคร ChatGPT Plus, GitHub Copilot, GitLab Duo (ระบุว่าเป็นฟีเจอร์ทดลอง) และ Atomic Chat ใช้ได้โดยไม่ต้องตั้งค่าเพิ่ม OpenCode เก็บคีย์ที่ป้อนผ่าน `/connect` ไว้ในไฟล์ `~/.local/share/opencode/auth.json` หากไม่ต้องการเลือกโมเดลทุกครั้ง ให้ตั้งโมเดลเริ่มต้นในไฟล์กำหนดค่า `opencode.json` ที่รูทของโปรเจกต์: ```json { "$schema": "https://opencode.ai/config.json", "model": "anthropic/claude-sonnet-4-5" } ``` รูปแบบคือ `provider/model`; ตัวระบุทั้งสองแสดงอยู่ในผลลัพธ์ของ `/models` ## เชื่อมต่อโมเดลในเครื่องผ่าน Ollama อย่างไร?
ประเด็นสำคัญ ติดตั้ง Ollama จาก ollama.com แล้วดาวน์โหลดโมเดลด้วยคำสั่ง `ollama pull` — Ollama ตั้งค่าตัวเองให้ใช้กับ OpenCode ได้โดยอัตโนมัติ วิธีตั้งค่าด้วยตนเองคือเพิ่มผู้ให้บริการใน `opencode.json` โดยใช้ที่อยู่เซิร์ฟเวอร์ในเครื่อง เลือกโมเดลด้วย `/models` หากเอเจนต์ไม่เรียกใช้เครื่องมือ ให้เพิ่ม `num_ctx` ใน Ollama เป็น 16k–32k
ตัวเลือกนี้หมายถึงไม่มีค่า API เลย เพราะโมเดลทำงานบนคอมพิวเตอร์ของคุณ หากกำลังเลือกโมเดลฟรีโดยทั่วไป เรามี[รีวิวแยกต่างหาก](https://ailoot.ai/blog/th/free-coding-models/) ว่าโมเดลใดทำงานเป็นเอเจนต์ได้ดีพอสมควร และโมเดลใดทำได้แค่บนกระดาษ สำหรับ OpenCode ให้ติดตั้ง Ollama จากเว็บไซต์ทางการและดาวน์โหลดโมเดล: ```bash ollama pull qwen3-coder ``` รายละเอียดที่มีประโยชน์จากเอกสารคือ Ollama ตั้งค่าตัวเองให้ใช้กับ OpenCode ได้โดยอัตโนมัติ และมีคู่มือการผสานรวมแยกต่างหาก หากต้องการตั้งค่าทุกอย่างด้วยตนเอง ให้เพิ่มผู้ให้บริการพร้อมที่อยู่ของเซิร์ฟเวอร์ Ollama ในเครื่องลงใน `opencode.json`: ```json { "$schema": "https://opencode.ai/config.json", "provider": { "ollama": { "npm": "@ai-sdk/openai-compatible", "name": "Ollama (local)", "options": { "baseURL": "http://localhost:11434/v1" }, "models": { "qwen3-coder": { "name": "Qwen3 Coder" } } } } } ``` จากนั้น `/models` ในอินเทอร์เฟซจะแสดงโมเดลในเครื่องในรายการ เลือกโมเดลแล้วเริ่มทำงานได้เลย ข้อควรทราบเชิงปฏิบัติจากเอกสาร: หากเอเจนต์หยุดเรียกใช้เครื่องมือ (แก้ไฟล์หรือเรียกใช้คำสั่ง) ให้เพิ่ม `num_ctx` ในการตั้งค่า Ollama โดยเริ่มที่ค่า 16k–32k โมเดลในเครื่องมีความสามารถด้อยกว่าโมเดลบนคลาวด์โดยเฉพาะกับงานเอเจนต์ และหน้าต่างบริบทขนาดเล็กทำให้แย่ลง หากเวอร์ชันในเครื่องยังไม่เพียงพอ คุณเชื่อมต่อ Qwen บนคลาวด์ด้วยคีย์ได้ ดูวิธีรับคีย์ได้ในคู่มือ [วิธีรับ API key สำหรับ Qwen Code](https://ailoot.ai/blog/th/qwen-code-api-key/) ## OpenCode และการใช้งานมีค่าใช้จ่ายเท่าไร?
ประเด็นสำคัญ ตัว OpenCode เองใช้ฟรี: ซอร์สโค้ดเผยแพร่ภายใต้สัญญาอนุญาต MIT คุณจ่ายเฉพาะค่าโมเดล โดยคิดตามการใช้งานจริงผ่าน API key หรือ Zen ใช้การสมัคร Go ใช้ผ่านการสมัคร ChatGPT Plus หรือ Copilot ของคุณ หรือไม่ต้องจ่ายเลยก็ได้ เพราะคำขอไปยังโมเดลในเครื่องผ่าน Ollama ฟรี
ค่าใช้จ่ายทั้งหมดในที่นี้เป็นค่าโมเดล และมีสี่กรณี หากใช้ API key หรือ Zen คุณจ่ายตามการใช้งานจริง โดยจำนวนเงินขึ้นอยู่กับปริมาณงานที่เอเจนต์ทำ Go เป็นแผนสมัครสมาชิกสำหรับโมเดลเปิดจากทีม OpenCode: \$10 ต่อเดือนสำหรับ Go และ \$40 ต่อเดือนสำหรับ Go Plus ที่มีขีดจำกัดสูงกว่า (ตรวจสอบบนหน้า `opencode.ai/go` เมื่อวันที่ 4 ตุลาคม 2026) ขีดจำกัดขึ้นอยู่กับโมเดล เช่น Go ให้คำขอประมาณ 110 ครั้งต่อ 5 ชั่วโมง (440 ครั้งต่อเดือน) สำหรับ Kimi K3 และประมาณ 26,000 ครั้งต่อ 5 ชั่วโมงสำหรับ DeepSeek V4.1 Flash ที่มีน้ำหนักเบากว่า หากต้องการเข้าถึงโมเดลใดโมเดลหนึ่งเกินขีดจำกัด เอกสารระบุราคาแยกต่างหาก (\$15 ต่อเดือนสำหรับ Kimi K3, \$60 สำหรับ Go Plus) ดูรายการโมเดลและขีดจำกัดทั้งหมดได้ที่หน้าสมัครสมาชิกในขั้นตอนเชื่อมต่อ ส่วน ChatGPT Plus หรือ Copilot จะครอบคลุมคำขอผ่านการสมัครที่คุณจ่ายอยู่แล้ว แต่โปรดจำไว้ว่าการสมัครมีขีดจำกัดความเข้มข้นการใช้งานของตัวเอง สุดท้าย คำขอไปยังโมเดลในเครื่องผ่าน Ollama ไม่มีค่าใช้จ่าย แต่คุณต้องมีคอมพิวเตอร์ที่แรงพอให้เรียกใช้ได้รวดเร็ว ## ควรทำอะไรเมื่อเปิดใช้งานครั้งแรก?
ประเด็นสำคัญ ไปที่โฟลเดอร์โปรเจกต์ เรียกใช้ opencode แล้วใช้คำสั่ง `/init` — เอเจนต์จะตรวจสอบโปรเจกต์และสร้างไฟล์ AGENTS.md ที่อธิบายโปรเจกต์ ก่อนแก้ไข ให้กด Tab เพื่อเปลี่ยนเป็นโหมด Plan: ระบบจะแนะนำวิธีแก้และแสดงการแก้ไขให้คุณอนุมัติ ย้อนคืนการกระทำที่ผิดพลาดด้วย `/undo`
เปิดใช้งานครั้งแรกจากภายในโฟลเดอร์โปรเจกต์: ```bash cd path/to/project opencode ``` อินเทอร์เฟซจะเปิดพร้อมช่องป้อนข้อความ ก่อนอื่นใช้คำสั่ง `/init`: เอเจนต์จะสแกนไฟล์สำคัญในคลัง ถามคำถามสองสามข้อหากจำเป็น และเขียนไฟล์ AGENTS.md ซึ่งเป็นคู่มืออธิบายโครงสร้างโปรเจกต์ คำสั่งที่ใช้ build และทดสอบ รวมถึงแนวทางที่ใช้ เอกสารแนะนำให้ commit ไฟล์นี้เข้า git จากนั้น OpenCode จะใช้เป็นคำสั่งประจำโปรเจกต์ ในแง่หน้าที่ AGENTS.md เทียบเท่ากับ CLAUDE.md โดยตรงในระบบนิเวศ OpenCode ประการที่สอง ใช้โหมด Plan ปุ่ม Tab สลับระหว่างเอเจนต์หลักสองตัว: Build ทำงานกับไฟล์และคำสั่งได้เต็มสิทธิ์ ส่วน Plan ใช้สำหรับวิเคราะห์และวางแผน การแก้ไฟล์และคำสั่ง bash ในโหมด Plan ต้องได้รับการอนุมัติจากคุณโดยค่าเริ่มต้น สำหรับงานใหม่ เอกสารแนะนำให้เริ่มด้วยแผน: อ่านสิ่งที่เอเจนต์ตั้งใจจะทำ ปรับถ้อยคำ แล้วจึงสลับกลับไป Build ด้วย Tab เอกสารแนะนำไว้ว่า:

การพูดกับมันเหมือนที่คุณพูดกับนักพัฒนารุ่นน้องในทีมจะช่วยได้

— เอกสารประกอบ OpenCode อย่างเป็นทางการ, https://opencode.ai/docs/
ยิ่งระบุงานชัดเจนและให้บริบทมากเท่าไร ก็ยิ่งต้องแก้งานซ้ำน้อยลง เพิ่มไฟล์ในคำขอด้วย `@` — เริ่มพิมพ์ชื่อ แล้วอินเทอร์เฟซจะค้นหาไฟล์ด้วย fuzzy search คุณลากรูปภาพลงในเทอร์มินัลได้โดยตรง และข้อความที่ขึ้นต้นด้วย `!` จะทำงานเป็นคำสั่ง shell โดยเพิ่มผลลัพธ์เข้าไปในบริบทของเอเจนต์ หากคุณสั่งงานผิดหรือเอเจนต์ทำผิด `/undo` จะย้อนคืนการเปลี่ยนแปลง และเรียกใช้ต่อเนื่องหลายครั้งได้ เปลี่ยนใจอีกแล้วหรือ? `/redo` จะคืนสิ่งที่ย้อนกลับไป และ `/share` สร้างลิงก์บทสนทนาให้ทีม หากไม่ใช้คำสั่งนี้ บทสนทนาจะไม่ถูกเผยแพร่ที่ใด ## OpenCode ทำอะไรได้อีกบ้าง?
ประเด็นสำคัญ คำสั่งกำหนดเองจากไฟล์ markdown ในโฟลเดอร์ `.opencode/commands`, เอเจนต์ย่อยสำหรับงานคู่ขนานและการอ่านโค้ด, เซิร์ฟเวอร์ MCP สำหรับเครื่องมือภายนอก, เวอร์ชันเว็บในเบราว์เซอร์ และโหมดเซิร์ฟเวอร์สำหรับทำงานระยะไกล
**คำสั่งกำหนดเอง** คำขอที่ใช้ซ้ำเป็นประจำสามารถเปลี่ยนเป็นคำสั่งได้: วางไฟล์ markdown ใน `.opencode/commands/` กำหนด `description`, `agent` และ `model` ใน frontmatter แล้วเขียนเทมเพลต prompt ไว้ด้านล่าง จากนั้นเรียกคำสั่งด้วย `/` เช่น ตรวจสอบโปรเจกต์ก่อนเผยแพร่ ทบทวนข้อผิดพลาดล่าสุด สร้าง migration — ทำได้ทุกอย่างที่คุณขอเป็นประจำ **เอเจนต์ย่อย** นอกเหนือจาก Build และ Plan ยังมีอีกสามตัว: General สำหรับงานหลายขั้นตอน (เข้าถึงเครื่องมือทุกอย่างยกเว้นรายการงาน), Explore สำหรับอ่านโค้ดอย่างรวดเร็วโดยไม่มีสิทธิ์แก้ไข และ Scout สำหรับค้นคว้าไลบรารีภายนอก เรียกใช้โดยกล่าวถึงเอเจนต์เหล่านี้ในข้อความด้วย `@` **เซิร์ฟเวอร์ MCP** เชื่อมต่อเครื่องมือภายนอกผ่านส่วน `mcp` ในไฟล์กำหนดค่า `opencode.json` รองรับทั้งเซิร์ฟเวอร์ในเครื่องและระยะไกล เซิร์ฟเวอร์ MCP แต่ละตัวเพิ่มเครื่องมือของตนเข้าในบริบท และเซิร์ฟเวอร์ที่ใช้บริบทมากอย่าง GitHub อาจใช้พื้นที่อย่างรวดเร็ว จึงควรเชื่อมต่อเฉพาะสิ่งที่ต้องใช้ เรามี[คู่มือพร้อมการตั้งค่าที่นำไปใช้ได้เลย](https://ailoot.ai/blog/th/mcp-servers-claude-code/)เกี่ยวกับแนวคิด MCP คู่มือนี้เขียนถึง Claude Code แต่ใช้โปรโตคอลร่วมกัน **เวอร์ชันเว็บและเซิร์ฟเวอร์** `opencode web` เปิดอินเทอร์เฟซในเบราว์เซอร์ หากต้องการเข้าถึงจากเครื่องอื่น ให้ใช้ `opencode serve --hostname 0.0.0.0 --port 4096`; เมื่อมีการเข้าถึงเครือข่าย ต้องตั้งรหัสผ่านด้วยตัวแปร `OPENCODE_SERVER_PASSWORD` หากไม่มีรหัสผ่าน เซิร์ฟเวอร์จะไม่มีการป้องกัน ## หากติดตั้งแล้วมีปัญหาควรทำอย่างไร?
ประเด็นสำคัญ ปัญหาเกือบทั้งหมดมีสาเหตุอยู่สามอย่าง: ไม่พบคำสั่ง `opencode` (เปิดเทอร์มินัลใหม่หรือแก้ PATH), โมเดลไม่ตอบสนอง (ตรวจสอบคีย์ใน `/connect` และไฟล์ `auth.json`) หรืออินเทอร์เฟซแสดงผลผิดพลาด (ใช้เทอร์มินัลรุ่นใหม่ เช่น WezTerm) เริ่มแก้ปัญหาจากบันทึกใน `~/.local/share/opencode/log/`
**ติดตั้งแล้วขึ้น “opencode: command not found”** เทอร์มินัลยังไม่รู้จัก path ใหม่ เริ่มจากปิดแล้วเปิดเทอร์มินัลใหม่ หากยังไม่ช่วย ให้หาตำแหน่งที่ตัวติดตั้งวางไบนารีไว้ แล้วเพิ่มโฟลเดอร์นั้นใน PATH ของเทอร์มินัล **โมเดลไม่ตอบหรือแจ้งข้อผิดพลาดการอนุญาต** ตรวจสอบว่าเชื่อมต่อผู้ให้บริการแล้ว โดยพิมพ์ `/connect` และยืนยันตัวตนอีกครั้ง คีย์เก็บอยู่ใน `~/.local/share/opencode/auth.json` หากย้ายการติดตั้งมาจากเครื่องอื่นหรือลบโฟลเดอร์ ไฟล์นี้อาจหายไป เอกสารอธิบายข้อผิดพลาด ProviderInitError และ AI_APICallError แยกกัน: สำหรับข้อผิดพลาดแรก ให้ยืนยันตัวตนผู้ให้บริการอีกครั้ง ส่วนข้อผิดพลาดที่สอง ให้ลบโฟลเดอร์ `~/.cache/opencode` แล้วเริ่มใหม่ **อินเทอร์เฟซเสีย: แผงกระจัดกระจาย หรือมีอักขระอ่านไม่ออกแทนสัญลักษณ์** เริ่มจากตรวจสอบเทอร์มินัล ติดตั้งหนึ่งในตัวเลือกที่แนะนำ — WezTerm ใช้ได้ทั้งสามระบบ — แล้วเปิด OpenCode จากโปรแกรมนั้น หากยังแก้ไม่ได้ ให้ตรวจสอบบันทึก: บน macOS และ Linux อยู่ที่ `~/.local/share/opencode/log/`; บน Windows กด Win+R แล้วป้อน `%USERPROFILE%\.local\share\opencode\log` ระบบเก็บไฟล์ล่าสุดสิบไฟล์ เปิดการบันทึกรายละเอียดด้วยแฟล็ก `opencode --log-level DEBUG` เมื่อมีบันทึกเหล่านี้แล้ว คุณสามารถแจ้งข้อบกพร่องในรีโพสิทอรีของโปรเจกต์บน GitHub ได้ ## ผู้คนยังถามอะไรเกี่ยวกับ OpenCode อีกบ้าง?
ประเด็นสำคัญ คำตอบสั้น ๆ สำหรับคำถามที่พบบ่อย: OpenCode เป็นเครื่องมือฟรี คุณจ่ายเฉพาะค่าโมเดล เชื่อมต่อ Claude Pro/Max ผ่าน `/connect` ได้ แต่ห้ามใช้ปลั๊กอินของบุคคลที่สามเพื่อการนี้ เข้าถึงจากโทรศัพท์ผ่านเวอร์ชันเว็บได้ และอัปเดต OpenCode ด้วยคำสั่ง `opencode upgrade`
### คำถามที่พบบ่อย OpenCode ฟรีหรือไม่? ใช่ ซอร์สโค้ดเผยแพร่ภายใต้สัญญาอนุญาต MIT คุณอาจต้องจ่ายค่าโมเดล โดยมีตัวเลือกทั้งหมดอธิบายไว้ด้านบนในหัวข้อค่าใช้จ่าย เชื่อมต่อการสมัคร Claude Pro/Max ได้ไหม? ได้ Anthropic มีตัวเลือก Claude Pro/Max อย่างเป็นทางการใน `/connect` พร้อมการยืนยันตัวตนผ่านเบราว์เซอร์ บทความเก่าเกี่ยวกับการใช้การสมัคร Claude ผ่านปลั๊กอินล้าสมัยแล้ว: Anthropic ห้ามใช้ปลั๊กอินเหล่านี้ และนำออกจาก OpenCode ตั้งแต่เวอร์ชัน 1.3.0 ใช้ OpenCode บนโทรศัพท์ได้หรือไม่? ตัวเลือกที่ใช้งานได้คือเวอร์ชันเว็บ: เรียกใช้ `opencode serve` บนคอมพิวเตอร์หรือเซิร์ฟเวอร์ แล้วเชื่อมต่อจากเบราว์เซอร์บนโทรศัพท์ ต้องใช้รหัสผ่าน `OPENCODE_SERVER_PASSWORD` เมื่อเข้าถึงผ่านเครือข่ายทุกกรณี OpenCode ดีกว่า Claude Code อย่างไร? ขึ้นอยู่กับโมเดลและการสมัครสมาชิกของคุณ: Claude Code ผสานรวมกับโมเดล Anthropic ส่วน OpenCode มีผู้ให้บริการกว่า 75 ราย โค้ดโอเพนซอร์ส และโมเดลในเครื่อง ดูตารางด้านบนเพื่อเปรียบเทียบทั้งหมด ควรติดตั้ง OpenCode 2.0 ทันทีหรือไม่? ไม่จำเป็น เอกสารแนะนำเวอร์ชันแรกปัจจุบันเป็นค่าเริ่มต้น ซึ่งเป็นเวอร์ชันที่ติดตั้งด้วยคำสั่ง curl -fsSL https://opencode.ai/install \| bash ในคู่มือนี้ เวอร์ชันที่สองเปิดให้ใช้งานตั้งแต่วันที่ 4 ตุลาคม 2026 แต่ปลั๊กอินและการผสานรวมกับ server API ทำงานต่างออกไป และต้องเขียนโค้ดบางส่วนใหม่
### แหล่งที่มา - [OpenCode, เอกสารอย่างเป็นทางการ](https://opencode.ai/docs/) - [ผู้ให้บริการโมเดล](https://opencode.ai/docs/providers/) - [การเลือกและกำหนดค่าโมเดล](https://opencode.ai/docs/models/) - [OpenCode Zen](https://opencode.ai/docs/zen/) - [เอเจนต์และเอเจนต์ย่อย](https://opencode.ai/docs/agents/) - [ไฟล์กฎ AGENTS.md](https://opencode.ai/docs/rules/) - [คำสั่งกำหนดเอง](https://opencode.ai/docs/commands/) - [เซิร์ฟเวอร์ MCP](https://opencode.ai/docs/mcp-servers/) - [OpenCode บน Windows ผ่าน WSL](https://opencode.ai/docs/windows-wsl) - [อินเทอร์เฟซเทอร์มินัล](https://opencode.ai/docs/tui/) - [เวอร์ชันเว็บ](https://opencode.ai/docs/web/) - [การแก้ไขปัญหา](https://opencode.ai/docs/troubleshooting/) - [บรรทัดคำสั่ง](https://opencode.ai/docs/cli/) - [คลัง OpenCode บน GitHub](https://github.com/anomalyco/opencode) - [OpenCode 2.0: ย้ายจากเวอร์ชัน 1](https://opencode.ai/v2/docs/migrate-v1/) - [OpenCode Go: แผนและขีดจำกัด](https://opencode.ai/go)
[ไปที่ Ailoot](https://ailoot.ai/) ## คำถามที่พบบ่อย ### ทำไมติดตั้ง OpenCode แล้วยังไม่มีโมเดลที่ทำงานได้? ตัวเครื่องมือแยกจากสิทธิ์โมเดล เชื่อมผู้ให้บริการหรือสมาชิกที่รองรับใน /connect หรือตั้งโมเดลในเครื่อง เลือกใน /models แล้วตรวจงานโปรเจกต์จริงที่มีขอบเขตหนึ่งงาน ### ควรตรวจอะไรก่อนย้าย OpenCode 1.x ไป 2.0? ตรวจความเข้ากันได้ของ plugin การเชื่อม server API และค่าเทอร์มินัล ซึ่งคู่มือระบุเป็นส่วนที่ต้องย้าย ตรวจเวอร์ชันและเก็บค่าตั้งกับเซสชันก่อนแทน binary ## Ailoot · บริษัทและพอร์ตโฟลิโอโครงการของบริษัท Ailoot อาศัยประสบการณ์การดำเนินงานที่สั่งสม ฐานลูกค้าขนาดใหญ่ บริการที่เสถียร และการติดตาม KPI อย่างต่อเนื่อง บริษัทและพอร์ตโฟลิโอโครงการของบริษัท: ลูกค้าหลายล้านราย; ยอดขายระดับหลายพันล้านต่อเดือน. Ailoot นำประสบการณ์การดำเนินงานนี้มาใช้เพื่อให้เข้าถึงฟังก์ชัน AI ผ่าน API ในผลิตภัณฑ์ของลูกค้า เอเจนต์ แอปพลิเคชัน และระบบอัตโนมัติ