区别于CLAUDE.md？

🎯 定位

⚙️ 二️⃣ 三大配置“楼层”

📌 三️⃣ 优先权表 & 特殊规则

优先顺序

text user_level → project_level → local_level

数组处理细节

• 默认情况下当上一级已定义数组时下一级 定义相同键会进行深度拼接，而非简单覆寫。说到例如，json // User Level { "permissions": { "deny": } }

// Project Level 添加更多拒绝命令： { "permissions": { "deny": } } 从结果为来看。json { "permissions":{ "deny": } } `` * 若需完全覆寫数组，只需显式添加"overwrite":true"` 或删除旧值后重新赋值。

📋 四️⃣ 常见关键配置项解析

model

指明要使用哪种 AI 模型，例如 "Sonnet" 或 "Opus"。

放在哪儿？

• 使用者級 → 设置全局默认模型；
• 项目級 → 对单个仓库存储专属首选模型；
• 本地級 → 快速切换实验性模型。

permissions

控制哪些命令或操作被禁止。例如 "deny":.

放在哪儿？

• 使用者級 → 防止所有人误删关键文件；
• 项目級 → 针对敏感脚本禁用危险操作；
• 本地級 → 实验性安全策略。

env

自定义环境变量供脚本或 Hook 使用。

放在哪儿？

• 使用者級 → 全域共享如 API_KEY；
• 项目級 → 仓库专属变量，如 CI_TOKEN。

hooks

钩子函数，在特定事件触发执行脚本。

放在哪儿？

• 使用者_LEVEL 可用于统一日志记录；
• 项目_LEVEL 可绑定代码提交校验脚本；
• 本地_LEVEL 用于个人快速实验。

statusLine

终端状态栏展示信息，例如当前 Git 分支。

放在哪儿？

推荐使用者_LEVEL 或 Project-Level，以便随意查看。

🏗️ 五️⃣ 实战演练 — 从编写到验证

步骤 A – 创建基础全局设定

保存至 $HOME/.cliud/setttings_json

json { "model":"Sonnet","env":{ "API_KEY":"xxxxxxxxxxxxxxxxxxxx" },"statusLine":"$branch","permissions":{ "_overwrite_deny":true,"deny": } }

步骤 B – 为单个 Repo 增加 Hooks 与特殊 Model

json { "hooks":{ "afterSave":"npm run lint" },"_overwrite_model":true。"model":"Opus" }

**

步骤 C – 验证 ✅

打开终端进入 ${REPO_ROOT}，输入：

bash $ claudeshell /status --verbose

至于期望输出示例，

✓ 当前模式 : Opus ← 来自 Project-Level 的 model 覆盖效果显现 ✓ 环境变量 : API_KEY=*xxxxxx ✓ 状态栏 : ${branch} ✓ 权限 : rm -rf 禁止 ✔︎ ← User-Level 权限已成功继承并融合 ✓ Hooks : afterSave 已绑定 npm run lint

若看到以上信息，即表示各阶梯都按预期工作！

🚀 小结 & 再提醒

1️⃣ 明确角色定位 – CLAUDE.md 为约定描述；说起来，settings_json 为行为控制器。2️⃣ 按需选择楼层 – 想做全域变更就落到 User-Level，否则落到对应 Project-Level 或 Local-Level。3️⃣ 注意数组合并细节 – 若需覆寫，请显式标记 _overwrite_*. 4️⃣ 验证必不可少 – 每次修改后务必跑 /status --verbose 检查是否真正生效。

掌握这套程序。你将在接下来配置时“一眼看清”，不会再因 “写错楼层” 而苦恼！祝编码愉快 🚀