Bắt đầu với Claude Science

Cài đặt

macOS: Tải trình cài đặt từ claude.com/product/claude-science rồi double-click để cài. Lần chạy đầu tiên, ứng dụng thiết lập runtime cùng môi trường Python/R khởi tạo (mất vài phút), sau đó mở một tab mới trong trình duyệt mặc định. Nếu không thấy tab nào xuất hiện, chọn Open từ icon trên menu bar.

Ghi chú

Dù mở ra trong tab trình duyệt, Claude Science là ứng dụng cục bộ - không phải website, không có URL công khai để truy cập. Mở nó từ chính ứng dụng: icon trên menu bar (macOS) hoặc lệnh claude-science (Linux). Khi chạy trên máy chủ từ xa, link đăng nhập được chuyển tới trình duyệt của bạn qua SSH tunnel.

Linux: cài các dependency cho sandbox trước, rồi chạy trình cài đặt. Sandbox cần bubblewrap 0.8.0 trở lên và socat; việc cài đặt cần quyền sudo - nếu không có, nhờ quản trị hệ thống cài giúp.

# Ubuntu / Debian
sudo apt-get update && sudo apt-get install -y curl bubblewrap socat

# Fedora / RHEL
sudo dnf install -y curl bubblewrap socat

# Arch
sudo pacman -S curl bubblewrap socat

Chú ý

Repo của Ubuntu 24.04 có bản bubblewrap đủ mới, còn Ubuntu 22.04 thì không. Trên mọi distro, kiểm tra bwrap --version để chắc chắn bản cài từ 0.8.0 trở lên trước khi chạy Claude Science.

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

Lần chạy đầu tiên, lệnh in ra một URL cục bộ ngay lập tức, rồi tiếp tục thiết lập môi trường Python/R khởi tạo.

Đăng nhập & hoàn tất thiết lập

Khi ứng dụng mở trong trình duyệt, đăng nhập bằng tài khoản Claude - không cần API key. Nếu redirect OAuth không quay lại được ứng dụng (ví dụ khi dùng qua SSH tunnel), chọn Paste a code ở màn hình đăng nhập thay vì đăng nhập trực tiếp.

Sau khi đăng nhập, một setup wizard sẽ hướng dẫn bạn bật connector, skill, và cấu hình các website mà Claude được phép truy cập. Bạn có thể đổi lại các thiết lập này bất cứ lúc nào trong Settings.

Ghi chú

Claude Science lưu toàn bộ dữ liệu trong một thư mục duy nhất (~/.claude-science) ở home directory; trên Linux, lệnh claude-science được cài vào ~/.local/bin. Ứng dụng không đụng vào cài đặt conda, thư viện R, hay shell config hiện có của bạn.

Nguy hiểm

Xoá thư mục ~/.claude-science sẽ xoá toàn bộ project, artifact, và lịch sử hội thoại. Xoá cả thư mục lẫn ứng dụng đồng nghĩa gỡ bỏ hoàn toàn Claude Science.

Chạy phân tích đầu tiên

1. Mở Example project có sẵn, hoặc tạo project mới.
2. Bắt đầu một cuộc hội thoại - trỏ tới thư mục trên máy bằng cách gõ đường dẫn hoặc dùng picker @ trong ô soạn tin.
3. Xem xét thẻ xin quyền truy cập thư mục khi nó xuất hiện, và quyết định có cho phép hay không.
4. Xem xét thẻ xin quyền chạy code khi Claude đề xuất chạy, và quyết định có cho phép hay không.
5. Kết quả xuất hiện dưới dạng artifact trong panel Files.

Xử lý sự cố lần chạy đầu

• macOS báo ứng dụng không được hỗ trợ, hoặc icon bị gạch chéo: bạn tải nhầm bản dành cho kiến trúc CPU khác. Quay lại trang tải, chọn đúng Mac (Intel) hoặc Mac (Apple Silicon) - kiểm tra tại menu Apple → About This Mac → dòng Chip/Processor.
• Không có tab trình duyệt nào mở ra: trên macOS, chọn Open từ icon menu bar. Trên Linux, copy URL được in ra vào trình duyệt trên cùng máy, hoặc chạy claude-science url để lấy URL mới.
• Linux từ chối khởi động: thiếu dependency cho sandbox (cài bubblewrap và socat như hướng dẫn ở trên), bản quá cũ, hoặc bị chặn - kiểm tra bằng bwrap --version.
• Đăng nhập bị chặn tại claude.ai: tài khoản đang ở gói Free (cần nâng cấp), redirect không quay lại được (dùng Paste a code), hoặc tổ chức Team/Enterprise của bạn chưa bật Claude Science.

Nguồn

Trang này dịch từ Get started with Claude Science trong tài liệu chính thức.