Claude Code 的 skills 能否使用独立的 Python/uv 环境？

可以。对于使用 Python 脚本的 skill，可以分别创建 uv 虚拟环境，也可以复用已有环境。执行时指定对应环境的 Python 解释器，就能让不同的 skills 使用各自的 Python 依赖，无需切换 Claude Code 的整体运行环境。

为什么多个 skills 会发生依赖冲突？

如果多个 skill 的脚本都使用同一个 python，依赖也安装在同一个环境里，就可能出现包版本不兼容。需要关注脚本使用的解释器，以及依赖安装的位置。将 skills 放在不同目录，并不会自动创建独立的 Python 环境。

Claude Code 的 skill 可以包含脚本执行说明，因此可以在命令中指定环境。相关组织方式见 Claude Code skills 文档。

如何为某个 skill 创建专用环境？

以下示例适用于 macOS/Linux，假设已安装 uv，且 skill 包含 requirements.txt 和 scripts/task.py。请将所有 /path/to/... 替换为实际路径。

先创建虚拟环境，再把依赖安装到该环境：

uv venv /path/to/envs/skill-a

uv pip install \
  --python /path/to/envs/skill-a/bin/python \
  -r /path/to/skills/skill-a/requirements.txt

然后用这个环境的解释器运行脚本：

/path/to/envs/skill-a/bin/python \
  /path/to/skills/skill-a/scripts/task.py

uv 支持在指定路径创建虚拟环境，也支持通过 uv pip install --python 指定依赖安装目标，详见 uv 环境管理文档。

在对应的 SKILL.md 中写明执行入口，例如：

---
name: skill-a
description: 执行 skill-a 的 Python 任务。
---

运行脚本时，使用指定虚拟环境中的 Python：

`/path/to/envs/skill-a/bin/python /path/to/skills/skill-a/scripts/task.py`

如果环境不存在或缺少依赖，报告具体错误。

执行命令中已经指定了环境，无论之前是否运行过 source .../activate。如果环境缺失时改用系统 Python，会重新引入环境不一致的问题。

如何让不同 skills 使用已有环境？

已有环境可以直接使用，只需分别为每个 skill 指定解释器：

# skill-a 使用环境 a
/path/to/envs/skill-a/bin/python /path/to/skills/skill-a/scripts/task.py

# skill-b 使用环境 b
/path/to/envs/skill-b/bin/python /path/to/skills/skill-b/scripts/task.py

Windows 下，解释器路径通常是 <env>\Scripts\python.exe，命令需要相应调整。

如果 skill 本身是包含 pyproject.toml 的独立 uv 项目，也可以使用项目执行方式：

uv run --project /path/to/skills/skill-a \
  python /path/to/skills/skill-a/scripts/task.py

这里要求项目已声明所需依赖。uv run 会在执行前准备或同步项目环境。--project 指定项目位置，但不会自动将后续脚本参数的相对路径改为相对于该目录，因此示例使用绝对脚本路径。参见 uv 命令参考。

如果需要精确复用某个已有虚拟环境，直接调用它的解释器最直观。

context: fork 能解决依赖冲突吗？

context: fork 让 skill 在独立的 subagent 上下文中运行，处理的是对话上下文隔离。不能据此认为它创建了独立的 Python 虚拟环境；脚本仍需明确选择解释器或 uv 项目。参见 skills 的 subagent 执行说明。

Python 虚拟环境主要隔离 Python 包。脚本仍可能访问当前进程允许访问的文件、环境变量和网络，也可能依赖共享的系统工具。如果还需要隔离系统依赖或文件访问，应另行配置容器、沙箱或虚拟机。

备注：内容仅供参考。