Bài viết chia sẻ 14 cấu hình thiết yếu giúp rút ngắn đáng kể thời gian thiết lập Claude Code, từ cài đặt ban đầu đến tối ưu quyền truy cập và tự động hóa. Hướng dẫn chi tiết này hỗ trợ cả người mới và lập trình viên chuyên nghiệp nhằm nâng cao hiệu quả phát triển.

14 Cấu Hình Quan Trọng Giúp Giảm 75% Thời Gian Cài Đặt Claude Code

Bài viết tổng hợp 14 cấu hình thiết yếu trong Claude Code giúp giảm tới 75% thời gian cài đặt và chuẩn bị môi trường làm việc. Từ việc cài đặt nhanh chóng đến thiết lập quyền truy cập phù hợp và tự động hóa công việc, hướng dẫn này giúp người dùng làm chủ công cụ một cách hiệu quả nhất.

6.1 Cài Đặt và Khởi Tạo Ban Đầu: Từ Không Đến Chạy Claude Code Trong 5 Phút

Trước kia, việc debug setup Claude Code mất hàng giờ vì cấu hình sai, nay chỉ còn vài phút nhờ các bước sau:

Cài đặt:

Qua npm: npm install -g @anthropic-ai/claude-code
Qua yarn: yarn global add @anthropic-ai/claude-code

Đăng nhập:

Giao diện tương tác (mở trình duyệt): claude login
Phi tương tác bằng API key: export ANTHROPIC_API_KEY="sk-ant-..."

Khởi tạo và sử dụng lần đầu:

cd your-project
claude "Analyze my project structure"
claude --init  # Tự động tạo file CLAUDE.md
claude doctor   # Kiểm tra và xử lý sự cố môi trường

Lưu ý trên WSL, đảm bảo node nằm trong PATH và đã cài bubblewrap để sandbox. Dùng lệnh /doctor để khắc phục lỗi phổ biến về PATH và Node.js.

6.2 Hiểu Về Cấu Trúc Ba Tầng settings.json

Claude Code sử dụng cấu hình dạng “hành tây” với 3 tầng:

Tầng	Vị trí	Phạm vi	Chia sẻ	Mục đích
Global	`~/.claude/settings.json`	Toàn bộ dự án	❌	Cài đặt mặc định chung (quyền,...)
Project	`.claude/settings.json`	Toàn dự án	✅	Quy tắc dùng chung trong dự án
Personal	`.claude/settings.local.json`	Cá nhân trong dự án	❌	Chỉnh sửa cá nhân, không đồng bộ (gitignore)

Ưu tiên: Tầng 3 > Tầng 2 > Tầng 1

Ví dụ cấu trúc settings.json:

{
  "permissions": {
    "allow": ["Read", "Write", "Edit", "Bash(npm test)", "Bash(npm run lint)"],
    "deny": ["Bash(rm -rf *)", "Bash(git push --force)"]
  },
  "env": {
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "16000"
  }
}

Mẹo: Dùng khớp chính xác hoặc wildcards trong phần allow để giảm yêu cầu phê duyệt thủ công.

6.3 Chọn Chế Độ Quyền Phù Hợp Cho Quy Trình Làm Việc

Claude Code có 6 chế độ quyền với các mức độ từ thận trọng đến hoàn toàn tự động:

Chế độ	Mô tả	Có hỏi phê duyệt?	Dùng cho
default	Tiêu chuẩn, hỏi khi ghi/thi hành	Có	Phát triển thông thường
acceptEdits	Tin tưởng Claude sửa code	Không đọc/ghi, Có Execute	Sửa code tin cậy
plan	Chỉ bàn luận, không thi hành	Không	Thảo luận kiến trúc
dontAsk	Whitelist nghiêm ngặt, từ chối khác	Không (trừ thư mục bảo vệ)	CI, môi trường hạn chế
auto	Xem xét bằng classifier rồi auto thực thi	Hiếm khi	Tự động hóa có kiểm soát
bypassPermissions	Bỏ qua hầu hết kiểm tra	Không (rất nguy hiểm)	Chỉ sandbox/container

Chuyển đổi chế độ:

claude --permission-mode default
claude --permission-mode plan
claude --enable-auto-mode --permission-mode auto
claude --dangerously-skip-permissions

Cây quyết định chọn chế độ phù hợp:

Bạn thuộc trường hợp nào?
├── Lần đầu → default
├── Phát triển hàng ngày, tin tưởng sửa đổi → acceptEdits
├── Thảo luận kiến trúc → plan
├── CI / Môi trường hạn chế → dontAsk
├── Tự động hóa có kiểm soát → auto
├── Môi trường sandbox → bypassPermissions

6.4 - 6.7 Các Tính Năng Khác (Tóm tắt)

Hooks Automation: Tự động chạy script trước/sau các hành động của Claude.
MCP Server Setup: Kết nối với công cụ và dữ liệu bên ngoài.
Model & Effort Settings: Chọn model, điều chỉnh độ sâu, tối ưu token.
Environment Variables & Advanced Settings: Khai thác các tính năng ẩn và điều chỉnh hiệu năng.