如何在Claude Code中配置Hatch Python环境管理器？

以下是几个无需重复配置、规避安全提示的可行方案：

方案1：让Hatch在项目目录内创建虚拟环境 #

修改Hatch全局配置，让虚拟环境默认生成在项目根目录的.venv文件夹下（直观且符合多数工具的默认识别逻辑）：

hatch config set dirs.env.virtual .venv

也可以在单个项目的pyproject.toml中添加局部配置，仅对当前项目生效：

[tool.hatch.envs.default]
virtual = { path = ".venv" }

这样Claude Code的诊断工具（ruff、pyright、pytest等）会自动识别项目根目录的.venv环境，无需额外前缀或激活操作。

方案2：统一配置工具使用Hatch环境执行 #

在.claude/settings.json中，给需要的诊断工具直接指定用hatch run前缀执行，无需重复配置每个命令的两种模式：

{
  "tools": {
    "pytest": {
      "command": "hatch run pytest"
    },
    "ruff": {
      "command": "hatch run ruff"
    },
    "pyright": {
      "command": "hatch run pyright"
    }
  }
}

这种方式既利用了Hatch的环境隔离，又不会触发source shell的安全提示，因为所有命令都是直接调用Hatch封装的执行逻辑，而非手动激活环境。

方案3：直接指定虚拟环境的可执行文件路径 #

通过hatch env find命令获取当前项目虚拟环境的绝对路径，例如：

hatch env find
# 输出示例：/home/user/.local/share/hatch/env/virtual/my-project/abc123

然后在.claude/settings.json中直接指向该环境下的工具可执行文件：

{
  "tools": {
    "pytest": {
      "command": "/home/user/.local/share/hatch/env/virtual/my-project/abc123/bin/pytest"
    },
    "ruff": {
      "command": "/home/user/.local/share/hatch/env/virtual/my-project/abc123/bin/ruff"
    }
  }
}

注意：如果切换项目或重建环境，需要更新路径。若想动态获取路径，可在shell配置中设置别名，但方案1和2更省心。

内容的提问来源于stack exchange，提问作者David Maze