Tài liệu CLI của Claude Code: lệnh và cờ

Khởi chạy

claude                          # interactive session
claude "fix the failing test"   # start with a prompt
claude -p "summarise this repo"  # print mode: answer, then exit
claude -c                       # continue the most recent session
claude -r                       # pick a session to resume
claude --model claude-opus-5    # choose the model for this session

Các cờ cần biết

• -p, --print — không tương tác; truyền đầu vào qua pipe và nhận đầu ra. Nền tảng cho mọi cách sử dụng trong script và CI.
• --output-format text|json|stream-json — đầu ra có cấu trúc cho chế độ in.
• --model <id> — bất kỳ mô hình nào mà điểm cuối cung cấp (/v1/models trên cổng này liệt kê các mô hình đó).
• --allowedTools "Read,Edit,Bash(git *)" — phê duyệt trước các công cụ để chế độ in không bao giờ phải dừng chờ xác nhận.
• --dangerously-skip-permissions — hoàn toàn không hỏi xác nhận. Chỉ dùng trong container hoặc sandbox có thể xóa bỏ.
• --max-turns N — giới hạn vòng lặp tác nhân khi chạy không tương tác.
• --add-dir <path> — cho phép phiên làm việc trên nhiều thư mục.

Lệnh dấu gạch chéo trong phiên

• /init — viết tệp CLAUDE.md cho dự án (quy ước, lệnh build, những điều cần tránh).
• /compact [focus] — tóm tắt cuộc hội thoại để giải phóng ngữ cảnh; biện pháp kiểm soát chi phí hiệu quả nhất.
• /clear — bắt đầu lại với ngữ cảnh trống.
• /model — chuyển mô hình giữa phiên; /cost — số token và chi phí tính đến hiện tại; /status — điểm cuối, khóa, mô hình, phiên bản.
• /permissions — những việc tác nhân được phép làm mà không cần hỏi; /config — cài đặt; /memory — chỉnh sửa các tệp bộ nhớ.
• /mcp — các máy chủ MCP đã kết nối; /agents — định nghĩa và quản lý tác nhân phụ; /hooks — hook shell cho các sự kiện công cụ.
• /review — đánh giá pull request; /doctor — chẩn đoán bản cài đặt; /help — mọi mục khác.

claude setup-token: xác thực dài hạn cho CI bằng gói đăng ký

claude setup-token đăng nhập một lần trong trình duyệt và in ra token OAuth dài hạn cho gói đăng ký Claude Pro/Max, dành cho môi trường không tương tác nơi không thể dùng /login. Xuất token này thành CLAUDE_CODE_OAUTH_TOKEN trong CI và các lần chạy ở chế độ in sẽ sử dụng hạn mức của gói đăng ký. Cách này chỉ dành cho gói đăng ký; nếu dùng khóa API (Anthropic hoặc cổng), bước này không cần thiết — hãy đặt ANTHROPIC_API_KEY thay thế.

Chế độ in cho script và CI

cat error.log | claude -p "explain the root cause in three lines"

claude -p "write a changelog entry for the staged diff" \
  --allowedTools "Read,Bash(git diff *)" \
  --output-format json

Chế độ in là cách GitHub Action, các tích hợp trình soạn thảo và Agent SDK sử dụng Claude Code. Khi ANTHROPIC_BASE_URL được đặt thành cổng, chi phí của các lần chạy này được tính vào số dư tại cổng hoặc gói không giới hạn của bạn thay vì tài khoản Anthropic.

Vị trí lưu cấu hình

• CLAUDE.md trong thư mục gốc của kho mã (và CLAUDE.local.md cho ghi chú cá nhân) — bộ nhớ dự án, được đọc trong mỗi phiên.
• .claude/settings.json — quyền, hook, biến môi trường cho từng dự án; ~/.claude/settings.json — toàn cục.
• ~/.claude/skills/ và .claude/skills/ — kỹ năng; .claude/agents/ — định nghĩa tác nhân phụ.
• Môi trường: ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN, và các thiết lập ghi đè mô hình theo từng cấp được trình bày trong hướng dẫn về mô hình.

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.