在 Claude Code 里分析「其他地方的文件」，核心思路是：把文件 “喂” 给 Claude 的会话上下文，它才能读、能分析、能基于文件干活。下面给你讲清楚所有方式，从最简单到高级，覆盖你可能遇到的场景。

一、最常用：在当前会话里手动添加文件 /add

这是日常开发里最直接的方式，也是你在项目里已经在用的方法。

1. 命令格式

# 进入项目目录并启动 Claude
cd 你的项目根目录
claude

# 在 > 提示符下添加文件
> /add 路径/到/文件.java
> /add 路径/到/目录/
> /add 文件1.java 文件2.java mapper/*.xml

2. 场景示例

你想在财务 NC 项目里，分析另一个项目里的通用工具类 CommonUtils.java：

# 1. 启动当前项目的 Claude 会话
cd finance-nc-accounting-engine
claude

# 2. 添加外部文件（绝对路径）
> /add /Users/xxx/code/other-project/src/main/java/com/zto/utils/CommonUtils.java

# 3. 分析文件
> 分析这个 CommonUtils 工具类，看看哪些方法可以复用到当前项目

3. 关键说明

• 可以用相对路径（相对于当前项目目录）或绝对路径；
• 可以添加单个文件、多个文件、甚至整个目录；
• 查看已加载文件：/files；
• 移除文件：/remove 路径。

二、不启动会话：命令行一次性添加文件

如果你不想进入交互模式，只想一次性分析文件，可以直接在终端里用 --add 参数。

命令格式

claude "帮我分析这个工具类，看看有哪些潜在问题" \
  --add /Users/xxx/code/other-project/src/main/java/com/zto/utils/CommonUtils.java

适用场景

• 快速分析单个文件，不需要后续交互；
• 想把文件分析作为脚本 / 命令链的一部分。

三、把文件复制到当前项目目录再分析

这是兼容性最好的方式，适合文件跨目录访问有问题（比如权限限制）的情况。

步骤 

1. 把外部文件复制到当前项目的一个临时目录里（比如 external-libs/）： 

   mkdir -p external-libs
   cp /Users/xxx/code/other-project/src/main/java/com/zto/utils/CommonUtils.java external-libs/

2. 在 Claude 里添加这个目录：
3. 分析完成后，如果你不想提交这些文件，可以在 .gitignore 里加上：

四、通过剪贴板直接粘贴文件内容（超轻量方式）

如果文件不大，你不想动任何文件结构，可以直接把内容粘给 Claude。

步骤 

1. 打开外部文件，复制全部内容；
2. 在 Claude 里直接粘贴，前面加上描述：

   下面是 CommonUtils.java 的全部代码，请帮我分析它的线程安全问题：
   [在这里粘贴完整代码]

适用场景

• 分析小文件、配置片段、脚本；
• 不想让 Claude 访问本地文件系统的情况。

五、通过软链接（符号链接）让外部文件 “看起来在项目里”

Mac/Linux 上可以用 ln -s 把外部文件 / 目录链接到当前项目，Claude 会把它当成项目内文件处理。

步骤

# 1. 进入项目根目录
cd finance-nc-accounting-engine

# 2. 创建软链接，指向外部文件/目录
ln -s /Users/xxx/code/other-project/src/main/java/com/zto/utils/ external-utils

# 3. 像项目内文件一样添加
claude
> /add external-utils/CommonUtils.java

注意

• 软链接只是一个 “快捷方式”，不会复制文件，原文件修改会同步影响；
• 确保软链接的路径在 settings.json 的 allowed_paths 里，不会被 denied_paths 拦截。

六、在 CLAUDE.md 里提前定义外部依赖文件（推荐长期场景）

如果你经常需要分析几个固定的外部文件，可以把它们写到 CLAUDE.md 里，每次会话自动加载。

示例

# CLAUDE.md 外部依赖配置

## 必须加载的外部工具类
- `/Users/xxx/code/other-project/src/main/java/com/zto/utils/CommonUtils.java`
- `/Users/xxx/code/other-project/src/main/java/com/zto/constants/BizConstants.java`

分析代码时，请优先复用这些类，不要重复实现。

Claude 在每次启动会话时，会自动读取这些信息，相当于提前 “知道” 这些文件，你再用 /add 就更顺畅了。

七、权限与安全注意事项（重要）

1. denied_paths 会拦截外部文件：如果你的 settings.json 里配置了 denied_paths，外部文件如果匹配规则（比如 **/*.yml），即使你用 /add 也会被拒绝。
2. 敏感文件不要直接添加：数据库配置、密钥文件等，建议用剪贴板方式，分析完就丢，不要加到会话里。
3. 软链接 / 复制文件要避免提交：如果复制外部文件到项目里，记得加到 .gitignore，避免不小心提交到代码库。

总结：不同场景用哪种方式？