⚡
OpenCode.io.vn
Quay lại Blog
4 tháng 11, 2026OpenCode Vietnam7 phút đọc

OpenCode cập nhật 28/10–04/11: /goal, Claude Code và image generation

Tuần 28/10–04/11: OpenCode thêm /goal, dùng Claude Code qua Claude Agent, image_generate bật mặc định và desktop terminal sống qua restart. Tổng hợp kèm link commit.

#opencode#cap-nhat#v2#cli#plugins#ai-coding

OpenCode cập nhật 28/10–04/11: /goal, Claude Code và image generation

Tuần này repo opencode nhận 410 commit và 9 release — nhịp dồn dập nhất từ đầu tháng. Nhưng điểm đáng nói không nằm ở con số, mà ở chỗ OpenCode bắt đầu nhận mục tiêu thay vì từng bước: /goal cho session tự chạy tiếp tới khi xong.

Hai thay đổi còn lại cũng đáng để thử ngay. Bạn có thể dùng Claude Code trong OpenCode bằng login Claude sẵn có. Và image_generate chuyển từ opt-in sang bật mặc định khi provider có model ảnh.

Đổi lại, tuần này có ba breaking change cho người viết plugin và code import @opencode/ai. Mình gom hết vào một bảng ở dưới để bạn kiểm trước khi update.

Gói coding model giá rẻ

$10/tháng
OpenCode Go27 model open source · dùng với mọi agent
Xem gói →

Link affiliate OpenCode Go: OpenCode Vietnam có thể nhận hoa hồng, giá bạn trả không đổi.


Tóm tắt nhanh

  • /goal (v2.2.1): giao mục tiêu, session tự làm tiếp; pause/resume/clear ngay trong phiên.
  • Claude Agent (v2.2.3): dùng Claude Code qua claude auth login, không cần API key riêng.
  • image_generate: thêm ở v2.2.1, bật mặc định ở v2.2.2 khi provider có model ảnh.
  • Persistent terminal (v2.2.4): terminal thuộc session, sống qua restart, giữ scrollback.
  • Artifact (v2.2.4): agent publish HTML/static qua provider local hoặc plugin.
  • Schedule chạy dưới opencode serve, nhiều process chỉ bắn một lần.
  • Breaking: OpenTUI 0.8, managed policy tách quyền, @opencode/ai bỏ 4 provider.

/goal: giao mục tiêu, không giao từng bước

Đây là tính năng mình thấy đáng thử nhất tuần này. Cách dùng:

/goal <objective>
/goal pause
/goal resume
/goal clear

Bạn đưa một mục tiêu, session tiếp tục làm việc và có bước review tiến độ cho tới khi mục tiêu được xác nhận là đạt (8de03239, PR #59437). TUI hiện trạng thái /goal ngay dưới prompt và có dialog để pause/resume/clear; Desktop có pill riêng trong composer.

Điểm kỹ thuật đáng chú ý: plugin có thêm hook experimental.idle để tiếp tục việc trước khi session idle, và GUI plugin có custom popover cho composer pill. Nghĩa là /goal không phải một vòng lặp cứng trong CLI, mà là một cơ chế mở cho extension.

Một lưu ý thực tế: càng tự chạy lâu thì càng nên đặt permission và xem chi phí. /goal không thay đổi quy tắc an toàn nào của bạn.


Claude Code trong OpenCode

v2.2.3 thêm Claude Agent như một provider built-in. Luồng dùng ngắn:

claude auth login          # đăng nhập bằng Claude Code đã cài

Sau đó chọn Claude Agent trong /connect để dùng login và model Claude sẵn có (f29e2813, release v2.2.3). Biến OPENCODE_CLAUDE_PATH cho phép trỏ tới binary Claude ở đường dẫn khác.

v2.2.4 làm luồng này dễ hơn: chọn Claude Agent trong provider picker là có hướng dẫn cài, đăng nhập, kiểm tra kết nối, và cách xử lý khi trạng thái là Needs sign-in (85050418). Plan usage của Claude Agent cũng được báo trong step metadata (c8a473be).

Nói đơn giản: nếu bạn đang trả tiền cho Claude Code, giờ có thể dùng chính gói đó trong OpenCode thay vì mua thêm API key.


Image generation: từ opt-in thành mặc định

v2.2.1 thêm tool image_generate ở dạng opt-in, cho phép agent tạo và sửa ảnh ở background (89f3ac10, f023f7c3). v2.2.2 bật experimental_image_generate mặc định khi provider đã kết nối có model ảnh (d4e48f54). Muốn chọn model cố định thì đặt experimental.image_generate.model.

Danh sách provider ảnh cũng dày lên: GPT Image 2 sau khi đăng nhập Codex, MiniMax và Meta Muse (d142014e, 7461d152, 085a891d).


Ba breaking change cần kiểm trước khi update

Thành phầnThay đổiAi bị ảnh hưởng
TUI pluginBắt buộc OpenTUI 0.8.0+; ScrollBox dùng facade object, RenderContext phải có clock và onAnimationTickPlugin TUI đang dùng OpenTUI 0.7
Managed policyintegration.use chỉ còn áp cho integration; thêm mcp.use, skill.use, plugin.useTeam dùng policy để chặn MCP/skill/plugin
@opencode/aiBỏ fal, Black Forest Labs, Replicate, Stability; bỏ 5 entry point legacy; configure() đổi type thành ConfigCode import trực tiếp @opencode/ai

Chi tiết từng mục:

  • OpenTUI 0.8 — tuần trước vừa lên 0.7, tuần này lên 0.8. Nếu plugin của bạn pin version cũ, nó sẽ fail lúc cài. Đọc release notes OpenTUI 0.8 trước khi nâng (PR #60385).
  • Managed policy — rule cũ với prefix mcp:, skill:, plugin: được convert tự động. Nhưng một rule integration.use trần trước đây chặn cả MCP/skill/plugin thì giờ không còn chặn nữa; phải thêm action riêng (b2bd02ee).
  • @opencode/ai — bốn provider ảnh bị gỡ, cùng entry point ./providers/fal, ./providers/black-forest-labs, ./providers/replicate, ./providers/stability. Năm entry point legacy cũng bị bỏ; dùng path lồng nhau như ./providers/amazon-bedrock/mantle. Chỉ ảnh hưởng code import trực tiếp, không ảnh hưởng CLI/Desktop/HTTP API (dfa63293).

Desktop: terminal sống theo session, artifact và shortcut

Persistent terminal là thay đổi mình thích nhất ở phần desktop. Terminal giờ thuộc về session, giữ scrollback qua restart server, đồng bộ với TUI và các cửa sổ khác. Đổi tên terminal cũng được giữ lại sau restart (ef712d3a, 65c0d83f).

Artifact cho phép agent publish HTML hoặc static file. Bật bằng "experimental": { "artifacts": true } trong opencode.json; có provider local sẵn và API cho SDK, plugin (8f0fc21e).

Shortcut mới giúp bớt rê chuột:

  • ⌘⌥O / Ctrl+Alt+O — chọn worktree.
  • ⌘⌥B / Ctrl+Alt+B — chọn base branch.
  • ⌘⇧X / Ctrl+Shift+X — bật shell mode trong composer (171dbd6a).

Ngoài ra: model picker mới thành mặc định với Favorites/Recent (a9caf6d3), xem output background shell ngay trong activity pill (97fd7acc), và GUI plugin có thêm settings row, select, menu row, color theme cùng khả năng render code block (3fcdcb35, 27dd9256).


Schedule chạy dưới server

Tuần này schedule được làm chắc hơn. Schedule bật qua experimental.schedules giờ chạy trong opencode serve, và nhiều process phối hợp để mỗi schedule chỉ bắn một lần (e76c67a2). Mặc định vẫn tắt; ai không bật thì không bị ảnh hưởng.

v2.2.3 thêm Code Mode check cho schedule: tool call được authorize tĩnh, có state bền và wake message tuỳ biến. Check sai thì creation fail ngay, check đang lỗi thì pause thay vì chạy lặp (c24c5af3). Ngoài ra còn shell check để gate prompt theo điều kiện, và if/until trong SDK (c784d17b).

Nếu bạn đang tự viết cron ngoài để chạy OpenCode định kỳ, đây là lúc thử chuyển sang cơ chế chính thức.


Quyền, mạng và ổn định

Vài fix đáng chú ý, chọn theo mức ảnh hưởng:

  • Web permission so khớp đúng URL được request, và webfetch permission áp cả cho fetch trong Code Mode (805a4b82, bdca40ac).
  • Request tới service local không đi qua proxy cấu hình từ environment — tránh trường hợp proxy công ty chặn nhầm loopback (78dda62d).
  • MCP stdio message lớn hơn 10 MiB không còn bị ngắt kết nối (PR #60694).
  • Compaction bám context window thật; lỗi context của LiteLLM kích hoạt compaction thay vì dừng session (PR #60660, PR #60692).
  • Desktop hết "Session not found" lặp lại, side-panel tab đóng được, Open file qua HTTP chạy lại (PR #60430, PR #60436, PR #60462).

Về hiệu năng, có 9 commit perf trong tuần. Đáng chú ý: tìm stale tool call không cần load cả session, response fold không copy event theo từng chunk, và mỗi thư mục ancestor chỉ list một lần khi tìm config.


Model và chi phí

Phần này thay đổi nhanh, mình gom ngắn:

  • Go Teams đã có trong /go, và trần DeepSeek V4.1 Flash được nâng (3e8e9746, 4fdea64f).
  • ZDR của DeepSeek gia hạn tới hết tháng 11/2026 (bc997174).
  • Responses API có thêm cho OpenRouter, DigitalOcean và Venice, kèm freeform tool (dd35fbc2).
  • Azure Messages cho model Claude trên Foundry (5434c156).

Nếu bạn đang cân nhắc gói subscription thay vì trả token từng lần, OpenCode Go là lựa chọn $10/tháng mà mình đã phân tích trong bài riêng.


Nên làm gì với bản cập nhật này

  • Bạn muốn agent tự chạy dài? Thử /goal với một mục tiêu nhỏ, đặt permission chặt, rồi xem bước review có đúng ý không.
  • Bạn có gói Claude Code? Chọn Claude Agent trong /connect, chạy claude auth login — không cần thêm API key.
  • Bạn viết plugin TUI? Pin OpenTUI và đọc release notes 0.8 trước khi update; tuần này đã là lần đổi major thứ hai liên tiếp.
  • Bạn import @opencode/ai? Sửa import provider và đổi type configure() sang Config.
  • Team dùng managed policy? Kiểm lại rule integration.use — nó không còn chặn MCP/skill/plugin.
  • Bạn cần chạy định kỳ? Thử experimental.schedules thay vì cron ngoài.
  • Bạn dùng desktop? Update để có persistent terminal và shortcut worktree/shell mode.

Nguồn tham khảo

Bài tổng hợp từ commit message và release notes trong tuần (410 commit, 9 release, quét ngày 04/11/2026), chưa chạy thử từng tính năng; commit nội bộ (chore/test/ci) chỉ đếm, không liệt kê.

Bạn thấy thay đổi nào trong tuần này đáng dùng nhất? Vào nhóm OpenCode Vietnam thảo luận cùng mọi người.