内容工厂环境搭建
这一页用于搭建内容工厂最基础的运行环境。
最终目标不是“把软件装上”，而是让 Obsidian + Claudian + Claude Code 真正联调成功，并能在 Vault 中直接完成内容生产。
你最终要得到什么
| 模块 | 目标 | 作用 |
|---|---|---|
| Claude Code | 安装并可正常启动 | 负责内容整理、生成与执行任务 |
| cc-switch | 安装并可正常调用 | 负责管理 Claude Code 的切换与路径辅助 |
| Obsidian + Claudian | 在 Obsidian 内成功联调 | 负责把知识库和 Claude Code 真正连接起来 |
页面阅读方式
Windows
Windows 侧优先使用 winget 安装 Claude Code、cc-switch 和 Obsidian。
Claude Code 官方支持多种安装方式，包括 Native Install、Homebrew、WinGet 和 npm。这里优先选择命令行可复制、安装路径清晰、并且你已经实测过的方式。
Windows 系统环境搭建
如果你使用的是 Windows，建议按这个顺序来：
安装 Git for Windows
Claude Code 在 Windows 原生环境下，配合 Git for Windows 使用会更稳定。
在 PowerShell 中执行：
winget install --id Git.Git -e安装完成后，建议关闭并重新打开终端。
安装 Claude Code
如果你在 Windows 上，实测更顺畅的安装方式是直接使用 winget：
winget install Anthropic.ClaudeCode安装完成后先检查版本：
claude --version查找 Claude Code 路径
如果你想确认 claude 命令实际安装到了哪里，可以运行：
where.exe claude这一步适合用于：
- 确认 PATH 是否已经生效
- 确认 Claudian 里该填哪条 Claude Code 路径
- 排查
claude找不到命令的问题
启动并验证 Claude Code
进入你的项目目录后运行：
claude首次启动时，按提示完成登录。
然后执行环境检查：
claude doctor如果 claude --version、where.exe claude 和 claude doctor 都正常，说明 Claude Code 基本可用了。
安装 cc-switch
cc-switch 是 Claude Code 的辅助切换工具。它不是替代 Claude Code，而是帮助你在多个 Claude Code 相关环境、版本或可执行路径之间更方便地切换和管理。
如果你后面会：
- 同时维护多套 Claude Code 环境
- 需要切换不同安装来源或不同版本
- 想让 Obsidian / Claudian 更稳定地指向一个明确的 Claude Code 可执行路径
那么安装 cc-switch 会很有帮助。
在 PowerShell 中执行：
winget install Farion1231.cc-switch安装完成后，先检查帮助信息：
cc-switch --help安装 Obsidian
Windows 下推荐直接使用 WinGet 安装：
winget install --id Obsidian.Obsidian -e安装完成后，可以从开始菜单打开 Obsidian。
如果你的系统已经把命令加入 PATH，也可以试试：
obsidian在 Obsidian 中安装 BRAT 和 Claudian
Obsidian 装好之后，下一步不是立刻开始写笔记，而是先把用于联调 Claude Code 的插件装好。
先做这几步：
- 打开 Obsidian
- 进入
Settings -> Community plugins - 关闭 Safe mode
- 先安装 BRAT
- 再通过 BRAT 安装 Claudian
安装 BRAT
在 Obsidian 中进入：
Settings -> Community plugins -> Browse- 搜索
BRAT - 安装并启用
通过 BRAT 安装 Claudian
进入 BRAT 的配置页面，添加 Claudian 仓库：
https://github.com/YishenTu/claudian添加完成后：
- 让 BRAT 拉取这个仓库
- 安装 Claudian
- 启用 Claudian 插件
配置 Claude Code 路径
Claudian 启用之后，进入它的设置页面，把 Claude Code 的可执行路径配置进去。
先查路径：
where.exe claude如果你也想确认 cc-switch 的路径，可以执行：
where.exe cc-switch然后把 claude 的实际可执行路径填到 Claudian 的配置项中。
如果你的环境里有多条 Claude Code 路径，优先选择你当前验证过、能够正常运行 claude --version 和 claude doctor 的那一条。
完成联调测试
完成路径配置后，最后要验证的是：
- Obsidian 能调用 Claudian
- Claudian 能正确调用本机 Claude Code
- Claude Code 能读取当前 Vault 内容并返回结果
建议在 Obsidian 里做一次最小测试：
- 新建一篇测试笔记
- 随便写几段文字
- 在 Obsidian 中调用 Claudian
- 先执行下面这条实际联调指令：
在这个obsidian vault建立3个目录：
01-收件箱
02-爆款库
03-生产线- 确认 Claude Code 能通过 Claudian 正常执行这条指令
- 检查 Vault 中是否已经成功创建这 3 个目录
- 再给它一个简单任务，例如总结、润色或整理结构，确认返回结果正常
只要目录创建成功，并且后续简单任务也能正常返回结果，就说明 Obsidian 和 Claude Code 已经联调成功。
Windows 安装完成后检查什么
至少确认下面 8 件事都成立，再进入下一阶段。
claude --version能正常返回版本where.exe claude能返回 Claude Code 的安装路径claude能正常启动并登录cc-switch --help能正常返回输出- Obsidian 能正常打开
- Obsidian 可以创建一个新的 Vault 或打开已有 Vault
- BRAT 插件已经安装并启用
- Claudian 已经能在 Obsidian 内正常调用 Claude Code
Windows 最低可运行标准
- 你可以在 Obsidian 里新建和编辑 Markdown 笔记
- 你可以在终端里启动 Claude Code
- 你可以正常调用
cc-switch - 你可以在 Obsidian 里通过 Claudian 调用 Claude Code
- 你可以让 Claude Code 进入你的项目目录工作
- 你已经具备继续搭建内容工厂的基础条件
mac 系统环境搭建
如果你使用的是 mac，建议按这个顺序来：
安装 Homebrew
如果系统里还没有 Homebrew，先安装：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装完成后，检查是否成功：
brew --version安装 Claude Code
现在直接用 Homebrew 安装 Claude Code：
brew install --cask claude-code安装完成后，检查版本：
claude --version启动并验证 Claude Code
进入你的项目目录后运行：
claude首次启动时，按提示完成登录。
然后执行环境检查：
claude doctor如果 claude --version 和 claude doctor 都能正常执行，说明 Claude Code 已基本安装完成。
安装 cc-switch
cc-switch 是 Claude Code 的辅助切换工具。它不是替代 Claude Code，而是帮助你在多个 Claude Code 相关环境、版本或可执行路径之间更方便地切换和管理。
在终端中执行：
brew install --cask farion1231/ccswitch/cc-switch安装完成后，先检查帮助信息：
cc-switch --help安装 Obsidian
mac 下推荐继续使用 Homebrew 安装：
brew install --cask obsidian安装完成后，你可以直接运行：
open -a Obsidian在 Obsidian 中安装 BRAT 和 Claudian
Obsidian 装好之后，下一步是安装用于联调 Claude Code 的插件。
先做这几步：
- 打开 Obsidian
- 进入
Settings -> Community plugins - 关闭 Safe mode
- 先安装 BRAT
- 再通过 BRAT 安装 Claudian
安装 BRAT
在 Obsidian 中进入：
Settings -> Community plugins -> Browse- 搜索
BRAT - 安装并启用
通过 BRAT 安装 Claudian
进入 BRAT 的配置页面，添加 Claudian 仓库：
https://github.com/YishenTu/claudian添加完成后：
- 让 BRAT 拉取这个仓库
- 安装 Claudian
- 启用 Claudian 插件
配置 Claude Code 路径
Claudian 启用之后，进入它的设置页面，把 Claude Code 的可执行路径配置进去。
先查路径：
which claude如果你也想确认 cc-switch 的路径，可以执行：
which cc-switch然后把 claude 的实际可执行路径填到 Claudian 的配置项中。
如果你的环境里有多条 Claude Code 路径，优先选择你当前验证过、能够正常运行 claude --version 和 claude doctor 的那一条。
完成联调测试
完成路径配置后，最后要验证的是：
- Obsidian 能调用 Claudian
- Claudian 能正确调用本机 Claude Code
- Claude Code 能读取当前 Vault 内容并返回结果
建议在 Obsidian 里做一次最小测试：
- 新建一篇测试笔记
- 随便写几段文字
- 在 Obsidian 中调用 Claudian
- 先执行下面这条实际联调指令：
在这个obsidian vault建立3个目录：
01-收件箱
02-爆款库
03-生产线- 确认 Claude Code 能通过 Claudian 正常执行这条指令
- 检查 Vault 中是否已经成功创建这 3 个目录
- 再给它一个简单任务，例如总结、润色或整理结构，确认返回结果正常
只要目录创建成功，并且后续简单任务也能正常返回结果，就说明 Obsidian 和 Claude Code 已经联调成功。
mac 安装完成后检查什么
至少确认下面 7 件事都成立，再进入下一阶段。
claude --version能正常返回版本claude能正常启动并登录cc-switch --help能正常返回输出- Obsidian 能正常打开
- Obsidian 可以创建一个新的 Vault 或打开已有 Vault
- BRAT 插件已经安装并启用
- Claudian 已经能在 Obsidian 内正常调用 Claude Code
mac 最低可运行标准
- 你可以在 Obsidian 中记录和管理内容素材
- 你可以在终端中启动 Claude Code
- 你可以正常调用
cc-switch - 你可以在 Obsidian 里通过 Claudian 调用 Claude Code
- 你可以让 Claude Code 读取和整理本地项目内容
- 你已经具备继续搭建内容工厂的基础条件
安装完成后，建议立即做的 3 件事
在 Obsidian 中创建一个内容素材库
建议先建立一个专门的 Vault，用来放：
- 灵感
- 研究记录
- 项目复盘
- 待写提纲
- 已发布文章的原始素材
你不需要一开始就设计复杂结构，先保证能稳定记录。
为 Claude Code 准备一个固定工作目录
如果你在 mac 或 Git Bash 中操作，可以执行：
mkdir -p ~/content-factory
cd ~/content-factory如果你在 Windows PowerShell 中操作，可以执行：
New-Item -ItemType Directory -Force "$HOME\content-factory"
Set-Location "$HOME\content-factory"进入目录后，启动 Claude Code：
claude再做一次最小闭环测试
建议按下面这个流程测试一次：
- 在 Obsidian 里新建一篇笔记
- 写入几段简单内容
- 在 Obsidian 中通过 Claudian 调用 Claude Code
- 让它帮你总结、润色或整理结构
- 确认它能正常返回结果
如果你还想再做一次终端侧验证，也可以额外进入项目目录后直接运行：
claude只要 Obsidian 内调用正常、终端内调用也正常，就说明这套内容工厂基础环境已经真正搭好了。
常用更新命令
Windows
winget upgrade Anthropic.ClaudeCode
winget upgrade Farion1231.cc-switch
winget upgrade Obsidian.Obsidian常见问题
为什么 Windows 下这里推荐 winget install Anthropic.ClaudeCode？
因为这条命令在 Windows 环境下更直接，实测安装体验更顺，而且安装后可以马上用 where.exe claude 检查命令路径，方便排查 PATH 问题。
运行 claude 提示找不到命令怎么办？
先执行：
claude --version如果仍然提示找不到命令，优先检查：
- 终端是否已经重开
- Homebrew 是否安装成功
- 安装步骤是否完整执行
- 在 Windows 下是否可以通过
where.exe claude找到实际路径
运行 cc-switch 提示找不到命令怎么办？
先执行：
cc-switch --help如果仍然提示找不到命令，优先检查：
- 安装命令是否已经执行成功
- 终端是否已经重开
- 在 Windows 下是否需要重新打开 PowerShell 让 PATH 生效
- 在 mac 下是否需要重新加载 shell 配置
Obsidian 安装完后第一步应该做什么？
不是先装插件，而是先创建一个可持续使用的 Vault，然后开始记录内容。
先跑通“记录 → 整理 → 输出”的最小流程，比一开始就折腾复杂插件更重要。