Cách cài đặt Claude Code dễ dàng trên Windows và Mac

Nhanh chóng cài đặt Claude Code trên Windows hoặc Mac, cấu hình môi trường và kết nối với Kimi API cho các quy trình AI nâng cao. Tự động hóa tác vụ phức tạp, thực hiện quy trình nhiều bước và cải thiện trải nghiệm lập trình nhờ tích hợp AI thông minh hơn.

10 phút đọcĐã cập nhật: 2026-09-28

Kết nối Claude Code với Kimi API

Các công cụ lập trình AI đang trở thành lựa chọn phổ biến cho những nhà phát triển muốn làm việc nhanh hơn và xử lý tác vụ hiệu quả hơn. Nhiều người chọn cài đặt Claude Code để tinh gọn quy trình lập trình, tự động hóa công việc lặp lại và quản lý các quy trình nhiều bước trong một môi trường duy nhất. Việc thiết lập đúng trên Windows hoặc Mac giúp bảo đảm hiệu năng ổn định và tích hợp tốt hơn với các dịch vụ AI nâng cao. Hãy đọc tiếp để tìm hiểu cách cài đặt Claude Code trên Windows và Mac.

Cách cài đặt Claude Code trên Windows?

Windows 11 cung cấp môi trường ổn định để chạy các công cụ phát triển AI hiện đại. Một vài bước thiết lập đơn giản có thể giúp bảo đảm Claude Code hoạt động đúng cách và kết nối với các dịch vụ bạn dự định sử dụng. Hãy làm theo hướng dẫn bên dưới để hoàn tất quá trình cài đặt và bắt đầu sử dụng các tính năng mà không gặp trở ngại.

Bước 1: Cài đặt Claude Code bằng PowerShell

Mở PowerShell bằng cách nhấn Win + S rồi tìm kiếm "PowerShell". Sao chép và dán lệnh cài đặt bên dưới vào PowerShell, sau đó nhấn "Enter" để chạy:

irm https://claude.ai/install.ps1 | iex

PowerShell sẽ tự động tải xuống và cài đặt Claude Code. Hãy chờ quá trình cài đặt hoàn tất trước khi tiếp tục. Nếu muốn dùng CMD hoặc WinGet, bạn cũng có thể tham khảo các phương thức cài đặt khác trong tài liệu chính thức của Claude Code.

Bước 2: Cài đặt Git và khởi chạy Git Bash

Tải xuống và cài đặt Git cho Windows. Giữ nguyên các thiết lập cài đặt mặc định để Claude Code có thể truy cập các công cụ dòng lệnh cần thiết và hoạt động đúng cách.

Sau khi tải Git, hãy mở trình cài đặt và hoàn tất quá trình thiết lập bằng các cài đặt mặc định. Giữ nguyên đường dẫn cài đặt, chọn "Visual Studio Code" làm trình soạn thảo mặc định nếu được hỏi, đồng thời bảo đảm tùy chọn "Git from the command line and 3rd-party software" được chọn trong phần cấu hình PATH.

Sau khi cài đặt xong, mở "Git Bash" từ menu Start để kiểm tra Git hoạt động bình thường. Git Bash cung cấp môi trường terminal cần thiết để Claude Code chạy lệnh trên Windows.

Bước 3: Kiểm tra cài đặt Claude Code

Quay lại PowerShell hoặc Command Prompt và chạy:

claude --version

Nếu số phiên bản xuất hiện, Claude Code đã được cài đặt thành công. Nếu không, hãy tiếp tục các bước cấu hình PATH.

Bước 4: Hoàn tất cài đặt

Sau khi hoàn tất mọi thứ, hãy đăng nhập vào Claude Code và kết thúc quá trình thiết lập. Sau khi đăng nhập, công cụ đã sẵn sàng để chạy lệnh và quản lý quy trình làm việc có AI hỗ trợ ngay từ terminal trên Windows 11.

Cách cài đặt Claude Code trên Mac/macOS?

macOS cung cấp cách thiết lập công cụ phát triển gọn gàng và đơn giản nhờ hỗ trợ terminal tích hợp sẵn, giúp quá trình cài đặt diễn ra suôn sẻ và nhất quán cho lập trình viên. Việc thiết lập Claude Code gồm một quy trình rõ ràng dựa trên terminal, giúp mọi thứ luôn có tổ chức và dễ quản lý. Dưới đây là cách cài đặt Claude Code trên Mac.

Bước 1: Cài đặt Claude Code qua Terminal (lệnh curl)

Mở "Terminal" trên Mac bằng Spotlight Search (Cmd + Space → nhập "Terminal"). Sao chép và dán lệnh cài đặt bên dưới vào Terminal, rồi nhấn "Enter":

curl -fsSL https://claude.ai/install.sh | bash

Terminal sẽ tự động tải xuống và cài đặt Claude Code. Hãy chờ quá trình cài đặt hoàn tất trước khi chuyển sang bước tiếp theo.

Cài đặt Claude Code qua Terminal (lệnh curl)

Bước 2: Xác nhận cài đặt Claude Code

Hãy chờ quá trình cài đặt hoàn tất hoàn toàn. Sau đó, thông báo xác nhận sẽ xuất hiện, cho biết Claude Code đã được cài đặt thành công. Nếu terminal yêu cầu thiết lập thêm, hãy chạy lệnh được đề xuất để thêm Claude Code vào tệp cấu hình zshrc, bảo đảm có thể truy cập đúng cách.

Bước 3: Tải cấu hình môi trường

Sau khi cài đặt, hãy chạy lệnh được cung cấp hoặc tải lại tệp cấu hình shell. Bước này cập nhật các biến môi trường để Claude Code hoạt động trên toàn cục trong terminal mà không gặp vấn đề về đường dẫn. Nhờ đó, bạn có thể truy cập thuận tiện mỗi khi mở cửa sổ terminal mới.

Bước 4: Khởi chạy Claude Code

Trong Terminal, nhập:

claude

Nhấn Enter để khởi động CLI của Claude Code. Màn hình thiết lập sẽ xuất hiện, tại đây bạn có thể chọn giao diện và phương thức đăng nhập mong muốn để hoàn tất cấu hình cuối cùng.

Cách tích hợp các API LLM khác vào Claude Code?

Việc dùng Claude Code với các mô hình AI bên ngoài giúp quá trình phát triển linh hoạt hơn. Kết nối API LLM của bên thứ ba cho phép lập trình viên chạy các mô hình khác nhau trong cùng một môi trường và quản lý tác vụ hiệu quả hơn. Chẳng hạn, các API có khả năng hiểu ngữ cảnh dài và tạo đầu ra có cấu trúc tốt có thể cải thiện thêm quy trình lập trình. Trong các bước sau, Kimi được dùng làm ví dụ để minh họa cách kết nối API LLM bên ngoài với Claude Code.

Bước 1: Lấy Khóa API Kimi Code

Lưu ý: endpoint api.kimi.ai/coding/ dùng trong hướng dẫn này là một phần của quyền lợi thành viên Kimi Code. Hãy đảm bảo bạn có gói thành viên Kimi đang hoạt động và đã kích hoạt quyền lợi Kimi Code trước khi tạo khóa — khóa từ tài khoản miễn phí sẽ bị từ chối khi khởi chạy.

Truy cập Kimi Code Console, nhấp vào Tạo Khóa API, nhập tên rồi xác nhận, sau đó sao chép khóa ngay — toàn bộ khóa chỉ hiển thị một lần. Các mô hình và cửa sổ ngữ cảnh khả dụng tùy thuộc vào gói thành viên của bạn (ví dụ: gói Andante cũ dùng kimi-for-coding với ngữ cảnh 1M; gói Plus/Moderato có thể dùng k3-256k; gói Pro/Allegretto trở lên có thể dùng k3 với ngữ cảnh 1M hoặc biến thể tốc độ cao).

Kết nối Claude Code với Kimi API

Bước 2: Bỏ qua đăng nhập (tập lệnh thiết lập tùy chọn)

Sau khi cài đặt, chưa khởi động Claude Code. Hãy chạy tập lệnh sau trong terminal để bỏ qua quy trình thiết lập/đăng nhập mặc định và dọn dẹp cấu hình cũ. Tập lệnh này kích hoạt hỗ trợ mô hình bên thứ ba và chế độ nhanh, đồng thời xóa các mục endpoint, thông tin xác thực và mô hình đã cũ khỏi ~/.claude/settings.json (các mục còn sót trong đó sẽ ghi đè biến môi trường được xuất trong terminal):

node --eval " // enable third party model support and fast mode const claudeJsonFilePath = path.join(os.homedir(), '.claude.json'); if (fs.existsSync(claudeJsonFilePath)) { const content = JSON.parse(fs.readFileSync(claudeJsonFilePath, 'utf-8')); fs.writeFileSync(claudeJsonFilePath, JSON.stringify(Object.assign({}, content, { penguinModeOrgEnabled: true, hasCompletedOnboarding: true }), null, 2), 'utf-8'); } else { fs.writeFileSync(claudeJsonFilePath, JSON.stringify({ penguinModeOrgEnabled: true, hasCompletedOnboarding: true }, null, 2), 'utf-8'); } // delete old endpoint, credential and model id const claudeSettingsJsonFilePath = path.join(os.homedir(), '.claude', 'settings.json'); if (fs.existsSync(claudeSettingsJsonFilePath)) { const content = JSON.parse(fs.readFileSync(claudeSettingsJsonFilePath, 'utf-8')); if (typeof content === 'object' && typeof content.env === 'object') { for (const element of [ 'ANTHROPIC_BASE_URL', 'ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN', 'ANTHROPIC_MODEL', 'ANTHROPIC_SMALL_FAST_MODEL', 'CLAUDE_CODE_SUBAGENT_MODEL', 'ANTHROPIC_DEFAULT_FABLE_MODEL', 'ANTHROPIC_DEFAULT_FABLE_MODEL_NAME', 'ANTHROPIC_DEFAULT_OPUS_MODEL', 'ANTHROPIC_DEFAULT_OPUS_MODEL_NAME', 'ANTHROPIC_DEFAULT_SONNET_MODEL', 'ANTHROPIC_DEFAULT_SONNET_MODEL_NAME', 'ANTHROPIC_DEFAULT_HAIKU_MODEL', 'ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME', 'ENABLE_TOOL_SEARCH', 'CLAUDE_CODE_AUTO_COMPACT_WINDOW', 'CLAUDE_CODE_EFFORT_LEVEL', ]) { delete content.env[element]; } fs.writeFileSync(claudeSettingsJsonFilePath, JSON.stringify(content, null, 2), 'utf-8'); } }"

Tập lệnh này yêu cầu Node.js (kiểm tra bằng node --version; nếu không tìm thấy lệnh, hãy cài đặt phiên bản LTS từ nodejs.org trước). Khi thành công, tập lệnh không in ra gì — điều đó là bình thường. Đồng thời kiểm tra các tệp cấu hình shell như ~/.zshrc và ~/.bashrc để tìm các lệnh xuất ANTHROPIC_* cũ rồi xóa chúng, nếu không chúng sẽ gây nhiễu cấu hình mới (người dùng Windows: kiểm tra các biến môi trường của người dùng).

Bước 3: Cấu hình quyền truy cập API và khởi chạy Claude Code

Có hai phương thức cấu hình — chỉ chọn một, không kết hợp cả hai. Phương thức 1 ghi vào ~/.claude/settings.json và có hiệu lực lâu dài; Phương thức 2 chỉ xuất biến trong terminal hiện tại, có hiệu lực trong phiên đó. Ví dụ bên dưới dùng k3-256k (ngữ cảnh 256K); nếu gói của bạn có k3 với ngữ cảnh 1M, hãy thay mọi giá trị mô hình bằng k3[1m] và đặt cả hai giá trị ngữ cảnh thành 1048576.

Phương thức 1: Ghi vào settings.json (khuyến nghị, có hiệu lực lâu dài)

Ghi nội dung sau vào trường env của ~/.claude/settings.json (trên Windows: %USERPROFILE%\.claude\settings.json; hãy tạo tệp nếu chưa tồn tại), rồi khởi động lại Claude Code để các thiết lập có hiệu lực:

{ "env": { "ANTHROPIC_BASE_URL": "https://api.kimi.ai/coding/", "ANTHROPIC_API_KEY": "Your API Key", "ANTHROPIC_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_FABLE_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_OPUS_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_SONNET_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "k3-256k", "CLAUDE_CODE_SUBAGENT_MODEL": "k3-256k", "CLAUDE_CODE_EFFORT_LEVEL": "high", "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "262144", "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "262144" } }

Thay Your API Key bằng khóa bạn đã sao chép ở Bước 1. Tệp lưu khóa dưới dạng văn bản thuần — không commit tệp này vào git. Lưu ý rằng khối env trong settings.json sẽ ghi đè các biến cùng tên được xuất trong terminal.

Phương thức 2: Biến môi trường trong terminal (chỉ phiên hiện tại)

macOS / Linux

export ANTHROPIC_BASE_URL=https://api.kimi.ai/coding/ export ANTHROPIC_API_KEY="Your API Key" export ANTHROPIC_MODEL="k3-256k" export ANTHROPIC_DEFAULT_FABLE_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_OPUS_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_SONNET_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_HAIKU_MODEL=$ANTHROPIC_MODEL export CLAUDE_CODE_SUBAGENT_MODEL=$ANTHROPIC_MODEL export CLAUDE_CODE_EFFORT_LEVEL=high export CLAUDE_CODE_AUTO_COMPACT_WINDOW=262144 export CLAUDE_CODE_MAX_CONTEXT_TOKENS=262144 claude

Windows

Đặt các biến môi trường tương tự trong PowerShell hoặc phần cài đặt hệ thống, rồi chạy:

$env:ANTHROPIC_BASE_URL="https://api.kimi.ai/coding/" $env:ANTHROPIC_API_KEY="Your API Key" $env:ANTHROPIC_MODEL="k3-256k" $env:ANTHROPIC_DEFAULT_FABLE_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_OPUS_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_SONNET_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_HAIKU_MODEL=$env:ANTHROPIC_MODEL $env:CLAUDE_CODE_SUBAGENT_MODEL=$env:ANTHROPIC_MODEL $env:CLAUDE_CODE_EFFORT_LEVEL="high" $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144" $env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="262144" claude

Thay Your API Key bằng khóa bạn đã sao chép ở Bước 1. Nếu chỉ cấu hình một số biến mô hình, các tình huống tương ứng (hội thoại chính, tóm tắt nền, tác tử phụ) sẽ âm thầm thất bại, vì vậy hãy giữ đầy đủ bộ biến.

Nếu được hỏi có sử dụng khóa API này hay không, hãy xác nhận để tiếp tục. Sau đó, làm theo lời nhắc để chọn thư mục dự án đáng tin cậy của bạn và hoàn tất việc cấp quyền.

Bước 4: Xác minh trạng thái tích hợp

Sau khi khởi chạy, hãy chạy:

/status

Nếu Base URL hiển thị:

https://api.kimi.ai/coding/

Khi đó, việc tích hợp đã thành công. Ngay cả khi giao diện vẫn hiển thị các mô hình Claude, mọi yêu cầu đều được định tuyến qua Kimi Code API.

Lợi ích khi sử dụng Kimi API

Việc dùng các công cụ AI tiên tiến trong phát triển đã trở thành cách thiết thực để tăng tốc công việc và nâng cao chất lượng mã nguồn nói chung. Kimi API hỗ trợ tốt cho việc thấu hiểu, tự động hóa và quy trình làm việc theo nhóm trong các dự án thực tế. Dưới đây là cách công cụ này giúp nhà phát triển xây dựng và quản lý hệ thống hiệu quả hơn.

Hiểu ngữ cảnh đa phương thức cho các tác vụ phát triển

Kimi API hiểu nhiều loại dữ liệu đầu vào như văn bản, bản thiết kế mô phỏng, sơ đồ kiến trúc, lưu đồ và cả video. Công cụ này chuyển những thông tin đó thành các kế hoạch kỹ thuật rõ ràng để nhà phát triển có thể sử dụng trực tiếp. Nhờ vậy, ý tưởng được chuyển thành mã hoạt động với ít công sức lập kế hoạch thủ công hơn.

Tiết kiệm chi phí hơn nhờ tái sử dụng ngữ cảnh

Kimi API hỗ trợ tái sử dụng ngữ cảnh, cho phép nhà phát triển tiếp tục làm việc với các cuộc trò chuyện và ngữ cảnh dự án hiện có thay vì liên tục gửi lại cùng một thông tin. Điều này giúp giảm mức sử dụng token không cần thiết, hạ chi phí API và tăng hiệu quả cho quy trình phát triển dài hạn.

Tự động hóa các quy trình kỹ thuật lặp lại

Các tác vụ lập trình thường nhật và lặp đi lặp lại có thể được tự động hóa bằng script hoặc quy trình do AI điều khiển. Những tác vụ này có thể chạy bằng các lệnh đơn giản thay vì phải thực hiện thủ công mỗi lần. Điều này giúp tiết kiệm thời gian và giảm nguy cơ lỗi do con người trong các quy trình phát triển hằng ngày.

Tùy chỉnh quy trình phát triển bằng Skills và công cụ

Kimi API hỗ trợ Skills tùy chỉnh và tích hợp công cụ cho các nhu cầu phát triển khác nhau. Các nhóm có thể kết nối trực tiếp công cụ, script và hệ thống nội bộ của riêng mình vào quy trình. Nhờ đó, quy trình phát triển trở nên linh hoạt hơn và phù hợp với từng dự án.

Cộng tác đa tác tử để nâng cao chất lượng và hiệu quả

Các tác tử AI khác nhau đảm nhiệm những vai trò như lập trình, kiểm thử, kiến trúc và tài liệu. Những tác tử này có thể phối hợp theo tuần tự hoặc song song để hoàn thành tác vụ nhanh hơn. Điều này cải thiện cả tốc độ phát triển lẫn chất lượng đầu ra tổng thể.

Khắc phục sự cố khi cài đặt Claude Code

Khi cài đặt Claude Code trên Windows hoặc Mac, người dùng đôi khi có thể gặp một số vấn đề kỹ thuật nhỏ do thiết lập môi trường, phiên bản Node.js hoặc điều kiện mạng. Những vấn đề này thường gặp ở các công cụ dựa trên CLI và thường có thể khắc phục. Dưới đây là các sự cố phổ biến nhất và cách hiểu chúng một cách thực tế.

"không tìm thấy lệnh: claude"

Lỗi này thường có nghĩa là Claude Code chưa được thêm vào PATH của hệ thống. Terminal không thể xác định vị trí tệp nhị phân đã cài đặt. Khởi động lại terminal hoặc chỉnh sửa cài đặt PATH thường sẽ giải quyết nhanh chóng và đáng tin cậy sự cố này trong đa số trường hợp.

Xác thực thất bại hoặc trình duyệt không mở

Điều này xảy ra khi quá trình đăng nhập không thể tự động mở trình duyệt, thường là trên các hệ thống bị hạn chế hoặc môi trường từ xa. Trong những trường hợp này, có thể cần xác thực thủ công bằng API key. Sau khi cấu hình, quá trình đăng nhập sẽ hoạt động bình thường mà không gặp thêm vấn đề.

"Lỗi mạng" hoặc hết thời gian chờ khi cài đặt

Nguyên nhân thường là do internet chậm, tường lửa hạn chế hoặc quyền truy cập npm bị chặn. Trình cài đặt có thể không kết nối được với các máy chủ cần thiết trong quá trình thiết lập. Điều chỉnh cài đặt mạng, cấu hình proxy hoặc chuyển sang kết nối khác thường sẽ khắc phục hiệu quả vấn đề này.

Claude Code chạy chậm

Các vấn đề về hiệu năng thường không phải do chính công cụ gây ra mà do độ trễ mạng. Vì Claude Code phụ thuộc vào các yêu cầu API trên đám mây, kết nối internet không ổn định hoặc việc dùng VPN có thể làm công cụ chậm hơn. Kết nối ổn định thường cải thiện tốc độ đáng kể và nhất quán.

Kết luận

Tìm hiểu cách cài đặt Claude Code trên Windows hoặc Mac giúp bạn bắt đầu quy trình phát triển có AI hỗ trợ một cách thuận lợi hơn. Sau khi thiết lập, bạn có thể quản lý các tác vụ lập trình hiệu quả hơn và tinh gọn công việc phát triển hằng ngày trong một môi trường tích hợp hơn. Với các trường hợp sử dụng nâng cao hoặc linh hoạt hơn, bạn có thể thử Kimi API để mở rộng những khả năng này và cải thiện các quy trình phát triển trong thực tế.

Kết nối Claude Code với Kimi API

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

Bạn có thể khởi động Claude Code bằng cách mở terminal hoặc PowerShell rồi nhập lệnh claude. Nhấn Enter để mở giao diện CLI. Nếu cài đặt đúng, màn hình thiết lập sẽ xuất hiện và hướng dẫn bạn đăng nhập hoặc chọn dự án. Sau đó, bạn có thể bắt đầu dùng các lệnh trực tiếp trong terminal.

Không phải lúc nào cũng cần gói đăng ký trả phí, nhưng một số tính năng có thể phụ thuộc vào gói hoặc cấp độ truy cập của bạn. Việc sử dụng và thiết lập cơ bản thường có thể hoạt động với quyền truy cập tiêu chuẩn, tùy theo cấu hình. Các khả năng nâng cao hoặc giới hạn cao hơn có thể yêu cầu đăng ký. Tốt nhất nên kiểm tra thông tin chi tiết về các gói Claude chính thức để xác nhận.

Kimi API bổ sung khả năng xử lý ngữ cảnh nâng cao, tự động hóa và quy trình nhiều bước trong Claude Code. API này giúp xử lý hiệu quả hơn các dữ liệu đầu vào dài, tác vụ có cấu trúc và hướng dẫn phát triển phức tạp. Nhờ đó, tốc độ được cải thiện và giảm bớt công sức thủ công khi lập trình. Nhìn chung, quy trình làm việc trở nên linh hoạt và hiệu quả hơn.

Có thể bạn cũng sẽ thích