Source: https://aiprimetech.io/vi/claude-code/

[Trang chủ](/vi/) › [Claude Code](/vi/claude-code/)

[Tổng quan](/vi/claude-code/)[Cài đặt](/vi/claude-code/install/)[tài liệu tham khảo CLI](/vi/claude-code/cli/)[Giá và giới hạn](/vi/claude-code/pricing/)[Agent SDK](/vi/claude-code/sdk/)[Kỹ năng và plugin](/vi/claude-code/skills/)[GitHub](/vi/claude-code/github/)[Web, máy tính và IDE](/vi/claude-code/web-and-desktop/)[Mô hình](/vi/claude-code/models/)[Lỗi](/vi/claude-code/errors/)[Có phải mã nguồn mở?](/vi/claude-code/open-source/)[Hướng dẫn thực hành](/vi/claude-code/tutorial/)[Dành cho sinh viên](/vi/claude-code/for-students/)[Tự động hóa QA](/vi/claude-code/qa-automation/)[So với Cursor](/vi/claude-code/vs-cursor/)[So với Codex và OpenCode](/vi/claude-code/vs-codex/)[Tác tử phụ](/vi/claude-code/subagents/)[Hook](/vi/claude-code/hooks/)[MCP](/vi/claude-code/mcp/)[Hệ sinh thái](/vi/claude-code/ecosystem/)[VS Code](/vi/claude-code/vscode/)[OpenRouter](/vi/claude-code/openrouter/)[Giới hạn tốc độ](/vi/claude-code/rate-limits/)[Hướng dẫn bằng tiếng Trung](/claude-code/zh/)

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](/register?promo=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](/register?promo=CLAUDECODE) [Xem các gói không giới hạn](/vi/plans/)

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 Code](/vi/claude-code/install/)[Tài liệu CLI của Claude Code: lệnh và cờ](/vi/claude-code/cli/)[Giải thích giá và giới hạn của Claude Code](/vi/claude-code/pricing/)[Claude Code SDK, nay là Claude Agent SDK](/vi/claude-code/sdk/)[Kỹ năng và plugin của Claude Code](/vi/claude-code/skills/)[Claude Code trong GitHub: App, Action và @claude](/vi/claude-code/github/)[Claude Code có giao diện web không? Giải thích về web, ứng dụng máy tính và IDE](/vi/claude-code/web-and-desktop/)[Claude Code sử dụng mô hình nào và cách thay đổi](/vi/claude-code/models/)[Các lỗi Claude Code và cách khắc phục](/vi/claude-code/errors/)[Claude Code có phải mã nguồn mở không?](/vi/claude-code/open-source/)[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ạn](/vi/claude-code/tutorial/)[Claude 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ục](/vi/claude-code/for-students/)[Cách sử dụng Claude Code để tự động hóa QA](/vi/claude-code/qa-automation/)[Claude Code so với Cursor: chọn công cụ nào, khi nào — và cách sử dụng cả hai](/vi/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: so sánh các tác nhân trong terminal](/vi/claude-code/vs-codex/)[Tá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ân](/vi/claude-code/subagents/)[Hook của Claude Code: kiểm soát hành động của tác nhân theo quy tắc xác định](/vi/claude-code/hooks/)[MCP của Claude Code: kết nối máy chủ, phạm vi, MCP từ xa và ví dụ thực tế](/vi/claude-code/mcp/)[Hệ sinh thái Claude Code: bộ định tuyến, framework, plugin và các danh sách theo dõi chúng](/vi/claude-code/ecosystem/)[Claude Code trong VS Code: tiện ích mở rộng, cách dùng qua terminal và các lỗi](/vi/claude-code/vscode/)[Cách dùng OpenRouter trong Claude Code (và khi nào không nên dùng)](/vi/claude-code/openrouter/)[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ục](/vi/claude-code/rate-limits/)[Cách dùng Claude Code: từ cài đặt đến sử dụng hằng ngày](/claude-code/zh/)