Cách dùng Cline — phân chia mô hình cho Plan và Act, đồng thời tính chi phí cho một tác vụ

Cline là tác nhân lập trình AI mã nguồn mở chạy trong các trình soạn thảo như VS Code.Cách sử dụng gồm 3 bước — cài tiện ích mở rộng, cấu hình nhà cung cấp API và khóa (Cline không tích hợp sẵn mô hình), rồi lập kế hoạch trong Plan mode trước khi thực hiện trong Act mode. Mô hình được gán cho Plan và Act quyết định chi phí; bật “Use different models for Plan and Act”, gán claude-opus-5 cho Plan và claude-haiku-4-5 cho Act bằng cùng một khóa, thì tác vụ 20 bước giảm từ khoảng $2,17 khi dùng toàn bộ Opus 5 xuống còn khoảng $0,69 (tính theo đơn giá Kunavo).

Nhiều bài hướng dẫn bằng tiếng Nhật chỉ dừng ở việc cài đặt và gửi yêu cầu đầu tiên, trong khi mô hình vẫn cố định ở mô hình miễn phí hoặc một mô hình trả phí duy nhất. Trang này đi xa hơn — thực hiện cả cấu hình tách mô hình cho Plan và Act lẫn tính chi phí cho một tác vụ — bằng một khóa duy nhất.

Cline là gì — hai chế độ Plan và Act

Cline là tác nhân thực hiện vòng lặp đọc tệp, đề xuất thay đổi, chạy lệnh trong terminal, đọc kết quả rồi tiếp tục sửa. Có hai chế độ; tài liệu chính thức của Cline phân chia như sau.

• Plan mode: đọc và tìm kiếm mã nguồn, thảo luận phương án. Không thể sửa tệp hoặc chạy lệnh.
• Act mode: kế thừa ngữ cảnh cuộc trò chuyện trong Plan, đồng thời thay đổi tệp và chạy lệnh.

Cách phân chia này cũng chính là cách phân chia chi phí. Plan có ít lượt trao đổi hơn, và chất lượng quyết định ở đây ảnh hưởng đến hơn chục bước tiếp theo. Act có nhiều lượt trao đổi hơn và gửi lại ngữ cảnh tác vụ mỗi lần, nên đơn giá token tích lũy dần. Dùng mô hình mạnh cho Plan và mô hình rẻ hơn cho Act — tài liệu Cline cũng nêu sự kết hợp giữa mô hình có khả năng suy luận mạnh cho việc lập kế hoạch và mô hình nhanh cho việc triển khai.

Cài đặt và cấu hình ban đầu

1. Trong VS Code, mở chế độ xem tiện ích mở rộng (Ctrl / Cmd + Shift + X), tìm “Cline” và cài đặt. Tiện ích này cũng có trong Cursor, Windsurf, các IDE JetBrains và những môi trường khác.
2. Mở Cline trong thanh bên, vào phần cài đặt (⚙︎) và chọn “OpenAI Compatible” cho API Provider.
3. Nhập Base URL, API Key và Model ID, đồng thời điền các trường trong Model Configuration (độ dài ngữ cảnh, đầu ra tối đa, hỗ trợ hình ảnh, đơn giá đầu vào và đầu ra).

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1   # /v1 まで入れる
API Key        sk-kn-...                    # /app/keys で発行（表示は一度きり）
Model ID       claude-opus-5

Vui lòng nhập Base URL bao gồm cả /v1.Cline chỉ nối thêm route vào phía sau, nên nếu thiếu /v1 sẽ nhận 404. Nếu trả về 401 thì URL đúng nhưng khóa không đúng. Đừng giao quyền chỉnh sửa ngay; trước tiên hãy kiểm tra kết nối bằng một yêu cầu nhỏ như “giải thích tệp này”. Khóa được cấp tại /app/keys và chỉ hiển thị một lần, vì vậy hãy lưu ngay lúc đó.

Trong Model Configuration, Input Price / Output Price là cơ sở tính chi phí Cline hiển thị trong khi thực hiện tác vụ. Giá không được tự động lấy từ endpoint, nên nếu để trống hoặc giữ giá trị mặc định thì chi phí hiển thị sẽ bị lệch. Hãy nhập đơn giá trên mỗi 1M token của model bạn sử dụng. Danh sách các mục cài đặt có trong tài liệu tích hợp Cline.

Phân tách model cho Plan và Act

Trong phần cài đặt, chọn “Use different models for Plan and Act” để có thể chọn các model riêng cho Plan và Act. Base URL và khóa giống nhau ở cả hai; chỉ thay đổi Model ID và đơn giá.

[✓] Use different models for Plan and Act

── Plan Mode ─────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...
Model ID           claude-opus-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        3.50      # 1M トークンあたり USD
  Output Price       17.50

── Act Mode ──────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...            # Plan と同じキーでよい
Model ID           claude-haiku-4-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        0.70
  Output Price       3.50

Lý do đặt Opus 5 cho Plan rất đơn giản. Plan chỉ chiếm một phần rất nhỏ trong tổng số token, nhưng nếu định hướng sai ở đây thì toàn bộ các bước Act có thể trở nên lãng phí. Đặt Haiku 4.5 cho Act vì khi kế hoạch đã cụ thể, phần còn lại chủ yếu là lặp lại việc chỉnh sửa và thực thi; đây là nơi đơn giá token tạo ra khác biệt lớn nhất.

Một bước khi chọn Plan là Sonnet 5 có giá khoảng $0,0434, còn Opus 5 là khoảng $0,11.Claude Sonnet 5 có giá $1,40 / $7,00 cho mỗi 1 triệu token.

Nếu Act bị mắc kẹt, chỉ nâng Act của tác vụ đó lên Opus 5.Nếu lặp lại cùng một lỗi 2 lần thì đó là lúc chuyển đổi. Cố tiếp tục bằng Haiku khiến số bước phình to rốt cuộc còn tốn kém hơn. Chỉ cần thay đổi một Model ID trong phần cài đặt; khóa và endpoint vẫn giữ nguyên.

Tính chi phí cho 1 tác vụ

Cline gửi lại system prompt, lịch sử tác vụ và các tệp đã đọc ở mỗi bước, vì vậy chi phí được quyết định bởi số bước chứ không phải thời gian. Giống các trang giá khác trên trang này, phép tính giả định mỗi bước có 25.000 token đầu vào / 1.200 token đầu ra và mỗi tác vụ có 20 bước (Plan 3 + Act 17).

Phân tách Plan và Act giúp bạn giữ chất lượng lập kế hoạch của Opus 5 với chi phí khoảng 32% so với chạy toàn bộ bằng Opus 5. Dùng toàn bộ Haiku sẽ rẻ hơn nữa, nhưng xét đến chi phí làm lại do kế hoạch sai, khoản chênh lệch $0,26 là mức phí bảo hiểm rẻ cho Plan. Đây là toàn bộ mã dùng để kiểm tra phép tính.

# 1 タスクの費用を、ステップ数から出す。
# 単価は Kunavo の 1M トークンあたり USD (input, output)。
RATES = {
    "claude-opus-5":    (3.50, 17.50),
    "claude-haiku-4-5": (0.70, 3.50),
}

def step(model, inp=25_000, out=1_200):
    i, o = RATES[model]
    return inp / 1e6 * i + out / 1e6 * o

all_opus = 20 * step("claude-opus-5")
split = 3 * step("claude-opus-5") + 17 * step("claude-haiku-4-5")

print(round(all_opus, 2))   # -> 2.17  全部 Opus 5
print(round(split, 2))      # -> 0.69  Plan = Opus 5 / Act = Haiku 4.5

Cách chọn model

GPT-5.6 Sol tính toàn bộ yêu cầu với đầu vào gấp 2 lần và đầu ra gấp 1.5 lần khi prompt vượt quá 272K token. Nếu dùng cho Plan, nên giữ Context Window dưới 272K. Nếu muốn biết chi tiết hơn về khác biệt giữa Opus và Sonnet, xem Khác biệt giữa Claude Opus và Sonnet; đơn giá của toàn bộ model Claude được tổng hợp tại Giá Claude.

5 thói quen giúp giảm chi phí

1. Đừng kéo dài tác vụ; hãy chia nhỏ và bắt đầu một tác vụ mới.Vì toàn bộ lịch sử được gửi lại ở mỗi bước, tác vụ càng dài thì mỗi bước càng đắt. Đây là thói quen có tác động lớn nhất.
2. Nếu dùng prompt cache, hãy đi qua nhà cung cấp Anthropic.Đặt API Provider thành “Anthropic”, chọn “Use custom base URL” và chỉ định https://api.kunavo.com (/v1 không được thêm vào; client sẽ tự thêm /v1/messages). Việc đọc cache của Claude có giá bằng 10% đơn giá đầu vào, còn ghi cache có giá bằng 1.25 lần đơn giá đầu vào. Cơ chế được giải thích trong tài liệu cache. Việc lưu lời nhắc vào bộ nhớ đệm vẫn hoạt động ngay cả khi bạn tiếp tục dùng OpenAI Compatible. Với lời nhắc dài, Kunavo tự đặt các điểm ngắt bộ nhớ đệm trên lời nhắc hệ thống và các định nghĩa công cụ, và cả trên tin nhắn cuối cùng nếu cuộc trò chuyện có lượt trả lời của trợ lý. Trong vòng lặp tác tử, điều này áp dụng cho mọi bước từ bước thứ hai trở đi. cache_control mà Cline thêm vào cũng được giữ nguyên. Khi đi qua nhà cung cấp Anthropic, yêu cầu được chuyển tiếp đúng như Cline đã gửi và không có điểm ngắt nào được thêm vào, vì vậy những gì được lưu vào bộ nhớ đệm phụ thuộc vào các điểm ngắt mà Cline đặt.
3. Ghi các quy tắc vào .clinerules/.Đây là tệp Markdown đặt ở thư mục gốc của dự án, chứa các chỉ dẫn áp dụng cho mọi cuộc hội thoại. Vì được đưa vào mọi yêu cầu, hãy viết ngắn gọn và chỉ ghi các quy tắc cần thiết (tài liệu về quy tắc của Cline).
4. Chỉ bật tự động phê duyệt cho các thao tác đọc.Cho phép đọc tệp và các thao tác tương tự trong Auto Approve sẽ giảm số lần xác nhận. Chế độ YOLO tự động phê duyệt mọi thứ chỉ nên dùng trong môi trường dùng một lần, đúng như tài liệu của Cline ghi rõ là nguy hiểm. Có thể khôi phục thay đổi bằng Checkpoints.
5. Tạo khóa riêng cho Cline và đặt giới hạn hàng tháng.Tại /app/keys bạn có thể đặt giới hạn sử dụng hàng tháng theo từng khóa (khi đạt giới hạn sẽ trả về 402) và danh sách IP được phép. Khi muốn dừng editor, chỉ cần vô hiệu hóa khóa đó.

Nói thẳng — khi nào gói thuê bao hoặc hợp đồng trực tiếp phù hợp

Nếu đã đăng ký Claude Pro / Max, bạn cũng có thể chọn nhà cung cấp “Claude Code” trong Cline.Cách này đi qua Claude Code CLI đã cài đặt và sử dụng hạn mức của gói thuê bao thay vì tính phí theo token. Theo tài liệu của Cline, phương thức này có thể hạn chế tải ảnh lên và prompt cache, đồng thời phản hồi có thể không được stream theo từng token. Vì hạn mức được dùng chung với chat và Claude Code, hãy xem các giới hạn của Claude Pro để hiểu cơ chế.

Khi dùng khóa API, Kunavo hoạt động trên dung lượng dùng chung và không có quota riêng hay SLA theo hợp đồng. Những đội nhóm cần bảo đảm nên ký hợp đồng trực tiếp với Anthropic. Với cá nhân hoặc nhóm nhỏ chạy Cline, mô hình tính phí theo mức sử dụng, cho phép tách Plan và Act bằng một khóa, là lựa chọn phù hợp.

Khác biệt so với cách dùng Roo Code

Roo Code là một extension phát sinh từ Cline và có thể dùng nguyên cấu hình OpenAI Compatible (Base URL, khóa, model). Khác biệt nằm ở cấu trúc chế độ: thay vì Plan / Act, Roo Code có các chế độ như Architect, Code, Ask và Debug, đồng thời gán profile cấu hình API cho từng chế độ. Có thể áp dụng nguyên tắc tương tự: Opus 5 cho Architect và model rẻ hơn cho Code. Hướng dẫn có tại tài liệu cài đặt Roo Code và Roo Code + Claude API (tiếng Anh).

Để xem giải thích chi tiết hơn bằng tiếng Anh, hãy xem Hướng dẫn Cline + Claude API; nếu muốn so sánh với agent dạng terminal, xem So sánh Cline và Claude Code cùng Cách dùng Claude Code. Đơn giá của toàn bộ model có tại trang giá.

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