claude code需打通模型、知识库、执行权限与本地文件系统才能成为ai工作台：先验证cli安装与api连通，再挂载可信路径，接着配置写权限，然后加载skills自动化任务，最后可选集成obsidian实现双向联动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让Claude Code不只是帮你写几行代码，而是成为你电脑里真正能管文件、跑任务、记笔记、自动整理资料的专属AI工作台？你需要的不是零散插件堆砌，而是把模型、知识库、执行权限、本地文件系统四者打通——这一步做完，AI才从“聊天对象”变成“驻场同事”。
第一步：确认Claude Code已就位并连通可用API
打开终端，执行 claude-code --version。如果返回类似 v3.2.1 的版本号，说明CLI已安装；若提示命令未找到，需先运行官方安装脚本：curl -fsSL https://install.claudecode.ai | sh。
进入设置目录：cd ~/.claude-code/config，检查 providers.yaml 是否存在且含至少一个有效供应商。国内用户【必须使用CC-Switch代理后的WeLink或ClaudeAPI.com地址】，直接填 api.anthropic.com 会持续超时。
执行 claude-code test-connection。看到绿色 ✅ 和 “Connection OK” 才算真正通了——这步跳过，后面所有文件操作都会卡在权限校验环节。
第二步：挂载你的本地知识中枢
Claude Code 默认不读任何外部文件，必须显式声明信任路径。在配置目录下新建 workspace.yaml，写入：
trusted_paths: - /Users/yourname/ObsidianVault - /Users/yourname/Projects - /Users/yourname/Documents/Notes
路径必须是绝对路径，且每个目录需含至少一个 .md 或 .txt 文件，否则Claude Code启动时会静默跳过该路径。Mac/Linux用户注意用 ~ 会被忽略，必须展开为完整路径。
重启Claude Code服务：claude-code restart。此时它已能实时感知这些目录下的新增、修改、删除动作——不是“你丢给它一个文件”，而是“它自己盯着你放进去的所有东西”。
第三步：赋予文件系统操作权（关键权限）
默认情况下，Claude Code只能读取，不能创建或修改文件。要让它真正干活，必须开启写权限：
方法一：临时授权（适合调试）
在任意对话中输入：/allow-write-to /Users/yourname/ObsidianVault。授权仅对当前会话有效，关闭终端即失效。
方法二：永久授权（生产环境推荐）
编辑 ~/.claude-code/config/security.yaml，将 write_mode: 从 deny 改为 allow_trusted。【改完必须重启服务，否则不生效】
方法三：按需弹窗确认（新手安全模式）
保持 write_mode: prompt 不变，每次Claude Code尝试写文件时，终端会弹出确认提示。按 y 同意，n 拒绝——适合刚起步、想观察AI行为边界的用户。
第四步：加载Skills实现自动化流水线
第一步：在项目根目录创建 .claude/skills/ 文件夹，里面放你的技能定义文件，比如 weekly-report.md：
---name: 生成周报模板trigger: /weekly-reportdescription: 根据本周Git提交和笔记自动生成结构化周报---1. 扫描 ./Notes/2026/07/ 目录下所有 .md 文件，提取含“# 本周进展”标题的段落2. 运行 git log --since="7 days ago" --oneline，提取提交摘要3. 合并生成 Markdown 报告，保存到 ./Reports/weekly-2026-07-28.md
第二步：执行 claude-code reload-skills，终端会显示加载成功数量。此后只需说 /weekly-report，AI就会自动执行整套流程。
注意：Skills文件里的路径必须是相对当前工作目录的路径，不能用 ~ 或绝对路径——这是最容易写错导致技能静默失败的地方。
第五步：与Obsidian深度联动（可选但强烈推荐）
安装社区插件 Claudian，它会在Obsidian右侧面板嵌入Claude Code实时交互窗口。重点配置两处：
在Claudian设置中，将 Working Directory 指向你的主笔记库根目录，比如 /Users/yourname/ObsidianVault。
启用 Auto-sync with current file 开关。当你在Obsidian中打开某篇笔记时，Claude Code会自动将该文件全文注入上下文——不用再手动复制粘贴，AI立刻知道你在聊哪一页。
现在你可以直接在笔记里写：“帮我重写这段技术描述，语气更简洁，加个流程图代码块”，Claude Code会当场修改原文并保存回同一文件。
