บทนำ

OpenCode คือเอเจนต์การเข้ารหัส AI แบบโอเพ่นซอร์ส มีให้บริการในรูปแบบอินเทอร์เฟซบน terminal แอปเดสก์ท็อป หรือส่วนขยาย IDE

มาเริ่มกันเลย

---

ข้อกำหนดเบื้องต้น

หากต้องการใช้ OpenCode ใน terminal คุณจะต้องมี:

1. terminal อีมูเลเตอร์ที่ทันสมัยเช่น:

   • WezTerm ข้ามแพลตฟอร์ม
   • Alacritty ข้ามแพลตฟอร์ม
   • Ghostty, Linux และ macOS
   • Kitty, Linux และ macOS

2. API Key สำหรับผู้ให้บริการ LLM ที่คุณต้องการใช้

---

ติดตั้ง

วิธีที่ง่ายที่สุดในการติดตั้ง OpenCode คือการใช้สคริปต์การติดตั้ง

curl -fsSL https://opencode.ai/install | bash

คุณยังสามารถติดตั้งได้ด้วยคำสั่งต่อไปนี้:

• ใช้ Node.js

  npm

  npm install -g opencode-ai

  Bun

  bun install -g opencode-ai

  pnpm

  pnpm install -g opencode-ai

  Yarn

  yarn global add opencode-ai

• ใช้ Homebrew บน macOS และ Linux

  brew install anomalyco/tap/opencode

  เราขอแนะนำให้ใช้ OpenCode tap เพื่อเผยแพร่ข้อมูลล่าสุด สูตร brew install opencode อย่างเป็นทางการได้รับการดูแลโดยทีมงาน Homebrew และมีการอัปเดตไม่บ่อยนัก

• ใช้ Paru บน Arch Linux

  paru -S opencode-bin

Windows

แนะนำ: ใช้ WSL

เพื่อประสบการณ์ที่ดีที่สุดบน Windows เราขอแนะนำให้ใช้ ระบบย่อย Windows สำหรับ Linux (WSL) ให้ประสิทธิภาพที่ดีขึ้นและความเข้ากันได้เต็มรูปแบบกับคุณสมบัติของ OpenCode

• ใช้ Chocolatey

  choco install opencode

• ใช้ Scoop

  scoop install opencode

• การใช้ NPM

  npm install -g opencode-ai

• ใช้ Mise

  mise use -g github:anomalyco/opencode

• ใช้ Docker

  docker run -it --rm ghcr.io/anomalyco/opencode

ขณะนี้การสนับสนุนสำหรับการติดตั้ง OpenCode บน Windows โดยใช้ Bun อยู่ระหว่างดำเนินการ

คุณยังสามารถคว้าไบนารี่ได้จาก เผยแพร่

---

กำหนดค่า

ด้วย OpenCode คุณสามารถใช้ผู้ให้บริการ LLM ใดก็ได้โดยกำหนดค่าคีย์ API

หากคุณยังใหม่ต่อการใช้ผู้ให้บริการ LLM เราขอแนะนำให้ใช้ OpenCode Zen เป็นรายการโมเดลที่ได้รับการดูแลจัดการซึ่งได้รับการทดสอบและตรวจสอบโดย OpenCode ทีม.

1. เรียกใช้คำสั่ง /connect ใน TUI เลือก opencode และไปที่ opencode.ai/auth

   /connect

2. ลงชื่อเข้าใช้ เพิ่มรายละเอียดการเรียกเก็บเงินของคุณ และคัดลอกรหัส API ของคุณ

3. วางคีย์ API ของคุณ

   ┌ API key
   │
   │
   └ enter

หรือคุณสามารถเลือกหนึ่งในผู้ให้บริการรายอื่นได้ เรียนรู้เพิ่มเติม

---

เริ่มต้น

เมื่อคุณได้กำหนดค่าผู้ให้บริการแล้ว คุณสามารถนำทางไปยังโปรเจ็กต์นั้นได้ คุณอยากทำงานต่อ

cd /path/to/project

และเรียกใช้ OpenCode

opencode

จากนั้น เริ่มต้น OpenCode สำหรับโปรเจ็กต์โดยการรันคำสั่งต่อไปนี้

/init

นี่จะได้รับ OpenCode เพื่อวิเคราะห์โครงการของคุณและสร้างไฟล์ AGENTS.md รากของโครงการ

Tip

คุณควรคอมมิตไฟล์ AGENTS.md ของโปรเจ็กต์ของคุณไปที่ Git

ซึ่งจะช่วยให้ OpenCode เข้าใจโครงสร้างโปรเจ็กต์และรูปแบบการเขียนโค้ด ใช้แล้ว.

---

การใช้งาน

ตอนนี้คุณพร้อมที่จะใช้ OpenCode เพื่อทำงานในโครงการของคุณแล้ว อย่าลังเลที่จะถามมัน อะไรก็ตาม!

หากคุณยังใหม่ต่อการใช้เอเจนต์การเข้ารหัส AI ต่อไปนี้คือตัวอย่างบางส่วนที่อาจเป็นไปได้ ช่วย.

---

ถามคำถาม

คุณสามารถขอให้ OpenCode อธิบาย codebase ให้คุณได้

Tip

ใช้ปุ่ม @ เพื่อค้นหาไฟล์ในโครงการอย่างคลุมเครือ

How is authentication handled in @packages/functions/src/api/index.ts

สิ่งนี้มีประโยชน์หากมีส่วนหนึ่งของโค้ดเบสที่คุณไม่ได้ดำเนินการ

---

เพิ่มคุณสมบัติ

คุณสามารถขอให้ OpenCode เพิ่มคุณสมบัติใหม่ให้กับโครงการของคุณได้ แม้ว่าเราจะแนะนำให้ขอให้สร้างแผนก่อนก็ตาม

1. สร้างแผน

   OpenCode มีโหมด Plan ที่ปิดการใช้งานความสามารถในการเปลี่ยนแปลงและ แนะนำ how ว่าจะใช้งานฟีเจอร์นี้แทน

   เปลี่ยนไปใช้ปุ่ม Tab คุณจะเห็นตัวบ่งชี้นี้ที่มุมขวาล่าง

   <TAB>

   ตอนนี้เรามาอธิบายสิ่งที่เราต้องการให้ทำ

   When a user deletes a note, we'd like to flag it as deleted in the database.
   Then create a screen that shows all the recently deleted notes.
   From this screen, the user can undelete a note or permanently delete it.

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

   Tip

   ให้บริบทและตัวอย่างมากมายแก่ OpenCode เพื่อช่วยให้เข้าใจสิ่งที่คุณ ต้องการ.

2. ทบทวนแผน

   เมื่อมีแผนแล้ว คุณสามารถให้ข้อเสนอแนะหรือเพิ่มรายละเอียดเพิ่มเติมได้

   We'd like to design this new screen using a design I've used before.
   [Image #1] Take a look at this image and use it as a reference.

   Tip

   ลากและวางรูปภาพลงใน terminal เพื่อเพิ่มลงในพรอมต์

   OpenCode สามารถสแกนรูปภาพที่คุณให้มาและเพิ่มลงในข้อความแจ้งได้ คุณสามารถ ทำได้โดยลากและวางรูปภาพลงใน terminal

3. สร้างฟีเจอร์

   เมื่อคุณรู้สึกพอใจกับแผนแล้ว ให้เปลี่ยนกลับเป็น Build mode ภายใน กดปุ่ม Tab อีกครั้ง

   <TAB>

   และขอให้ทำการเปลี่ยนแปลง

   Sounds good! Go ahead and make the changes.

---

ทำการเปลี่ยนแปลง

หากต้องการการเปลี่ยนแปลงที่ตรงไปตรงมามากขึ้น คุณสามารถขอให้ OpenCode สร้างมันโดยตรงได้ โดยไม่ต้องทบทวนแผนก่อน

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

คุณต้องการให้แน่ใจว่าคุณให้รายละเอียดในปริมาณที่เหมาะสมเพื่อให้ OpenCode ดำเนินการได้ถูกต้อง การเปลี่ยนแปลง

---

เลิกทำการเปลี่ยนแปลง

สมมติว่าคุณขอให้ OpenCode ทำการเปลี่ยนแปลงบางอย่าง

Can you refactor the function in @packages/functions/src/api/index.ts?

แต่คุณก็รู้ว่ามันไม่ใช่สิ่งที่คุณต้องการ คุณ สามารถยกเลิก การเปลี่ยนแปลงได้ โดยใช้คำสั่ง /undo

/undo

OpenCode จะคืนค่าการเปลี่ยนแปลงที่คุณทำและแสดงข้อความต้นฉบับของคุณ อีกครั้ง.

Can you refactor the function in @packages/functions/src/api/index.ts?

จากที่นี่ คุณสามารถปรับแต่งข้อความแจ้งและขอให้ OpenCode ลองอีกครั้ง

Tip

คุณสามารถเรียกใช้ /undo ได้หลายครั้งเพื่อเลิกทำการเปลี่ยนแปลงหลายรายการ

หรือคุณสามารถ สามารถทำซ้ำ การเปลี่ยนแปลงโดยใช้คำสั่ง /redo

/redo

---

แบ่งปัน

การสนทนาที่คุณมีกับ OpenCode สามารถ แชร์กับคุณได้ ทีมงาน

/share

การดำเนินการนี้จะสร้างลิงก์ไปยังการสนทนาปัจจุบันและคัดลอกไปยังคลิปบอร์ดของคุณ

Note

การสนทนาจะไม่ถูกแชร์โดยค่าเริ่มต้น

นี่คือ ตัวอย่างการสนทนา กับ OpenCode

---

ปรับแต่ง

แค่นั้นแหละ! ตอนนี้คุณเป็นมืออาชีพในการใช้ OpenCode แล้ว

หากต้องการทำให้เป็นของคุณเอง เราขอแนะนำให้ เลือกธีม, ปรับแต่งปุ่มลัด, กำหนดค่าตัวจัดรูปแบบโค้ด, สร้างคำสั่งที่กำหนดเอง หรือลองใช้ การกำหนดค่า OpenCode