PAYATHON 2026

Claude Code 如何使用 AGENTS.md 指定的 Conda Python？

架构老王

可以在项目根目录的 CLAUDE.md 中导入 AGENTS.md，并让 Claude Code 使用解释器的完整路径执行命令。这样既能继续维护现有的环境说明，也能解决 Claude Code 未自动加载该文件的情况。

先确认项目指令是否加载

Cursor 自带聊天面板能够使用这份配置，并不代表 Claude Code 扩展也已加载。原问题没有提供扩展版本和实际执行命令，因此应先排查指令是否加载。

根据当前官方文档，Claude Code 直接读取 AGENTS.md 需要 v2.1.277 或更高版本，是否加载还受项目中其他指令文件和配置影响。默认情况下，工作目录或其上级目录存在 CLAUDE.md 或 CLAUDE.local.md 时，会优先加载这些文件。参见 AGENTS.md 加载规则。

在 CLAUDE.md 中导入现有配置

在项目根目录放置这两个文件：

项目根目录/
├── AGENTS.md
└── CLAUDE.md

在 CLAUDE.md 中添加下面这一行；如果文件已经存在，保留原有内容：

@AGENTS.md

实际文件中应直接写入 @AGENTS.md，不要加反引号或放入代码块。这是文件导入语法，与普通文字“请读取 AGENTS.md”不同。官方文档也建议 Windows 用户通过这种方式共享指令，避免符号链接的额外要求。参见 共享项目指令文件。

保存后，在该项目中开启一个新的 Claude Code 会话。如果当前界面提供 /memory 或 /context，可以用它们检查指令文件的加载情况。

让 Claude Code 实际执行验证命令

可以向扩展发送以下要求：

请按项目指令使用指定的 Conda Python，执行命令打印 sys.executable，并检查该解释器对应的 pip。请展示实际执行的命令和输出。

如果执行工具使用 PowerShell，命令可以写成：

& 'C:\Usefuls\anaconda3\envs\test\python.exe' -c "import sys; print(sys.executable)"
& 'C:\Usefuls\anaconda3\envs\test\python.exe' -m pip --version

如果执行工具使用 Git Bash，可以使用正斜杠路径：

'C:/Usefuls/anaconda3/envs/test/python.exe' -c "import sys; print(sys.executable)"
'C:/Usefuls/anaconda3/envs/test/python.exe' -m pip --version

不要仅凭 Cursor 集成终端的外观判断扩展使用的 Shell，应查看 Claude Code 实际调用的执行工具和命令。

sys.executable 应指向 test 环境中的 python.exe，路径分隔符或大小写可能有所不同。pip --version 会显示 pip 的安装位置。如果提示没有 pip，应继续检查目标环境，不要改用其他环境中的裸 pip。

已加载指令却仍使用错误解释器怎么办

查看实际命令，分别排查：

  • 扩展执行的是裸 python 或 pip：检查是否有冲突的项目指令，并在当前任务中再次明确要求使用完整路径。
  • 执行了指定路径，但提示文件不存在：核对路径，确认执行位置是本机 Windows、WSL、容器还是远程环境。
  • 指定解释器能够启动，但某些包运行失败：继续排查 Conda 环境本身及其运行时依赖。

CLAUDE.md 和 AGENTS.md 提供行为指令，不会自动修改 Shell 的 PATH，也不会强制绑定解释器。应以实际命令和 sys.executable 输出判断是否生效。官方说明

扩展自带 Claude Code CLI。检查版本时，应查看 Cursor 扩展列表中的版本，不能仅根据终端中独立安装的 claude --version 判断扩展能力。扩展安装与版本说明

备注：内容仅供参考。