一个让 AI 在 shell 目录中不迷路的办法

[sean]

让 Claude Code 的 Shell 环境更智能

发现

今天调试时发现 Claude Code 的 "Bash" 工具实际上是使用系统的默认 shell！在我的 macOS 上，默认 shell 是 zsh，所以 Claude Code 运行的也是 zsh。

通过调查发现：

• Claude Code 使用你系统的默认 shell（通过 $SHELL 环境变量）
• 每次执行命令都是独立的非交互式 shell 进程
• Claude Code 会创建 shell 快照保存在 ~/.claude/shell-snapshots/
• 设置了环境变量 CLAUDECODE=1 来标识 Claude Code 环境

问题

Claude Code 运行的是非交互式 shell，这意味着：

• 不会自动加载 .zshrc（只在交互式 shell 中加载）
• 会加载 .zshenv（无论交互式还是非交互式都会加载）

解决方案

把 Claude Code 的配置放在 .zshenv 中：

# 编辑你的 ~/.zshenv，添加以下内容

# Claude Code Shell Enhancement (always loaded)
if [[ -n "$CLAUDECODE" ]]; then
    # 为 Claude Code 显示当前目录和 git 信息
    echo "📂 Claude Code PWD: $(pwd)"
    if git rev-parse --git-dir > /dev/null 2>&1; then
        branch=$(git branch --show-current 2>/dev/null)
        [[ -n "$branch" ]] && echo "🔀 Git Branch: $branch"
    fi
fi

效果

配置后，每次 Claude Code 执行命令都会显示：

📂 Claude Code Working Dir: /Users/sean/projects/PromptX
🔀 Git Branch: feat/gauge-testing

优点

1. 只对 Claude Code 生效 - 通过检查 $CLAUDECODE 环境变量，不影响你的正常终端
2. 提供上下文信息 - Claude 始终知道当前在哪个目录、哪个分支
3. 无需手动 source - 放在 .zshenv 中会自动加载
4. 可扩展 - 可以添加更多信息如 Node 版本、Python 环境等

扩展想法

你还可以添加更多信息：

if [[ -n "$CLAUDECODE" ]]; then
    # 显示目录
    print -P "%F{blue}📂 PWD:%f %F{green}$(pwd)%f"
  
    # Git 信息
    if git rev-parse --git-dir > /dev/null 2>&1; then
        branch=$(git branch --show-current 2>/dev/null)
        [[ -n "$branch" ]] && print -P "%F{yellow}🔀 Git:%f $branch"
    fi
  
    # Node 版本（如果是 Node 项目）
    if [[ -f "package.json" ]]; then
        node_version=$(node -v 2>/dev/null)
        [[ -n "$node_version" ]] && print -P "%F{cyan}📦 Node:%f $node_version"
    fi
  
    # Python 虚拟环境
    if [[ -n "$VIRTUAL_ENV" ]]; then
        print -P "%F{magenta}🐍 Venv:%f ${VIRTUAL_ENV:t}"
    fi
fi

小贴士

• Claude Code 的执行日志在 ~/.claude/projects/
• Shell 快照在 ~/.claude/shell-snapshots/
• 每个项目会话都有独立的上下文

这样配置后，Claude Code 就能更好地理解当前环境，减少出错的可能性！

---

分享理由：很多人可能不知道 Claude Code 实际运行的是 zsh，而且可以通过 .zshrc 配置来增强它的能力。这个小技巧能让 AI 助手更好地理解你的项目环境。