Cấu trúc Agents, Skills, Commands: OpenCode vs Claude Code — và cách chuyển đổi
Hướng dẫn chi tiết về sự khác biệt trong cấu trúc Agents, Skills, Commands giữa OpenCode và Claude Code, kèm cách chuyển đổi cấu hình giữa hai công cụ.
Bảng so sánh tổng quan
Thành phần
OpenCode
Claude Code
1. Agents
Cách OpenCode định nghĩa Agent
{
"agent": {
"code-reviewer": {
"description": "Reviews code for best practices and potential issues",
"mode": "subagent",
"model": "anthropic/claude-sonnet-4-20250514",
"prompt": "You are a code reviewer. Focus on security, performance, and maintainability.",
"permission": {
"edit": "deny"
}
}
}
}Cách Claude Code định nghĩa Agent
So sánh chi tiết Agent
Field
OpenCode
Claude Code
Cách chuyển đổi Agent từ Claude Code sang OpenCode
2. Skills
Agent Skills Standard
Cách OpenCode xử lý Skills
Cách Claude Code xử lý Skills
Field
Mô tả
So sánh chi tiết Skills
Field
OpenCode
Claude Code
Cách chuyển đổi Skills giữa hai công cụ
3. Commands
OpenCode Commands
Claude Code Commands
So sánh Commands
Field
OpenCode
Claude Code
Cách chuyển đổi Commands
4. Compatibility Layer — OpenCode đọc cấu hình Claude Code
5. Migration Strategy Tổng Thể
Strategy A: Dùng cả hai (khuyến nghị)
Strategy B: Chỉ dùng OpenCode
Strategy C: Chỉ dùng Claude Code
Checklist migrate
Item
Claude Code → OpenCode
OpenCode → Claude Code
6. Các vấn đề thường gặp và cách khắc phục
Vấn đề 1: Skill không hiển thị trong OpenCode dù đã đặt đúng path
Vấn đề 2: Claude Code skill dùng context: fork không hoạt động trên OpenCode
context: fork không hoạt động trên OpenCodeVấn đề 3: allowed-tools trong Claude Code skill không có hiệu lực trên OpenCode
allowed-tools trong Claude Code skill không có hiệu lực trên OpenCodeVấn đề 4: Claude Code dùng model alias (sonnet), OpenCode yêu cầu full ID
sonnet), OpenCode yêu cầu full IDVấn đề 5: Command arguments không hoạt động giống nhau
7. Tóm tắt nhanh
Agent config mapping
File path mapping
Component
OpenCode
Claude Code
Cross-compat
Golden rule
Cập nhật lần cuối