Claude Code trong VS Code: tiện ích mở rộng, cách dùng qua terminal và các lỗi

Cài tiện ích mở rộng Claude Code cho VS Code

Tìm Claude Code của Anthropic trong chế độ xem Extensions, hoặc dán vscode:extension/anthropic.claude-code vào trình duyệt để mở trực tiếp. Tiện ích mở rộng là giao diện cho CLI: khi khởi chạy lần đầu, tiện ích kiểm tra tệp thực thi claude và cài đặt nếu chưa có (cách cài qua npm yêu cầu Node.js 18 trở lên; trình cài đặt gốc không cần điều kiện tiên quyết nào). Sau đó, biểu tượng Claude trên thanh hoạt động sẽ mở một bảng để bạn trò chuyện, và mọi thay đổi mà tác nhân thực hiện đều hiển thị dưới dạng bản so sánh ngay trong mã để bạn chấp nhận hoặc từ chối — cùng quy trình như trong terminal, với trình soạn thảo làm nơi xem xét thay đổi.

# check the CLI the extension will use
claude --version
# if it is missing, install it yourself and reload VS Code
npm install -g @anthropic-ai/claude-code     # or: curl -fsSL https://claude.ai/install.sh | bash

Hoặc bỏ qua tiện ích mở rộng: Claude Code trong terminal tích hợp

Mở terminal của VS Code và chạy claude. Đây là tác nhân với đầy đủ chức năng — chế độ lập kế hoạch, tác nhân con, hook, MCP, /compact — và hoạt động trong mọi bản fork của VS Code, bao gồm Cursor và VSCodium, mà không cần tiện ích mở rộng. Các chỉnh sửa xuất hiện ngay trong những tệp đang mở và chế độ xem so sánh thay đổi của VS Code sẽ hiển thị chúng. Với các tác vụ tự chủ kéo dài, phần lớn người dùng thích cách này hơn; với các chỉnh sửa tương tác nhỏ, bảng của tiện ích mở rộng thuận tiện hơn. Cả hai có thể chạy đồng thời.

Kiểm tra tài khoản mà Claude Code đang dùng trong VS Code

Cả tiện ích mở rộng lẫn terminal đều đọc cùng một cấu hình, nên kết quả ở cả hai đều giống nhau: chạy /status trong một phiên. Lệnh sẽ hiển thị endpoint (ANTHROPIC_BASE_URL), cho biết khóa API hay gói đăng ký /login đang được sử dụng, cùng mô hình và phiên bản. Nếu khóa API được đặt trong môi trường, khóa đó sẽ được ưu tiên hơn tài khoản đăng nhập; đây là nguyên nhân thường gặp của tình huống "Tôi đã đăng nhập bằng Max nhưng phí lại bị trừ vào số dư API". Để chuyển đổi, hãy bỏ thiết lập ANTHROPIC_API_KEY để dùng gói đăng ký, hoặc thiết lập biến này (cùng với ANTHROPIC_BASE_URL nếu dùng cổng trung gian) để trả phí theo mức sử dụng.

# use this gateway from VS Code: put these in your shell profile, restart VS Code
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key

VS Code kế thừa các biến môi trường từ shell đã khởi chạy nó. Nếu /status vẫn hiển thị endpoint cũ sau khi bạn thay đổi hồ sơ cấu hình, hãy thoát hoàn toàn khỏi VS Code rồi khởi động lại từ một terminal mới — chỉ tải lại cửa sổ là chưa đủ.

Lỗi: không tìm thấy lệnh 'claude-vscode.editor.openlast'

Lỗi này xuất hiện khi phím tắt hoặc bảng lệnh gọi tiện ích mở rộng trước khi tiện ích được kích hoạt, hoặc khi tiện ích đã được kích hoạt nhưng không tìm thấy CLI mà nó bao bọc.

Theo thứ tự: 1) Tải lại cửa sổ (Developer: Reload Window) — phần lớn trường hợp được giải quyết ở bước này. 2) Chạy claude --version trong terminal; nếu không tìm thấy, hãy cài CLI (ở trên) rồi tải lại một lần nữa. 3) Kiểm tra xem tiện ích mở rộng đã được bật cho không gian làm việc này hay chưa, thay vì chỉ được cài đặt. 4) Nếu bạn dùng một bản fork của VS Code, hãy xác nhận phiên bản tiện ích mở rộng có hỗ trợ bản fork đó — nếu không, cách dùng terminal vẫn hoạt động. 5) Nếu mọi cách khác đều không hiệu quả, hãy gỡ cài đặt tiện ích mở rộng, xóa ~/.claude/ bộ nhớ đệm chỉ khi bạn chấp nhận mất lịch sử phiên cục bộ, rồi cài đặt lại.

Các vấn đề khác với tiện ích mở rộng

• Bảng mở ra nhưng vẫn trống → CLI đang khởi động; kiểm tra bảng Output (Claude Code) để xem lỗi thực tế, thường là do Node.js quá cũ.
• Bản so sánh thay đổi trong mã không bao giờ xuất hiện → không gian làm việc chưa được tin cậy; VS Code chặn tiện ích mở rộng trong Chế độ hạn chế.
• Hoạt động trong terminal nhưng không hoạt động trong bảng → proxy hoặc ANTHROPIC_BASE_URL chỉ được thiết lập trong hồ sơ cấu hình shell của bạn, chứ không có trong môi trường đã dùng để khởi chạy VS Code.
• 401 / khóa không hợp lệ → khóa không khớp với endpoint; URL của cổng trung gian cần khóa của cổng trung gian, URL của Anthropic cần khóa từ bảng điều khiển.

Chi phí khi dùng trong VS Code

Tiện ích mở rộng tính phí giống hệt CLI — theo từng token thông qua dịch vụ được kết nối phía sau. Trên cổng trung gian này, bạn dùng tín dụng có giá trị bằng 7.69231× mệnh giá ($13 mua được $100 mức sử dụng, giảm 87%) hoặc gói không giới hạn giá cố định từ $1; hướng dẫn về giá có thông tin chi tiết, còn hướng dẫn về mô hình liệt kê những mô hình mà /model có thể chọn.

Tất cả các gói không giới hạn →

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

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

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.