MiniMax Code: MiniMax Agent ที่ใช้คีย์ของคุณเองผ่าน Gonka

เอเจนต์มีจุดเข้าใช้งานสามจุด และทั้งสามจุดทำงานกับผู้ให้บริการแบบ BYOK เหมือนกันทั้งหมด:

ตัวติดตั้งอย่างเป็นทางการจะติดตั้งเวอร์ชันล่าสุดไว้ที่ ~/.minimax-code ดึง Node.js ที่เหมาะสมมาให้หากจำเป็น และไม่ต้องใช้สิทธิ์ผู้ดูแลระบบ:

# macOS / Linux / WSL
curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

# Windows (PowerShell)
irm https://filecdn.minimax.chat/public/install.ps1 | iex

ถ้ามี Node.js อยู่แล้ว (22.19 ขึ้นไปในสาย 22, 24.2 ขึ้นไปในสาย 24 รวมถึง 25 และ 26) ใช้ npm ได้เลย:

npm install -g @minimax-ai/code@latest --registry=https://registry.npmjs.org/ --ignore-scripts=false --include=optional --allow-scripts=@minimax-ai/code,better-sqlite3

คำสั่งยาวขนาดนี้ไม่ได้เป็นเรื่องบังเอิญ เพราะเอเจนต์ต้องใช้การคอมไพล์ SQLite แบบเนทีฟ ดังนั้น dependencies แบบออปชันและสคริปต์ติดตั้งจึงต้องเปิดไว้ หลังติดตั้งเสร็จให้เปิดเทอร์มินัลใหม่แล้วตรวจสอบด้วย mcode --version

ภายใน TUI จะมี Shift+Tab (โหมดวางแผน), Alt+M (สลับโหมดการอนุญาต — Ask, Auto และ Full access), @ สำหรับอ้างอิงไฟล์ และ /help พร้อมรายการคำสั่ง งานที่ค้างอยู่ทำต่อได้ด้วย mcode --continue ส่วน mcode init . จะสร้างไฟล์ AGENTS.md ในโปรเจกต์พร้อมกฎสำหรับเอเจนต์

ข้อมูลผู้ใช้ — config.yaml, เซสชัน, สถานะการเข้าสู่ระบบ — เก็บแยกจากตัวโปรแกรมไว้ในไดเรกทอรี ~/.minimax (สำหรับโปรไฟล์ที่ตั้งชื่อไว้จะเป็น ~/.minimax-<profile>) และตัวแปร MINIMAX_DATA_DIR ใช้กำหนดตำแหน่งอื่นได้

คีย์ JoinGonka ลงทะเบียนที่ gate.joingonka.ai/register หลังยืนยันอีเมลแล้วจะได้รับโทเคนฟรี 3M เข้าบัญชี คีย์ที่ขึ้นต้นด้วย jg- สร้างได้ในหน้าคอนโซลที่ส่วน "คีย์ API" และควรสร้างแยกสำหรับเอเจนต์โดยเฉพาะ เพราะทราฟฟิกจะแสดงเป็นอีกรายการหนึ่งแยกต่างหาก

ปิด mcode ถ้ากำลังรันอยู่ แล้วรันคำสั่งนี้:

npx @joingonka/setup --tool minimax-code --model minimax

ตัวติดตั้งจะถามหา API key สำรอง config.yaml เดิมไว้ก่อน จากนั้นเขียนเฉพาะบล็อกของตัวเองเพิ่มเข้าไป แล้วจบด้วยการยิง request จริงไปที่ gateway — key, URL และโมเดลถูกตรวจสอบทันที ไม่ใช่รอไปเจอตอนรันงานแรก ใน ~/.minimax/config.yaml จะมี provider joingonka ปรากฏขึ้นใต้ custom_provider ซึ่งเป็นที่ที่ mcode เก็บ endpoint ของบุคคลที่สามไว้:

custom_provider:
  joingonka:
    name: JoinGonka
    kind: custom
    enabled: true
    api: openai-completions
    options:
      apiKey: jg-your-key
      baseURL: https://gate.joingonka.ai/v1
      authMode: api-key
    models:
      MiniMaxAI/MiniMax-M2.7:
        name: MiniMax M2.7 (Gonka)
        limit:
          context: 200000
          output: 8192
      deepseek-ai/DeepSeek-V4-Flash-0731:
        name: DeepSeek V4 Flash (Gonka)
        reasoning: true
        limit:
          context: 380000
          output: 32768
      zai-org/GLM-5.3-Flash:
        name: GLM 5.3 Flash (Gonka)
        reasoning: true
        limit:
          context: 390000
          output: 8192
defaultModel: custom_provider:joingonka/MiniMaxAI/MiniMax-M2.7

สิ่งที่ควรรู้เกี่ยวกับบล็อกนี้:

• ระบุรูปแบบ API ไว้ชัดเจน ถ้าไม่มีฟิลด์ api mcode จะถือว่า provider นั้นใช้ Anthropic-compatible แต่ตัวติดตั้งเลือก openai-completions ซึ่งเป็นเส้นทางมาตรฐานของ gateway
• แต่ละโมเดลมีลิมิตของตัวเอง โมเดลที่ไม่รู้จัก mcode จะใส่หน้าต่าง 200,000 และ output 16,384 token ให้โดยอัตโนมัติ แต่ค่าจริงของเครือข่ายไม่เหมือนกัน จึงต้องกำหนด limit ให้ทั้งสามรายการ
• Key ถูกเก็บเป็น literal ในไฟล์ และไฟล์ได้สิทธิ์ 600 mcode ก็เก็บ key แบบเดียวกัน: แฟล็ก --api-key-env อ่านจาก environment variable แล้วเขียนค่าลงในคอนฟิก ไม่ใช่เขียนเป็น reference
• โมเดลเริ่มต้น แฟล็ก --model minimax ตั้ง MiniMax M2.7 ถ้าไม่ใส่แฟล็ก ตัวติดตั้งจะเลือก DeepSeek V4 Flash สำหรับ coding agent เพราะมีหน้าต่างและเพดาน output ใหญ่กว่า ส่วน --model glm จะได้ GLM-5.3 Flash ถ้าในคอนฟิกมีโมเดลของ provider อื่นเลือกอยู่แล้ว การรันซ้ำโดยไม่ใส่ --model จะไม่ไปแตะมัน
• โปรไฟล์ ถ้าต้องการโปรไฟล์แบบมีชื่อ ให้รันตัวติดตั้งพร้อม environment variable เช่น MINIMAX_DATA_DIR=~/.minimax-work

ที่ขอให้ปิด mcode ระหว่างติดตั้งไม่ใช่พิธีการ: agent จะเขียน config.yaml ใหม่ทั้งไฟล์ทุกครั้งที่มัน save เอง และอาจเขียนทับการแก้ไขที่ทำไว้ข้างหลังมันได้

คำสั่งมาตรฐานของ agent ก็ให้ผลเหมือนกัน key ส่งผ่าน environment variable — ไม่ควรอยู่ใน argument หรือ history ของ shell:

# read the key without echo
read -s JOINGONKA_API_KEY
export JOINGONKA_API_KEY

mcode provider add --name JoinGonka \
  --base-url https://gate.joingonka.ai/v1 \
  --api-format openai-completions \
  --model MiniMaxAI/MiniMax-M2.7 \
  --api-key-env JOINGONKA_API_KEY \
  --context-limit 200000 --output-limit 8192 --use

แฟล็ก --use จะยิง request จริงตรวจสอบโมเดลแรกในลิสต์ก่อน แล้วจึงบันทึก provider และตั้งเป็นโมเดลเริ่มต้น ถ้าล้มเหลวจะไม่บันทึกอะไรเลย ถ้ารันผ่านจะจบด้วยบรรทัด Provider added and selected: JoinGonka mcode จะ derive provider key จากชื่อเอง — ได้ joingonka — ดังนั้นตัวติดตั้งที่รันทีหลังจะอัปเดตรายการเดิม ไม่สร้างรายการใหม่ซ้อน

แฟล็ก --context-limit และ --output-limit มีผลกับทุกโมเดลที่ระบุในคำสั่ง แต่ลิมิตของโมเดลในเครือข่ายไม่เท่ากัน จึงสะดวกกว่าถ้าใช้คำสั่งตั้งโมเดลเดียว แล้วเขียนโมเดลที่เหลือเพิ่มในไฟล์ ปิด mcode แล้วรวม snippet นี้เข้ากับบล็อก provider ที่มีอยู่แล้วใน ~/.minimax/config.yaml:

custom_provider:
  joingonka:
    models:
      MiniMaxAI/MiniMax-M2.7:
        limit: { context: 200000, output: 8192 }
      deepseek-ai/DeepSeek-V4-Flash-0731:
        limit: { context: 380000, output: 32768 }
      zai-org/GLM-5.3-Flash:
        limit: { context: 390000, output: 8192 }

วิธีที่สามคือแบบ interactive: ใน TUI คำสั่ง /model เปิดตัวเลือกโมเดลที่มีเมนู + Add 3rd-party provider… ส่วน /provider ใช้จัดการการเชื่อมต่อที่บันทึกไว้ ที่อยู่บนหน้าโมเดลแก้ได้ด้วย Ctrl+E ถ้าตรวจสอบไม่ผ่านจะไม่บันทึกอะไร draft จะยังอยู่ให้แก้ต่อ

จะเลือกรูปแบบ API ไหนดี gateway รองรับทั้งสามแบบ ต่างกันแค่ base URL:

ในการรันของเรา ทั้งสามรูปแบบผ่านการทดสอบการเชื่อมต่อ

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

mcode provider list
* custom_provider:joingonka   active   jg-a****9f3c

คำสั่งที่สองส่งคำขอจริง และเมื่อสำเร็จจะตอบกลับว่า Provider available: custom_provider:joingonka; แฟล็ก --model ใช้ตรวจสอบโมเดลที่ระบุ:

mcode provider test custom_provider:joingonka

คำสั่งที่สามตรวจสอบสิ่งสำคัญที่สุด — การทำงานกับไฟล์ วางไฟล์ขนาดเล็กที่มีข้อผิดพลาดชัดเจนลงในไดเรกทอรี แล้วขอให้มันค้นหาข้อผิดพลาดนั้น:

mcode exec "Read calc.py and tell me in one sentence whether it has a bug."

เอเจนต์ต้องเรียกใช้เครื่องมืออ่านด้วยตัวเองและตอบอย่างตรงประเด็น ในการทดสอบของเรา โมเดลทั้งสามในเครือข่ายทำงานได้เช่นนี้; สำหรับการรันครั้งเดียวสามารถระบุโมเดลอื่นได้ด้วยแฟล็กในรูปแบบ --model custom_provider:joingonka/<model-id> เมื่อใช้แฟล็ก --output-format json คำตอบจะมีฟิลด์ usage พร้อมจำนวนโทเค็นอินพุตและเอาต์พุต — สะดวกในการเทียบกับหน้าแผงควบคุมของเกตเวย์: ในส่วน "การใช้งาน" จะเห็นคำขอรายชั่วโมงและรายวัน รวมถึงการแยกตามโมเดลและตามคีย์

หากการตรวจสอบไม่ผ่าน mcode จะระบุสาเหตุไว้ในข้อความโดยตรง:

ทุกโมเดลในเครือข่ายราคาเดียวกัน ดังนั้นการเลือกจึงขึ้นอยู่กับพฤติกรรม ด้านล่างคือลิมิตและวิธีที่โมเดลต่าง ๆ ทำงานในการรัน mcode exec ของเราบนโจทย์เดียวกัน (ตรวจสอบเมื่อ 21 กันยายน 2026):

หลักปฏิบัติง่าย ๆ สำหรับงานสั้นและการแก้ไขด่วน เลือก MiniMax M2.7 ตอนนี้คาพาซิตี้ส่วนใหญ่ของเครือข่ายอยู่ที่โมเดลนี้ หากการคิดวิเคราะห์ที่มองเห็นรบกวน เช่น สคริปต์ที่ต้องแยกผลลัพธ์จาก exec หรือต้องอ่านรีโพขนาดใหญ่แล้วได้คำแก้ไขยาว ๆ ให้สลับไปที่ DeepSeek V4 Flash ส่วนตรรกะที่ซับซ้อนซ้อนกัน GLM-5.3 Flash คิดได้ดีกว่า

การสลับไม่ต้องแก้ไฟล์ ใน TUI ใช้คำสั่ง /model สำหรับเซสชันเดียวใช้ mcode -m custom_provider:joingonka/<model-id> และสำหรับการรันครั้งเดียวใช้ mcode exec --model พร้อมค่าเดียวกัน ตัวเลือกถาวรถูกเก็บไว้ในบรรทัด defaultModel องค์ประกอบของเครือข่ายเปลี่ยนแปลงได้ตามเวลา รายการล่าสุดพร้อมลิมิตดูได้เสมอจาก GET https://gate.joingonka.ai/v1/models

เครื่องมือเอเจนต์ใช้โทเค็นแตกต่างจากแชททั่วไป: ในทุกๆ วลีที่คุณป้อน mcode จะเพิ่ม system prompt และคำอธิบายเครื่องมือทั้งหมด จากนั้นจึงทำบทสนทนาหลายขั้นตอนกับโมเดล ในการทดสอบของเรา งาน "อ่านไฟล์และหาข้อผิดพลาด" ใช้ไปประมาณ 40,000 โทเค็น ซึ่งเกือบทั้งหมดเป็นขาเข้า (input) ดังนั้นราคาต่อโทเค็นจึงมีความสำคัญมาก

ผ่าน JoinGonka Gateway ราคาโทเค็นอยู่ที่ $0.0069 ต่อล้านสำหรับขาเข้า และ $0.021 ต่อล้านสำหรับขาออก ราคาเท่ากันสำหรับทุกโมเดลในเครือข่ายและดึงข้อมูลจากแหล่งสดบนหน้านี้ ขนาดราคา ณ เดือนกันยายน 2026: งานหนึ่งครั้งใช้ต้นทุนเพียงเศษเสี้ยวของเซนต์ ส่วนการทำงานตลอดทั้งวันโดยใช้โทเค็น 3-7 ล้านโทเค็นจะมีราคาเพียงไม่กี่เซนต์

BYOK ครอบคลุมอะไรบ้าง? ผู้ให้บริการของคุณดูแลการร้องขอโมเดล: การอ่านและการแก้ไขโค้ด, คำสั่ง, ซับเอเจนต์, และเซสชัน ส่วนระบบค้นหาในตัว, เครื่องมือสื่อ mcode-tools และตัวเชื่อมต่อที่จัดการได้จะเป็นบริการของผู้ให้บริการหลัก ซึ่งจำเป็นต้องมีการล็อกอินและเครดิต เครื่องมือของคุณเองสามารถเชื่อมต่อได้อย่างอิสระผ่านเซิร์ฟเวอร์ MCP ในไฟล์ .mcp.json ของโปรเจกต์

การอนุญาต. ใน TUI โหมด Ask, Auto และ Full access สามารถสลับได้ผ่าน Alt+M หรือคำสั่ง /permission ส่วนใน mcode exec สามารถกำหนดได้ผ่านแฟล็ก --permission

Telemetry. ช่องทางสถิติ, เมตริก และการวินิจฉัยใน mcode จะถูกปิดโดยค่าเริ่มต้นและเปิดใช้งานแยกกันได้ ตัวแปร MCODE_DISABLE_TELEMETRY และ DO_NOT_TRACK จะปิดการทำงานทั้งหมดพร้อมกัน ในส่วนของเกตเวย์ จะไม่มีการจัดเก็บเนื้อหาของพร้อมต์หรือคำตอบ โดยสถิติจะคงเหลือเพียงข้อมูลสรุปการใช้งาน

หากต้องการทำงานกับรูปภาพ เช่น ภาพหน้าจออินเทอร์เฟซ หรือเลย์เอาต์ ให้เพิ่มผู้ให้บริการอีกตัวที่มีโมเดลรองรับการมองเห็น (Vision) พร้อมระบุแฟล็ก --support-image ขณะเพิ่ม โมเดลของเครือข่าย Gonka เป็นแบบข้อความทั้งหมด แต่คุณสามารถเพิ่มผู้ให้บริการใน mcode ได้หลายตัว

เอเจนต์จากห้องปฏิบัติการเองมีให้บริการสำหรับโมเดลทั้งสามตระกูลในเครือข่าย: นอกจาก MiniMax Code แล้วยังมี DeepSeek Harness และ ZCode จาก Z.ai ซึ่งเป็นผู้สร้าง GLM ทั้งสามตัวเชื่อมต่อเข้ากับเกตเวย์เดียวด้วยกุญแจเดียวกัน