Trang chủ › Claude Code
Tổng quanCài đặttài liệu tham khảo CLIGiá và giới hạnAgent SDKKỹ năng và pluginGitHubWeb, máy tính và IDEMô hìnhLỗiCó phải mã nguồn mở?Hướng dẫn thực hànhDành cho sinh viênTự động hóa QASo với CursorSo với Codex và OpenCodeTác tử phụHookMCPHệ sinh tháiVS CodeOpenRouterGiới hạn tốc độHướng dẫn bằng tiếng Trung
Cập nhật lần cuối: ngày 11 tháng Mười, 2026

Claude Code: hướng dẫn đầy đủ

Claude Code là công cụ lập trình theo mô hình tác tử của Anthropic: một chương trình chạy trong terminal (và từ cuối 2025, còn có ứng dụng web, ứng dụng máy tính và tiện ích mở rộng IDE) có thể đọc kho mã của bạn, lập kế hoạch, chỉnh sửa tệp, chạy lệnh và tạo pull request. Các hướng dẫn này trình bày cách cài đặt, sử dụng hiệu quả, chi phí và cách cấu hình công cụ kết nối với một cổng API để bạn không còn phải bận tâm về hóa đơn.

TLDR

  • Cài đặt bằng npm, trình cài đặt gốc hoặc ứng dụng máy tính — mất năm phút trên macOS, Linux, Windows hoặc WSL.
  • Công cụ tính phí qua API theo token, và các phiên dài gửi lại toàn bộ cuộc hội thoại ở mỗi lượt — đó là lý do chi phí tăng cao.
  • Hai biến môi trường (ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY) cấu hình công cụ kết nối với cổng API này: vẫn các mô hình đó, tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá, hoặc gói không giới hạn với phí cố định từ $1.
  • Kỹ năng, plugin, tác tử phụ, máy chủ MCP và GitHub Action đều tiếp tục hoạt động — cổng API nằm bên dưới công cụ, không nằm bên trong nó.

Claude Code thực chất là gì

Claude Code không phải là một cửa sổ trò chuyện có nút viết mã. Đây là một vòng lặp tác tử: bạn mô tả kết quả mong muốn, công cụ kiểm tra kho mã, đề xuất kế hoạch, chỉnh sửa tệp, chạy các bài kiểm thử, đọc lỗi và lặp lại — xin phép trước mọi thao tác có tính phá hủy. Công cụ được phân phối dưới dạng gói npm (@anthropic-ai/claude-code, hiện là 2.1.296), trình cài đặt gốc, tiện ích mở rộng VS Code / JetBrains, ứng dụng máy tính và phiên bản web chạy trong các môi trường sandbox do Anthropic lưu trữ.

Bên trong, mỗi lượt là một lệnh gọi Messages API mang theo toàn bộ cuộc hội thoại tính đến thời điểm đó. Chỉ riêng điều này đã giải thích phần lớn những gì mọi người tìm kiếm về công cụ: vì sao nó mạnh mẽ, vì sao tiêu tốn nhiều token, vì sao giới hạn tốc độ gây trở ngại và vì sao một backend API rẻ hơn hoặc tính phí cố định lại thay đổi trải nghiệm nhiều đến vậy.

Kết nối với cổng API bằng hai dòng

Claude Code đọc các biến môi trường tiêu chuẩn của Anthropic. Đặt URL cơ sở thành địa chỉ cổng API này và dùng khóa từ bảng điều khiển của bạn; mọi thứ khác giữ nguyên.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

Chạy /status trong Claude Code để xác nhận URL cơ sở mà công cụ đang kết nối tới, và /model để chọn mô hình. Mọi mô hình mà cổng API cung cấp đều có thể sử dụng — xem hướng dẫn về mô hình để biết danh sách hiện tại.

Các hướng dẫn

  • Cài đặt — npm, trình cài đặt gốc, Windows/WSL và cách khắc phục lỗi cài đặt.
  • tài liệu tham khảo CLI — cờ, lệnh gạch chéo, chế độ không giao diện và định dạng đầu ra.
  • Giá và giới hạn — chi phí khi dùng API, Pro/Max và cổng API này.
  • Agent SDK — điều khiển Claude Code bằng mã từ Python hoặc TypeScript.
  • Kỹ năng và plugin — kỹ năng là gì, kho tiện ích và cách tự viết kỹ năng.
  • GitHub — GitHub App, Action và @claude trong pull request.
  • Web, máy tính và IDE — những nơi Claude Code có thể chạy ngoài terminal.
  • Mô hình — mô hình mặc định, cách chuyển đổi và ghi đè theo từng bậc.
  • Lỗi — 500, 400, 429, 529, lỗi xác thực và ý nghĩa của từng lỗi.
  • Có phải mã nguồn mở? — phần nào là mã nguồn mở, phần nào không, và các lựa chọn thay thế mở.
  • Hướng dẫn thực hành — phiên làm việc thực tế đầu tiên: CLAUDE.md, chế độ lập kế hoạch, quyền và nén ngữ cảnh.
  • Dành cho sinh viên — cách hợp lệ với chi phí thấp nhất để sử dụng công cụ trong quá trình học.
  • Tự động hóa QA — tạo bài kiểm thử, vòng lặp chạy và sửa lỗi, chạy không giao diện trong CI, Playwright.
  • Tác tử phụ, Hook, MCP — ba điểm mở rộng, mỗi điểm đều có ví dụ hoạt động được.
  • So với Cursor và So với Codex và OpenCode — so sánh thẳng thắn và cách sử dụng chúng cùng nhau.
  • Hệ sinh thái — claude-code-router, SuperClaude, caveman, dòng trạng thái và các danh sách awesome.
  • VS Code, OpenRouter, Giới hạn tốc độ — tiện ích mở rộng và các lỗi của nó, sử dụng backend khác và ý nghĩa của thông báo "đã đạt giới hạn tốc độ".

Dùng thử miễn phí trước

Tài khoản mới nhận được $5 tín dụng API miễn phí với mã CLAUDECODE — đủ cho một buổi tối dùng Claude Code với Sonnet — sau đó là tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Tạo tài khoản với mã CLAUDECODE

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

Claude Code có miễn phí không?

Bản thân công cụ được cài đặt miễn phí. Việc sử dụng được tính phí qua thuê bao Claude Pro/Max hoặc theo token qua API. Trên cổng API này, bạn có thể sử dụng công cụ bằng tín dụng trả theo mức sử dụng hoặc gói không giới hạn với phí cố định.

Claude Code có hoạt động với điểm cuối API khác không?

Có. Công cụ tuân theo ANTHROPIC_BASE_URL, nên mọi điểm cuối tương thích với Anthropic đều hoạt động. Đó chính là cách công cụ kết nối với cổng API này — không cần chỉnh sửa công cụ hay lớp bọc.

Claude Code sử dụng mô hình nào?

Theo mặc định, công cụ sử dụng mô hình thuộc bậc Sonnet hiện tại; bạn có thể chuyển đổi bằng /model hoặc cờ --model và ghi đè từng bậc bằng biến môi trường. Hướng dẫn về mô hình liệt kê các mô hình mà cổng API này hiện cung cấp.

Chạy Claude Code trên cổng API

Vẫn các mô hình đó, hai biến môi trường, tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá — hoặc gói không giới hạn với phí cố định. Tài khoản mới: $5 tín dụng API miễn phí với mã CLAUDECODE.

Lấy khóa API Xem các gói không giới hạn

AI Prime Tech là một cổng API độc lập, không có quan hệ liên kết với Anthropic và không được Anthropic chứng thực hay tài trợ. “Claude” và “Claude Code” là các nhãn hiệu của Anthropic. Các tính năng Claude Code được mô tả ở đây dựa trên tài liệu công khai của Anthropic tại thời điểm viết và thường xuyên thay đổi; giá và danh sách mô hình trên trang này được đọc từ cấu hình hiện hành của cổng API này.

Thêm hướng dẫn về Claude Code

Cách cài đặt Claude CodeTài liệu CLI của Claude Code: lệnh và cờGiải thích giá và giới hạn của Claude CodeClaude Code SDK, nay là Claude Agent SDKKỹ năng và plugin của Claude CodeClaude Code trong GitHub: App, Action và @claudeClaude Code có giao diện web không? Giải thích về web, ứng dụng máy tính và IDEClaude Code sử dụng mô hình nào và cách thay đổiCác lỗi Claude Code và cách khắc phụcClaude Code có phải mã nguồn mở không?Hướng dẫn thực hành Claude Code: phiên làm việc thực tế đầu tiên của bạnClaude dành cho sinh viên: Claude Code, API và những quyền lợi thực tế dành cho giáo dụcCách sử dụng Claude Code để tự động hóa QAClaude Code so với Cursor: chọn công cụ nào, khi nào — và cách sử dụng cả haiClaude Code vs Codex vs OpenCode: so sánh các tác nhân trong terminalTác nhân phụ của Claude Code: cách hoạt động, cách định nghĩa và các nhóm tác nhânHook của Claude Code: kiểm soát hành động của tác nhân theo quy tắc xác địnhMCP của Claude Code: kết nối máy chủ, phạm vi, MCP từ xa và ví dụ thực tếHệ sinh thái Claude Code: bộ định tuyến, framework, plugin và các danh sách theo dõi chúngClaude Code trong VS Code: tiện ích mở rộng, cách dùng qua terminal và các lỗiCách dùng OpenRouter trong Claude Code (và khi nào không nên dùng)Lỗi giới hạn tốc độ của Claude: "API error: rate limit reached" có nghĩa là gì và cách khắc phụcCách dùng Claude Code: từ cài đặt đến sử dụng hằng ngày