Bỏ qua tới nội dung
Ông T.vn

settings.json trong Claude Code: chỉnh ở đâu, chỉnh gì, file nào thắng file nào

14 phút đọcCập nhật
settings.json trong Claude Code: chỉnh ở đâu, chỉnh gì, file nào thắng file nào

Tóm tắt nhanh

Claude Code đọc cấu hình từ ba file settings.json theo ba phạm vi: người dùng (mọi dự án), dự án (chia sẻ cho nhóm) và local (riêng bạn trong dự án). Khi cùng một khoá bị đặt ở nhiều nơi, local thắng dự án, dự án thắng người dùng. Bài này chỉ bạn chọn đúng file, chỉnh những thứ đáng chỉnh như model, permissions, biến môi trường, và tránh chỉnh nhầm phạm vi.

Claude Code có ba file settings.json, mỗi file áp dụng cho một phạm vi khác nhau: file người dùng cho mọi dự án, file dự án cho cả nhóm, file local cho riêng bạn trong một dự án. Khi cùng một thiết lập xuất hiện ở nhiều nơi, file hẹp hơn thắng: local thắng dự án, dự án thắng người dùng.

Vì sao chuyện này đáng quan tâm? Vì lỗi phổ biến nhất không phải là gõ sai khoá, mà là chỉnh nhầm phạm vi. Bạn muốn đổi model cho một dự án nhỏ, nhưng lại sửa file người dùng, thế là mọi dự án khác đổi theo. Hoặc bạn lưu một thiết lập cá nhân vào file dự án rồi commit, và cả nhóm bỗng chạy theo ý bạn.

Bài này giúp bạn phân biệt ba phạm vi, biết những thứ đáng chỉnh, và có sẵn ba tình huống làm thật. Xem video ngắn bên dưới để nắm ý chính, rồi đọc tiếp để hiểu sâu hơn: vì sao thứ tự ưu tiên chạy như vậy và đâu là giới hạn của nó.

settings.json: chỉnh Claude Code ở đâu và chỉnh gìXem trên YouTubeXem trên Facebook

I.Bản chất: ba file, ba phạm vi

Hãy nghĩ settings.json như ba lớp áo. Lớp trong cùng là thói quen chung của bạn. Lớp giữa là luật chơi của dự án. Lớp ngoài cùng là sở thích riêng của bạn trong dự án đó. Claude Code đọc cả ba, rồi gộp lại.

A.Cấp người dùng: áp dụng mọi dự án

File này nằm trong thư mục .claude ở thư mục người dùng của bạn, tức ~/.claude/settings.json. Dấu ~ (dấu ngã) là cách viết tắt của thư mục người dùng. Trên Windows nó là thư mục kiểu C:\Users\TenBan.

Đặt gì ở đây? Những thứ bạn muốn ở mọi nơi: model ưa thích, vài quy tắc an toàn chung, biến môi trường dùng khắp máy. File này chỉ nằm trên máy bạn, không đi cùng dự án.

B.Cấp dự án: chia sẻ cho nhóm

File này là .claude/settings.json nằm trong thư mục dự án. Vì nó nằm trong dự án, bạn có thể commit lên kho mã và cả nhóm cùng dùng chung.

Đặt gì ở đây? Luật chơi của dự án: model thống nhất cho cả nhóm, những lệnh được phép chạy sẵn (ví dụ lệnh build, lệnh kiểm tra), những file cấm đọc. Người mới vào nhóm clone dự án về là có ngay cấu hình đúng.

C.Cấp cá nhân trong dự án: settings.local.json

File thứ ba là .claude/settings.local.json, cũng nằm trong thư mục ẩn .claude của dự án nhưng dành riêng cho bạn. Theo video, Claude Code tự thêm file này vào gitignore, nên bạn khó commit nhầm. Dù vậy, nếu thấy lạ, hãy tự mở file .gitignore kiểm tra một lần.

Đặt gì ở đây? Những thứ chỉ đúng với bạn, trong dự án này: một lệnh bạn tự cho phép chạy, một biến môi trường trỏ tới thư mục trên máy bạn, một thử nghiệm bạn chưa muốn áp cho cả nhóm.

D.Ai thắng khi hai file đặt cùng một khoá

Quy tắc ngắn gọn: local thắng dự án, dự án thắng người dùng. Ví dụ file người dùng đặt một model, file dự án đặt model khác, thì trong dự án đó model của dự án được dùng. Nếu bạn lại đặt thêm một model trong file local, model local được dùng.

Lý do thiết kế như vậy khá hợp lý: phạm vi càng hẹp thì càng gần với việc bạn đang làm, nên được ưu tiên. Nó giống nội quy: quy định chung của công ty có thể bị phòng ban điều chỉnh, và phòng ban có thể cho phép riêng một nhân viên trong một số việc.

Lưu ý quan trọng: quy tắc "hẹp thắng" nói về cùng một khoá đơn lẻ như model. Với danh sách như các quy tắc trong permissions, bạn không nên giả định file hẹp "xoá" danh sách của file rộng. Nhiều khả năng chúng được gộp lại, và quy tắc chặn vẫn có sức nặng. Mình khuyên bạn đừng đoán: sau khi sửa, hãy mở lại Claude Code và kiểm tra bằng lệnh /permissions xem danh sách thực tế đang hiện ra là gì.

Ngoài ba file này, ở môi trường doanh nghiệp còn có cấu hình do quản trị viên đặt, thường có quyền cao hơn. Nếu máy bạn là máy công ty và có thiết lập bạn không sửa được, nhiều khả năng đó là lý do.

II.Làm thế nào: chọn file rồi chỉnh

  1. Hỏi phạm viĐổi này áp cho mọi dự án, cả nhóm, hay riêng mình trong dự án này?
  2. Chọn đúng file~/.claude/settings.json, .claude/settings.json hoặc .claude/settings.local.json
  3. Sửa JSONThêm đúng khoá, giữ JSON hợp lệ (dấu phẩy, ngoặc)
  4. Kiểm traMở lại Claude Code, xem bằng /config hoặc /permissions
  5. Commit đúng fileFile dự án thì commit; file local thì không

A.Bước 1 và 2: một câu hỏi quyết định file

Trước khi mở file nào, hãy tự hỏi: "Nếu mình đổi cái này, ai bị ảnh hưởng?"

  • Chỉ mình bạn, ở mọi dự án: file người dùng.
  • Cả nhóm, trong dự án này: file dự án.
  • Chỉ mình bạn, trong dự án này: file local.

Nếu bạn phân vân giữa dự án và local, hãy chọn local trước. Thử xong thấy hay, chuyển sang file dự án sau. Chiều ngược lại (đã commit rồi mới rút) phiền hơn nhiều.

B.Bước 3: sửa JSON cho đúng

Settings là file JSON, nên một dấu phẩy thừa hoặc thiếu có thể làm cả file không đọc được. Hãy sửa từng khoá một và kiểm tra lại. Một khung tối thiểu trông như sau:

JSON
{
  "model": "tên-model-bạn-chọn",
  "permissions": {
    "deny": ["Read(./.env)"]
  }
}

Bạn thay tên-model-bạn-chọn bằng tên model đúng như Claude Code đang hỗ trợ. Mình không ghi tên cụ thể vì danh sách model đổi liên tục; hãy xem tên hợp lệ trong chính Claude Code (lệnh /model hoặc /config) rồi chép vào.

C.Bước 4: kiểm tra, đừng tin trí nhớ

Sau khi lưu, mở lại Claude Code trong thư mục dự án bằng lệnh claude. Rồi kiểm tra: lệnh /config để xem thiết lập chung, /permissions để xem các quy tắc cho phép và chặn. Nếu thiết lập không có hiệu lực, nguyên nhân thường gặp là sai tên file, sai thư mục, hoặc JSON hỏng.

D.Những thứ đáng chỉnh

Không cần nhớ cả trăm khoá. Với người mới, bốn nhóm này là đủ dùng:

  • Modelchọn model mặc định. Đặt ở file dự án nếu cả nhóm cần thống nhất, ở file người dùng nếu đó là sở thích riêng.
  • Permissionscác quy tắc cho phép, hỏi, hoặc chặn một công cụ hay một lệnh. Phần này mình đã nói kỹ ở tập về permissions trong cùng series, nên ở đây chỉ nhắc lại vị trí đặt chúng.
  • Biến môi trường (env)những biến mà Claude Code truyền vào các lệnh nó chạy. Cẩn thận: đừng ghi khoá bí mật vào file dự án rồi commit.
  • Hookslệnh tự chạy khi có sự kiện, ví dụ sau khi Claude sửa file. Đây là phần nâng cao hơn, chỉ nên thêm khi bạn đã quen với ba phần trên.

Nếu bạn không chắc một khoá có tồn tại hay không, đừng đoán. Hỏi chính Claude Code, hoặc đọc tài liệu chính thức. Một khoá viết sai thường bị bỏ qua lặng lẽ, và bạn tưởng mình đã cấu hình xong trong khi thực tế chẳng có gì xảy ra.

III.Dùng vào việc thật

A.Dev trong nhóm: thống nhất cấu hình dự án

Bối cảnh: bạn là lập trình viên trong nhóm ba người. Mỗi người đang dùng một cấu hình khác nhau, nên cùng một yêu cầu mà Claude làm ra kết quả hơi khác nhau, và người mới hay bị hỏi quyền liên tục.

Câu giao việc:

text
Trong thư mục dự án này, hãy tạo file .claude/settings.json dùng chung cho cả nhóm.
Yêu cầu:
1. Cho phép sẵn các lệnh chỉ đọc và lệnh kiểm tra mà dự án hay dùng (hãy đọc file package.json để biết lệnh nào có thật).
2. Chặn công cụ Read đọc file .env.
3. Không đặt bất kỳ khoá bí mật nào vào file.
Trước khi ghi file, hãy cho mình xem nội dung dự kiến và giải thích từng dòng.

Kết quả: một file JSON ngắn, dễ review. Cả nhóm commit chung, người mới clone về là có cấu hình đúng.

Chỗ cần kiểm tra lại: đọc kỹ danh sách lệnh được cho phép. Một lệnh nghe vô hại nhưng có thể ghi đè dữ liệu. Nếu thấy lệnh nào bạn không hiểu, bỏ nó ra khỏi danh sách cho phép.

B.Chủ shop làm website nhỏ: chặn file bí mật

Bối cảnh: bạn bán hàng online và đang nhờ Claude Code sửa website của shop. Thư mục dự án có file .env chứa khoá kết nối cổng thanh toán và cơ sở dữ liệu. Bạn không muốn Claude đọc nội dung file này.

Câu giao việc:

text
Mình muốn Claude Code không dùng công cụ Read để đọc file .env trong dự án này.
Hãy thêm quy tắc deny phù hợp vào permissions trong .claude/settings.json.
Nếu file đã tồn tại, hãy giữ nguyên các thiết lập cũ và chỉ thêm quy tắc mới.
Sau khi xong, nhắc mình mở lại Claude Code và kiểm tra bằng /permissions.

Kết quả: trong file có một quy tắc dạng Read(./.env) nằm trong danh sách deny.

Chỗ cần kiểm tra lại, và đây là điểm rất quan trọng: quy tắc này chặn công cụ Read, nó không đảm bảo chặn mọi cách truy cập file. Nếu Claude được phép chạy lệnh trong terminal, về lý thuyết vẫn có đường khác để đọc nội dung file. Vì vậy hãy xem đây là một lớp bảo vệ, không phải bức tường tuyệt đối. An toàn nhất là không để khoá thật trong thư mục làm việc khi không cần.

Quy tắc deny cho công cụ Read không đảm bảo chặn mọi cách truy cập file. Đừng coi nó là cơ chế bảo mật duy nhất cho dữ liệu nhạy cảm. Hạn chế luôn cả quyền chạy lệnh và quyền ra mạng nếu dữ liệu đó quan trọng.

C.Nhân viên văn phòng dùng thử: thiết lập riêng, không ảnh hưởng nhóm

Bối cảnh: bạn làm trong dự án chung của phòng, nhưng bạn muốn thử một model khác với quy định của dự án, chỉ để so sánh trên máy mình. Bạn không muốn đụng vào file mà cả phòng đang dùng.

Câu giao việc:

text
Mình muốn thử một thiết lập riêng chỉ cho mình trong dự án này.
Hãy tạo hoặc cập nhật file .claude/settings.local.json (không sửa .claude/settings.json).
Trước tiên hãy kiểm tra file .gitignore xem file local đã được bỏ qua chưa, và báo lại cho mình.
Sau đó cho mình xem nội dung định ghi trước khi lưu.

Kết quả: thiết lập chỉ có hiệu lực trên máy bạn. Vì local thắng dự án, model bạn chọn sẽ được dùng thay cho model của dự án.

Chỗ cần kiểm tra lại: sau khi thử xong, nhớ xoá dòng thử nghiệm đi. Nếu để quên, vài tuần sau bạn sẽ thắc mắc vì sao Claude trên máy mình cư xử khác đồng nghiệp, và lúc đó rất khó nhớ nguyên nhân.

IV.Góc nhìn khách quan

A.Điểm mạnh thật sự

Hệ thống ba phạm vi giải quyết đúng một bài toán khó: vừa muốn thống nhất cho cả nhóm, vừa muốn có chỗ riêng cho từng người. Bạn không phải chọn một trong hai.

File dự án nằm trong kho mã nên có lịch sử thay đổi. Ai đổi gì, khi nào, đều xem lại được. Với cấu hình quan trọng như quyền chạy lệnh, việc này rất đáng giá. File local giúp bạn thử nghiệm mà không làm phiền ai.

Cấu hình tốt là cấu hình nằm đúng chỗ: chung thì cho nhóm, riêng thì giữ lại cho mình.

Ông T

B.Giới hạn và rủi ro

Thứ nhất, thứ tự ưu tiên dễ gây nhầm. Khi Claude Code cư xử lạ, bạn phải kiểm tra tới ba file, chưa kể cấu hình do quản trị viên đặt. Hãy tập thói quen: gặp hành vi lạ thì mở cả ba file xem.

Thứ hai, JSON khó tính. Chỉ một dấu phẩy sai có thể khiến cả file không đọc được. Hãy sửa từng bước nhỏ.

Thứ ba, rủi ro bảo mật. File dự án được commit, nên tuyệt đối không ghi khoá bí mật vào đó. Đồng thời quy tắc chặn chỉ có tác dụng trong phạm vi nó mô tả, như đã nói ở phần trên về công cụ Read.

Thứ tư, cấu hình không thay thế được sự cẩn thận. Cho phép sẵn một lệnh nghĩa là Claude chạy lệnh đó mà không hỏi bạn. Cho phép càng rộng, rủi ro sai sót càng lớn, nhất là khi Claude có quyền ghi file hoặc chạy lệnh. Việc dùng Claude Code cũng tiêu tốn lượt dùng của gói bạn đang có, và một cấu hình khiến Claude chạy lan man sẽ tốn thêm.

C.Khi nào nên chọn cách khác

Nếu điều bạn muốn chỉ là hướng dẫn cách làm việc (quy ước đặt tên, cách trình bày, nên chạy lệnh nào để kiểm tra), thì file CLAUDE.md phù hợp hơn settings.json. Settings là để chỉnh hành vi và quyền của công cụ, còn CLAUDE.md là để chỉnh hiểu biết của Claude về dự án.

Nếu bạn chỉ đổi một thiết lập trong một phiên làm việc, hãy dùng lệnh trong chính Claude Code như /config hay /model thay vì mở file. Nhanh hơn và ít nguy cơ gõ sai JSON.

Các công cụ khác như Codex CLI, Gemini CLI, Cursor hay GitHub Copilot cũng có cách cấu hình riêng của chúng. Nếu bạn dùng nhiều công cụ, đừng áp thói quen của công cụ này sang công cụ khác. Hãy đọc tài liệu của từng công cụ.

V.Lỗi hay gặp và cách tránh

A.Sửa file người dùng khi chỉ định đổi cho một dự án

Đây chính là cảnh mở đầu của video: sửa một file, mọi dự án đổi theo. Cách tránh: luôn hỏi "ai bị ảnh hưởng?" trước khi mở file. Nếu không chắc, thử ở file local của dự án trước.

B.Commit nhầm thiết lập cá nhân vào file dự án

Bạn đặt một đường dẫn trên máy riêng hoặc một thử nghiệm vào .claude/settings.json, rồi commit. Cả nhóm nhận về thứ không dành cho họ. Cách tránh: thiết lập riêng đặt ở settings.local.json, và xem lại nội dung commit (git diff) trước khi lưu.

C.Sửa mà không thấy hiệu lực

Nguyên nhân hay gặp: một file ở phạm vi hẹp hơn đang ghi đè khoá đó, hoặc bạn sửa sai thư mục, hoặc JSON hỏng. Cách xử lý: kiểm tra từ file hẹp nhất (local) ra file rộng nhất (người dùng), rồi mở lại Claude Code.

D.Coi quy tắc deny là rào chắn tuyệt đối

Chặn công cụ Read không đồng nghĩa mọi đường đọc file bị chặn. Cách tránh: thêm các lớp bảo vệ khác, không để khoá thật trong thư mục làm việc, và giới hạn quyền chạy lệnh khi dữ liệu nhạy cảm.

E.Chép cấu hình từ mạng mà không hiểu

Bạn dán nguyên một file cấu hình mẫu, trong đó có quy tắc cho phép những lệnh rộng hơn nhu cầu. Cách tránh: đọc từng dòng, dòng nào không hiểu thì bỏ, hoặc nhờ Claude giải thích rồi mới lưu.

VI.Dự phóng: cấu hình sẽ đi về đâu

Đây là nhận định của Ông T dựa trên hướng đi chung của các AI agent và công cụ lập trình bằng AI, không phải thông báo chính thức của Anthropic.

Cấu hình sẽ được kiểm soát chặt hơn theo phạm vi, mức chắc chắn: khả năng cao. Khi agent có quyền làm nhiều việc hơn, các công cụ thường có xu hướng chia quyền rõ ràng hơn giữa cá nhân, nhóm và tổ chức. Bạn nên chuẩn bị bằng cách tập thói quen chia thiết lập đúng chỗ ngay từ bây giờ.

Quyền hạn sẽ chi tiết hơn, mức chắc chắn: khả năng cao. Chỉ "cho phép hay chặn" là chưa đủ khi agent chạy lệnh và truy cập mạng. Nhiều khả năng sẽ có thêm cách giới hạn theo thư mục, theo lệnh, theo đích đến. Bạn nên chuẩn bị bằng cách ghi lại lý do cho mỗi quy tắc, để sau này dễ rà soát.

Cấu hình dùng chung sẽ thành thói quen của nhóm, mức chắc chắn: có thể. Khi nhiều người cùng dùng một agent, file cấu hình trong kho mã giống như một dạng nội quy. Nó sẽ được review như code. Hãy tập đưa thay đổi cấu hình qua quy trình review của nhóm.

Cấu hình bằng giao diện hoặc bằng câu nói thay cho sửa file, mức chắc chắn: còn bỏ ngỏ. Có thể người dùng sẽ ít phải mở JSON hơn. Nhưng dù cách nhập thay đổi ra sao, bạn vẫn cần hiểu ba phạm vi để biết thay đổi đang áp cho ai.

VII.Bắt đầu từ đâu

Bạn không cần nhớ hết mọi khoá. Chỉ cần nhớ ba câu: người dùng cho mọi dự án, dự án cho cả nhóm, local cho riêng mình. Chọn đúng file là đã tránh được phần lớn rắc rối.

Ba việc bạn làm được ngay hôm nay:

  1. Mở thư mục .claude của dự án, xem hiện có những file settings nào và mỗi file đang chứa gì.
  2. Kiểm tra .gitignore xem settings.local.json đã được bỏ qua chưa, và không có khoá bí mật nào trong file dự án.
  3. Thêm một quy tắc deny cho file .env (nếu dự án có), mở lại Claude Code, rồi kiểm tra bằng /permissions.
4.1/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

settings.json của Claude Code nằm ở đâu?

Có ba nơi: file người dùng ở thư mục .claude trong thư mục người dùng (~/.claude/settings.json), file dự án ở .claude/settings.json trong thư mục dự án, và file cá nhân trong dự án là .claude/settings.local.json. Mỗi file áp dụng cho một phạm vi khác nhau.

Nếu cùng một thiết lập có ở nhiều file thì file nào thắng?

Với một khoá đơn lẻ như model, file hẹp hơn thắng: local thắng dự án, dự án thắng người dùng. Với danh sách quy tắc như permissions, bạn không nên đoán cách chúng gộp. Hãy mở lại Claude Code và kiểm tra bằng /permissions.

settings.local.json có bị commit lên git không?

Theo video, Claude Code tự thêm file này vào gitignore để tránh commit nhầm. Tuy vậy bạn vẫn nên tự mở .gitignore kiểm tra một lần, nhất là nếu dự án có cấu hình git đặc biệt.

Chặn đọc file .env bằng permissions.deny có an toàn tuyệt đối không?

Không. Quy tắc deny cho công cụ Read chỉ chặn công cụ đó, không đảm bảo chặn mọi cách truy cập file. Nếu Claude còn quyền chạy lệnh trong terminal, vẫn có thể có đường khác. Hãy dùng thêm các lớp bảo vệ khác và không để khoá thật ở nơi không cần thiết.

Tôi sửa settings.json mà không thấy thay đổi, phải làm sao?

Kiểm tra theo thứ tự: JSON có hợp lệ không, bạn có sửa đúng file và đúng thư mục không, và có file hẹp hơn (như local) đang ghi đè khoá đó không. Sau đó mở lại Claude Code rồi xem lại bằng /config hoặc /permissions.

Nên đặt model ở file nào?

Nếu cả nhóm cần dùng chung một model thì đặt ở file dự án. Nếu là sở thích riêng ở mọi nơi thì đặt ở file người dùng. Nếu chỉ muốn thử riêng trong một dự án thì đặt ở file local.

Khác biệt giữa settings.json và CLAUDE.md là gì?

settings.json chỉnh hành vi và quyền của công cụ, như model, permissions, biến môi trường. CLAUDE.md là hướng dẫn bằng chữ để Claude hiểu dự án và cách làm việc. Hai thứ bổ trợ nhau, không thay thế nhau.

Chuyển nhanh tới mục

  1. I.Bản chất: ba file, ba phạm vi
    1. A.Cấp người dùng: áp dụng mọi dự án
    2. B.Cấp dự án: chia sẻ cho nhóm
    3. C.Cấp cá nhân trong dự án: settings.local.json
    4. D.Ai thắng khi hai file đặt cùng một khoá
  2. II.Làm thế nào: chọn file rồi chỉnh
    1. A.Bước 1 và 2: một câu hỏi quyết định file
    2. B.Bước 3: sửa JSON cho đúng
    3. C.Bước 4: kiểm tra, đừng tin trí nhớ
    4. D.Những thứ đáng chỉnh
  3. III.Dùng vào việc thật
    1. A.Dev trong nhóm: thống nhất cấu hình dự án
    2. B.Chủ shop làm website nhỏ: chặn file bí mật
    3. C.Nhân viên văn phòng dùng thử: thiết lập riêng, không ảnh hưởng nhóm
  4. IV.Góc nhìn khách quan
    1. A.Điểm mạnh thật sự
    2. B.Giới hạn và rủi ro
    3. C.Khi nào nên chọn cách khác
  5. V.Lỗi hay gặp và cách tránh
    1. A.Sửa file người dùng khi chỉ định đổi cho một dự án
    2. B.Commit nhầm thiết lập cá nhân vào file dự án
    3. C.Sửa mà không thấy hiệu lực
    4. D.Coi quy tắc deny là rào chắn tuyệt đối
    5. E.Chép cấu hình từ mạng mà không hiểu
  6. VI.Dự phóng: cấu hình sẽ đi về đâu
  7. VII.Bắt đầu từ đâu

Claude Code · 01/07/2026 · 12 phút đọc

Claude tạo design, slide và tài liệu ngay trong chat: cách dùng và giới hạn cần biết

Claude giờ cho bạn yêu cầu một bản thiết kế, một bộ slide hoặc một tài liệu ngay trong bất kỳ cuộc trò chuyện nào, kể cả trong Claude Code và tab Artifacts. Bạn sửa kết quả cùng Claude hoặc tự tay sửa trực tiếp. Tính năng gồm ba phần: Claude Design, Claude Slides và Claude Docs. Theo trang ghi thay đổi chính thức, Artifacts có trên mọi gói, kể cả Free; riêng gói Enterprise đang ở bản beta và mặc định tắt cho đến khi owner bật.