项目信任(Project trust)
在 加载设置之前先认可这个文件夹。用图和例子讲清它是什么、怎么运作、怎么用，以及要注意什么。
它是什么
项目信任是你第一次在某个文件夹里以交互会话启动 时做的检查。可以带自己的 .claude/settings.json，其中有些条目会给出额外权力，比如 permissions.allow 规则和 additionalDirectories。信任对话框会列出这些条目让你先看，在你接受之前 Claude Code 不会用它们。deny 和 ask 规则照样生效，因为它们只做限制。在 仓库里，你的回答会按仓库根保存，但在你的主文件夹里只在当前会话有效。
它怎么工作
-
在新文件夹里启动 claude
-
阅读对话框列出的内容
-
信任它才接受
-
回答按仓库保存
怎么使用
-
~/.claude.json保存每个项目的状态，包括你的信任回答。键是
hasTrustDialogAccepted。 -
claude -p从不显示对话框。项目的允许规则不会被用，
this workspace has not been trusted警告会输出到 stderr，但钩子和.mcp.json的仍会运行。 -
--setting-sources user在不是你写的仓库里运行
claude -p之前加上它，Claude Code 会跳过项目的设置文件和.mcp.json。 -
.claude/settings.local.json你自己的、不被 git 跟踪的文件。它的允许规则不经过信任步骤就生效，除非 git 跟踪了这个文件。
注意
信任并不能挡住所有东西。仓库设置里的钩子和 env 块，即使你只信任了上层文件夹或运行的是 claude -p，也会被使用。请从项目文件夹启动 Claude Code，而不是从主文件夹，因为主文件夹的信任从不保存，每次启动对话框都会再出现。
相关术语
原文和官方文档
本页用简单的话解释这个术语。以原文为准：如果两者不同，请按原文。
- 在原文中查看这个术语Claude Code Docs — Glossary Anthropic · 确认于 2026-10-19
- Anthropic — Claude Code docs: Configure permissions — Project allow rules and workspace trust(在新窗口中打开)
- Anthropic — Claude Code docs: Configure permissions — What runs before you trust a folder(在新窗口中打开)
- Anthropic — Claude Code docs: Security — Additional safeguards(在新窗口中打开)
- Anthropic — Claude Code docs: Explore the .claude directory(在新窗口中打开)
加载中…
请选择要取消的待付款预约。每次取消都需要确认。
你所在国家的时间: