Second Brain

Claude Code × Obsidian 快速启动手册

2 min read

Claude Code × Obsidian 快速启动手册

目标

在终端输入一个短命令，自动进入 Obsidian Vault 目录并启动 Claude Code。

前置条件

  • macOS（使用默认的 zsh）
  • 已安装 Claude Code（npm install -g @anthropic-ai/claude-code）
  • 已有 Obsidian Vault 目录
  • 终端软件（Ghostty / iTerm2 / Terminal.app 均可）

步骤一：找到你的 Vault 路径

在终端执行：

ls ~/Documents

确认你的 Vault 文件夹名称，例如 ~/Documents/MyVault。

步骤二：打开 .zshrc 文件

open ~/.zshrc

如果文件不存在，先创建它：

touch ~/.zshrc && open ~/.zshrc

步骤三：添加别名

在文件末尾添加以下内容：

# Claude Code 快速启动
alias cv="cd ~/Documents/MyVault && claude"

将 ~/Documents/MyVault 替换为你的实际 Vault 路径，保存文件。

步骤四：使配置生效

source ~/.zshrc

使用方式

打开终端（Ghostty / iTerm2 / Terminal.app），输入：

cv

即可自动进入 Vault 目录并启动 Claude Code。

扩展：多个 Vault 或项目

可以添加多个别名，分别对应不同目录：

alias cv="cd ~/Documents/MyVault && claude"       # 主 Vault
alias cv2="cd ~/Documents/WorkVault && claude"    # 工作 Vault
alias cp1="cd ~/Projects/my-app && claude"        # 某个项目

常见问题

Q：cv 命令提示 command not found？ 重新执行 source ~/.zshrc，或关闭终端重新打开。

Q：换了新终端窗口别名还在吗？ 在，.zshrc 每次开启终端都会自动加载。

Q：怎么查看当前有哪些别名？

alias

Q：怎么删除一个别名？ 从 .zshrc 里删掉对应行，再执行 source ~/.zshrc。

相关命令速查

操作命令
编辑配置文件open ~/.zshrc
使配置生效source ~/.zshrc
查看所有别名alias
查看当前目录pwd
启动 Claude Codeclaude

Graph View

Backlinks