Claude code使用技巧汇总

发表于 分类于

uv 切换问题

原因分析

Claude Code 的 python 环境检测优先级为：

  1. requirements.txt — 最高优先级
  2. pyproject.toml — 次之
  3. 其他配置

当项目没有 uv.lock 或 uv 特定的 pyproject.toml 结构时，Claude Code 默认走 pip/venv 流程，不会自动切换到 uv。

解决方案

方案 改动量 生效速度 推荐场景
CLAUDE.md 最少 重启后 快速解决
settings.json 少 即时 项目级配置
uv 项目化 中 完成后 长期维护

方案 1（推荐）：CLAUDE.md

在项目根目录创建 CLAUDE.md：

1
2
3
# Python Environment
Use `uv` for all Python package management. Never use pip.
Run commands with `uv run`, e.g., `uv run python`, `uv add <package>`.

加完 CLAUDE.md 后重启 Claude Code，它就会用 uv run python 代替默认的 pip/venv 流程。

方案 2：settings.json

在 {project}/.claude/settings.json 中配置：

1
2
3
4
5
{
  "python": {
    "packageManager": "uv"
  }
}

方案 3：uv 项目化

将项目完全迁移到 uv 管理：

1
2
3
uv init
uv add <your-packages>
# 确保有 uv.lock 文件存在

更多使用技巧将陆续补充。