ข้ามไปยังเนื้อหา
เอกสาร V1
ติดตั้ง

บทนำ

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

OpenCode TUI พร้อม opencode theme

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


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

หากต้องการใช้ 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 install -g opencode-ai
  • ใช้ Homebrew บน macOS และ Linux

    เทอร์มินัล
    brew install anomalyco/tap/opencode

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

  • ใช้ Paru บน Arch Linux

    เทอร์มินัล
    sudo pacman -S opencode           # Arch Linux (Stable)
    paru -S opencode-bin              # Arch Linux (Latest from AUR)

Windows

  • ใช้ 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 Models เป็นรายการโมเดลที่ได้รับการดูแลจัดการซึ่งได้รับการทดสอบและตรวจสอบโดย 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 รากของโครงการ

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


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

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


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

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

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


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

  1. สร้างแผน

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

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

    สลับไปที่โหมด Plan
    <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 เพียงพอเพื่อทำความเข้าใจสิ่งที่คุณต้องการ มันช่วยได้ เพื่อพูดคุยเหมือนคุณกำลังพูดคุยกับนักพัฒนารุ่นน้องในทีมของคุณ

  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.

    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 ลองอีกครั้ง

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

เทอร์มินัล
/redo

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

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