解决 uv run 时 ModuleNotFoundError: No module named ‘anthropic‘ 的完整指南

解决 uv run 时 ModuleNotFoundError: No module named ‘anthropic’ 的完整指南

摘要

本文详细分析了使用 uv run 执行脚本时出现 “ModuleNotFoundError: No module named ‘anthropic’” 的原因，并提供了多种解决方案。问题主要源于 uv 工具的环境隔离机制，导致全局安装的包无法被 uv 运行环境识别。通过在 uv 虚拟环境中安装依赖、使用全局安装参数、检查路径配置等方法，可以有效解决该问题，确保脚本正常运行。

问题原因分析

uv 的环境隔离机制

uv 工具默认使用虚拟环境运行脚本，与系统全局环境隔离。即使您在全局环境中安装了 anthropic，uv 运行时可能使用独立的虚拟环境，导致模块无法被找到。

安装位置不匹配

使用系统 pip 安装的包会位于全局 Python 环境的 site-packages 中，而 uv run 可能依赖项目特定的虚拟环境，造成安装位置与运行环境不一致。

路径配置问题

uv 可能未正确配置 Python 路径，导致无法定位已安装的模块。

解决方案

方法 1：在 uv 虚拟环境中安装 anthropic

在项目目录下执行以下命令，在 uv 管理的虚拟环境中安装所需包：

uv pip install anthropic

然后运行脚本