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ẻ
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/aibỏ 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ần | Thay đổi | Ai bị ảnh hưởng |
|---|---|---|
| TUI plugin | Bắt buộc OpenTUI 0.8.0+; ScrollBox dùng facade object, RenderContext phải có clock và onAnimationTick | Plugin TUI đang dùng OpenTUI 0.7 |
| Managed policy | integration.use chỉ còn áp cho integration; thêm mcp.use, skill.use, plugin.use | Team dùng policy để chặn MCP/skill/plugin |
@opencode/ai | Bỏ fal, Black Forest Labs, Replicate, Stability; bỏ 5 entry point legacy; configure() đổi type thành Config | Code 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 ruleintegration.usetrầ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à
webfetchpermission á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ử
/goalvớ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ạyclaude 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 typeconfigure()sangConfig. - 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.schedulesthay vì cron ngoài. - Bạn dùng desktop? Update để có persistent terminal và shortcut worktree/shell mode.
Nguồn tham khảo
- Release v2.2.1 —
/goal,image_generate - Release v2.2.2 — image generation mặc định
- Release v2.2.3 — Claude Agent, OpenTUI 0.8
- Release v2.2.4 — persistent terminal, artifact
- Release v2.2.5 — shortcut, compaction buffer
- Danh sách commit 28/10–04/11 — nhánh
dev - OpenCode cập nhật 14/10–28/10 — kỳ trước
- OpenCode từ xa: OpenTunnel, Tailscale hay cloudflared
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.