mini-SWE-agent so với Claude Code: quy trình làm việc, mô hình và tổng chi phí

mini-SWE-agent và Claude Code không phải là hai phiên bản của cùng một sản phẩm: mini là một agent Python miễn phí, được cấp phép MIT, chỉ có một công cụ — bash — và có thể truy cập bất kỳ model nào thông qua LiteLLM; còn Claude Code là agent độc quyền của Anthropic, chỉ giao tiếp bằng các giao thức có hình dạng Anthropic. Khác biệt duy nhất đó quyết định phần lớn việc di chuyển, vì đây là ranh giới giao thức chứ không phải sở thích. Chọn mini khi bạn muốn một harness đủ nhỏ để đọc và được tự do chọn nhà cung cấp; chọn Claude Code khi bạn muốn các bề mặt editor, desktop và CI, các chế độ quyền hạn cùng con đường đăng ký, và bạn vẫn sử dụng các model Claude.

mini-SWE-agent được duy trì trong tổ chức GitHub SWE-agent và tự mô tả là "Được xây dựng bởi nhóm Princeton & Stanford đứng sau SWE-bench, SWE-agent và nhiều dự án khác". Trước hết cần đính chính, vì thông tin được trích dẫn nhiều nhất về nó đã lỗi thời. Hướng dẫn chuyển đổi sang v2 nêu rằng "v2.0 mặc định sử dụng cơ chế gọi công cụ native (thay vì phân tích văn bản dựa trên biểu thức chính quy)", trong khi FAQ của chính dự án vẫn nói "nó thậm chí không sử dụng giao diện gọi công cụ của các mô hình ngôn ngữ" và "Các hành động được phân tích từ các khối được bao quanh bằng ba dấu huyền ngược". Cả hai trang được đọc ngày 19 tháng 9 năm 2026. Hướng dẫn chuyển đổi và cấu hình đi kèm là nguồn quyết định: mini.yaml yêu cầu mô hình rằng "Mỗi phản hồi cần sử dụng công cụ 'bash' ít nhất một lần để thực thi lệnh." Mọi hướng dẫn dựa trên nhận định rằng phần mềm không gọi công cụ, hoặc dựa trên biến MSWEA_MODEL_API_KEY đã bị loại bỏ, đều có trước v2.

Bạn nên chọn công cụ nào

Chọn mini-SWE-agent nếu công việc của bạn có dạng batch hoặc phụ thuộc nhà cung cấp: chạy cùng một prompt trên nhiều issue, đánh giá các model với nhau, hoặc làm việc trong sandbox nơi một agent đủ nhỏ để kiểm tra quan trọng hơn một bộ tính năng mà bạn không thể xem xét. Mô hình thực thi của nó là thuộc tính quyết định: FAQ của mini mô tả các hành động chạy qua subprocess.run, trong đó "every action is completely independent (as opposed to keeping a stateful shell session running)", vì vậy "the agent cannot change directories or export environment variables; however environment variables can be set per-action". mini.yaml đi kèm cũng nói điều tương tự với model — "Directory or environment variable changes are not persistent. Every action is executed in a new subshell" — và hướng model đến một lệnh có tiền tố thay thế. Điều này khiến các lượt chạy có thể tái lập và dễ dàng đóng gói vào container, nhưng khiến công việc shell dài có trạng thái trở nên bất tiện. Chi phí di chuyển là một buổi chiều: pip install mini-swe-agent, một tệp YAML, một khóa.

Chọn Claude Code nếu giá trị nằm ở các bề mặt và hàng rào bảo vệ. Anthropic mô tả sản phẩm này có sẵn "in your terminal, IDE, desktop app, and browser", đồng thời lưu ý rằng "The Terminal CLI, VS Code, and JetBrains also support third-party providers" — vì vậy route gateway chỉ tồn tại trên một số bề mặt. Sản phẩm có các chế độ quyền hạn, subagent, máy chủ MCP, hook và chế độ lập kế hoạch; với gói Pro hoặc Max, mức sử dụng được trừ vào hạn mức của gói thay vì tính phí theo token. Cái giá là một dạng khóa chặt cụ thể: bạn không thể đưa sản phẩm ra khỏi các model Claude, và tài liệu gateway của Anthropic nêu rằng nó "doesn't support routing Claude Code to non-Claude models through any gateway".

Chuyển từ Claude Code sang mini nghĩa là từ bỏ hệ thống quyền hạn để đổi lấy ba chế độ của mini, từ bỏ hoàn toàn các bề mặt IDE và desktop, đồng thời tự chịu trách nhiệm hạch toán chi tiêu — ngân sách mỗi lượt chạy của mini chỉ hoạt động khi LiteLLM có thể định giá model id của bạn. Chuyển từ mini sang Claude Code nghĩa là từ bỏ quyền tự do chọn model và chuyển từ một harness có thể đọc được sang một binary đóng gói: kho claude-code là điểm phân phối, còn tệp giấy phép chỉ có thông báo một dòng — "© Anthropic PBC. All rights reserved" — với việc sử dụng tuân theo Điều khoản dịch vụ thương mại của Anthropic.

Hai agent đặt cạnh nhau

Các nguồn được đọc ngày 19 tháng 9 năm 2026: metadata PyPI của mini, tài liệu registry npm của Claude Code, trang CLI của mini, mini.yaml đi kèm mini, cùng với tài liệu tham khảo CLI và tổng quan của Anthropic.

Vì sao "mini vượt Claude Code" không phải là phán quyết

Trang chủ của mini có một dòng tin tức viết rằng "mini-swe-agent beats Claude Code and Codex on DeepSWE", và đáng để đọc xem DeepSWE thực sự đã đo lường gì. Bài viết của họ nêu: "Every run uses mini-swe-agent, the harness the SWE-bench authors built. We hold it fixed across every model so the leaderboard reflects model capability, not the scaffolding around it." Vì vậy, bảng xếp hạng là bảng xếp hạng các model bên trong mini, không phải bảng xếp hạng mini so với các agent khác.

So sánh harness với harness duy nhất trong công trình đó là một thử nghiệm sơ bộ trên "the same 10 SWE-Bench Pro tasks", trong đó harness được chuẩn hóa ngang bằng hoặc vượt harness nguyên bản với chi phí token tương đương — và các tác giả lập tức cảnh báo rằng "Some of that gap is likely prompt-tuning rather than capability". Mười tác vụ trên một số ít model không phải là mẫu đủ để xếp hạng hai agent, và trong quá trình nghiên cứu trang này không tìm thấy cuộc đối đầu trực tiếp đáng tin cậy nào khác có quy mô đủ dùng. Vì vậy, hướng dẫn này không chấm điểm chúng. Hướng dẫn so sánh những gì có thể kiểm tra: giao thức, quyền hạn, kiểm soát chi tiêu và chi phí di chuyển.

Câu hỏi then chốt: mỗi agent có thể truy cập những endpoint nào

Đây là điểm hai bên khác biệt mạnh nhất, và cũng là phần quyết định liệu gateway có phải một lựa chọn hay không.

Claude Code bị khóa theo giao thức. Hướng dẫn tương thích gateway của Anthropic liệt kê ba định dạng: Anthropic Messages được chọn bằng ANTHROPIC_BASE_URL và gọi /v1/messages cùng /v1/messages/count_tokens tùy chọn; Amazon Bedrock InvokeModel; và rawPredict của Google Cloud Agent Platform. Không có chế độ chat-completions. URL cơ sở là một origin, vì Claude Code nối thêm route — cùng quy tắc được trang ANTHROPIC_BASE_URL riêng của Kunavo mã hóa.

# Claude Code speaks the Anthropic Messages format and appends the route
# itself, so the variable is the ORIGIN — not the /v1 URL mini wants.
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # origin, no /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...              # sent as Authorization: Bearer

# Pin models Kunavo serves. Claude Code's default and its opus alias are the
# newest Opus — pinned here to Opus 5.5, which needs Claude Code v2.1.280 or
# later (run `claude update`). The sonnet alias asks for Sonnet 5.5, which
# Kunavo does not serve: unpinned, /model sonnet, opusplan's execution phase
# and sonnet subagents 404.
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

claude

Có ba hệ quả đáng đưa vào ngân sách. Biến thông tin xác thực quyết định header: trang kết nối của Anthropic nêu rằng "ANTHROPIC_AUTH_TOKEN in Authorization: Bearer, ANTHROPIC_API_KEY in x-api-key, and apiKeyHelper in both", và thông tin xác thực trong biến sai sẽ "reaches the gateway in a header it doesn't read, and the request fails with 401". Bộ nhớ đệm prompt không có cặp beta và sẽ âm thầm thất bại: hướng dẫn Anthropic nói gateway loại bỏ cache_control sẽ tạo ra "No error: the conversation bills as uncached input on every turn". Tính năng phát hiện model bị tắt trừ khi đặt CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, sau đó Claude Code chỉ giữ các id chứa "claude" hoặc "anthropic".

mini không bị ràng buộc bởi giao thức nhưng nặng cấu hình. Hoàn toàn không có biến môi trường URL cơ sở; trang model cục bộ giải thích rằng model_kwargs được truyền thẳng vào litellm.completion(model=model_name, messages=messages, **model_kwargs). Hãy giữ hậu tố /v1 ở đây — ngược với quy tắc của Claude Code ở trên. Ví dụ ngay trên trang đó đặt custom_llm_provider: "openai" trên tên model không có tiền tố, vì vậy tiền tố openai/ bên dưới chỉ là biện pháp dự phòng chứ không bắt buộc; điều trang này nhấn mạnh là nếu sử dụng một trong hai, "this must also match litellm_provider in the config".

# mini has no base-URL environment variable. The endpoint goes in a config
# file, because model_kwargs is splatted straight into litellm.completion().
model:
  model_name: "openai/claude-sonnet-5"        # prefix and provider must agree
  model_kwargs:
    custom_llm_provider: "openai"
    api_base: "https://api.kunavo.com/v1"    # keep /v1 here
    drop_params: true                        # the shipped mini.yaml sets this too
  # set_cache_control is already "default_end" for a name containing "claude"

Cung cấp khóa dưới dạng OPENAI_API_KEY, entweder trong môi trường hoặc thông qua mini-extra config set, lệnh này ghi vào .env của mini; trang cấu hình toàn cục của mini lưu ý rằng "Các biến môi trường được ưu tiên hơn các biến được đặt trong tệp .env." Chọn tệp bằng mini -c kunavo.yaml, hoặc đặt tệp này làm mặc định bằng MSWEA_MINI_CONFIG_PATH.

Một dạng lỗi âm thầm cần có cách khắc phục riêng. Ngân sách cho mỗi lần chạy của mini được thực thi bằng cơ chế theo dõi chi phí của LiteLLM, vốn cần nhận diện được ID mô hình — và việc các ID của Kunavo có được định giá trong danh mục của LiteLLM hay không đã không được kiểm tra cho trang này. Hãy giả định rằng chúng chưa được định giá và tự cung cấp mức giá thay vì dùng MSWEA_COST_TRACKING="ignore_errors", vì tùy chọn đó loại bỏ cơ chế bảo vệ thay vì sửa chữa nó. Hãy đặt LITELLM_MODEL_REGISTRY_PATH trỏ đến một tệp theo định dạng giá mô hình của LiteLLM. Ví dụ minh họa của mini dùng tên mô hình không có tiền tố nhà cung cấp làm khóa cho mục dữ liệu và khai báo nhà cung cấp trong litellm_provider; đây là cấu trúc được sao chép ở đây:

{
  "claude-sonnet-5": {
    "input_cost_per_token": 0.0000014000,
    "output_cost_per_token": 0.0000070000,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

Hai khoảng trống cần nói rõ. Kunavo chưa kiểm thử khi chạy thực tế với endpoint của mình cho cả hai client, và việc công bố tài liệu thiết lập không phải là kiểm thử khả năng tương thích. Cụ thể chưa được xác minh: liệu đường dẫn openai/ của LiteLLM có thương lượng gọi công cụ native — mặc định v2 của mini — với endpoint chat-completions của Kunavo hay không. Nếu không, mini vẫn cung cấp đường dẫn phân tích văn bản cũ dưới dạng model_class: litellm_textbased cùng cấu hình mini_textbased.yaml bên cạnh cấu hình mặc định. Hãy duy trì một tuyến hoạt động trong khi thử một trong hai client, và đọc dữ liệu mà tài khoản của bạn thực sự ghi nhận cho một tác vụ có giới hạn.

Chi phí vận hành của từng công cụ

Giá phần mềm không thể so sánh được, vì chỉ một trong hai phần mềm có giá.

Thẻ giá và bài viết hỗ trợ mô tả các cấp Max khác nhau — một bên gộp chúng thành một con số "từ", bên kia nêu tên cả hai. Hãy xác nhận cấp và tổng số tiền trong bước thanh toán trước khi lập ngân sách. Giá chỗ ngồi Team và Enterprise được cố ý bỏ qua ở đây: đó là quyết định về số chỗ cho một tổ chức, thay vì lựa chọn của một nhà phát triển duy nhất mà trang này đề cập.

Đối với mức sử dụng tính theo đơn vị đo, Anthropic công bố một khoảng ước tính thay vì con số cho mỗi tác vụ: "Trên các triển khai doanh nghiệp, chi phí trung bình khoảng $13 cho mỗi nhà phát triển trong mỗi ngày hoạt động và $150-250 cho mỗi nhà phát triển mỗi tháng, với chi phí dưới $30 mỗi ngày hoạt động đối với 90% người dùng" (tài liệu quản lý chi phí). Đây là số liệu tổng hợp từ các triển khai của chính Anthropic, không phải phép đo của agent này so với agent kia, và mini không có con số tương đương.

Ước tính token minh họa

Đây là phép tính token mang tính minh họa, không phải chi phí tác vụ được đo lường và cũng không phải mức trần hóa đơn. Cả hai agent đều gửi lại cuộc trò chuyện ở mỗi lượt — tài liệu của Anthropic nêu rằng "Claude Code gửi toàn bộ cuộc trò chuyện của bạn trong mỗi yêu cầu, và mỗi khi Claude sử dụng công cụ, nó gửi thêm một yêu cầu chứa lô kết quả công cụ đó" — vì vậy input chiếm phần lớn. Giả sử một tác vụ có giới hạn, tổng cộng 600k token input chưa được lưu trong bộ nhớ đệm qua các lượt và 25k token output. Mức giá là giá trong danh mục Kunavo hiện hành trên mỗi triệu token.

Hãy đọc đây là một tỷ lệ, không phải dự báo. Theo các giả định này, chênh lệch giữa Claude Haiku 4.5 và Claude Opus 5 là khoảng 5,0×, một đòn bẩy lớn hơn việc lựa chọn client. Cũng lưu ý rằng mức giá được niêm yết thấp nhất và chi phí thấp nhất để hoàn thành tác vụ là hai khẳng định khác nhau: một model rẻ hơn nhưng cần ba lần thử có thể tốn nhiều hơn model hoàn thành ngay lần đầu, và vòng lặp tiến trình con độc lập của mini gửi lại nhiều ngữ cảnh hơn khi một bước thất bại. Bộ nhớ đệm lại thay đổi bức tranh, và không theo hướng mà hầu hết các bài viết giả định. Claude Code tự gắn các marker cache_control. mini cũng tự đặt set_cache_control: "default_end", nhưng chỉ cho một số tên model: mã chọn model của nó áp dụng giá trị mặc định đó khi tên model đã phân giải chứa anthropic, claude, sonnet hoặc opus và cấu hình chưa đặt khóa này. Do đó, một id có tên Claude — bao gồm openai/claude-sonnet-5 có tiền tố ở trên — sẽ nhận marker mà bạn không cần yêu cầu; một id có tên Gemini thì không. Trang này chưa kiểm thử liệu endpoint chat-completions có xử lý các marker đó hay không. Xem lưu bộ nhớ đệm prompt.

Số tiền trong danh mục của Kunavo là mức sàn tính phí chứ không phải mức trần: khi upstream báo chi phí, hóa đơn là giá trị lớn hơn giữa chi phí trong danh mục và chi phí upstream nhân với mức tăng giá áp dụng. Phí bộ nhớ đệm và công cụ bên ngoài nằm ngoài ví dụ này. Khoản nạp tối thiểu là $10 tín dụng trả trước — mức tối thiểu để nạp tiền, không phải phí tác vụ hay gói đăng ký. Xem chi tiết thanh toán, đồng thời lưu ý rằng con số /usage của Claude Code được "tính cục bộ từ số lượng token theo giá niêm yết" và rõ ràng là "một ước tính", vì vậy hãy đối chiếu với sổ cái của nhà cung cấp thay vì số liệu hiển thị từ client.

Một điểm cần phân biệt nữa: SWE-agent không phải là mini-SWE-agent

Phiên bản đàn anh cũ vẫn xếp hạng cho các truy vấn này và dùng chung một tổ chức, một nhóm README và dòng dõi benchmark — nhưng có cú pháp cấu hình khác, tài liệu khác và không có chỗ trong hướng dẫn mini. Các maintainer của chính dự án đã chuyển hướng: README của SWE-agent nêu rằng "Phần lớn nỗ lực phát triển hiện tại của chúng tôi tập trung vào mini-swe-agent, sản phẩm đã thay thế SWE-agent" và khuyến nghị dùng mini về sau (đọc ngày 19 tháng 9 năm 2026). Dự án chưa bị lưu trữ, và được cấp phép MIT, vì vậy hãy xem đây là dự án vẫn được duy trì nhưng đã bị thay thế, thay vì đã chết — và bắt đầu công việc mới với mini.

Thiết lập một trong hai công cụ

Kunavo công bố tài liệu tham chiếu cấu hình cho Claude Code nhưng không có tài liệu nào cho mini-SWE-agent; cả hai client đều chưa được kiểm thử khi chạy thực tế ở đây, và một trang thiết lập được công bố không phải là kiểm thử khả năng tương thích. Nếu Claude Code là client của bạn, hãy bắt đầu với hướng dẫn tích hợp Claude Code và tạo tài khoản Kunavo khi bạn sẵn sàng nạp tiền cho một khóa. Nếu trước tiên bạn đang cân nhắc gói đăng ký so với token tính theo mức sử dụng, giá Claude Code và Claude Code không cần gói đăng ký sẽ hỗ trợ quyết định đó, còn API tốt nhất cho Claude Code so sánh các tuyến. Với mini, mô hình là mô hình chung được mô tả trong API tương thích OpenAI. Đang so sánh các agent terminal khác? OpenCode so với Claude Code và giá Aider đề cập thêm hai client với cùng sự phân tách giữa bộ khung miễn phí và hóa đơn model tính theo mức sử dụng.

Câu hỏi thường gặp

Đã kiểm tra ngày 19 tháng 9 năm 2026 bằng cách truy xuất trực tiếp từng nguồn: siêu dữ liệu PyPI của mini-SWE-agent, trang chủ, hướng dẫn di chuyển v2, FAQ, CLI, các trang cấu hình toàn cục và model cục bộ, cùng mini.yaml, run/mini.py và models/__init__.py được đóng gói trong nhánh chính; tài liệu registry npm của Claude Code, tệp giấy phép trong repository, cùng các tài liệu tổng quan, gateway, giao thức gateway, kết nối gateway, chi phí và tham chiếu CLI; claude.com/pricing và bài viết hỗ trợ về gói Max; README của SWE-agent; và bài viết về DeepSWE. Không thực hiện kiểm thử khi chạy thực tế với Kunavo cho cả hai client, và không tái hiện kết quả benchmark nào trên trang này. Mức giá token của Kunavo lấy từ danh mục hiện hành, và mọi ví dụ tính bằng đô la ở đây đều là phép tính token mang tính minh họa.