К основному содержанию
скилл CX Codex

uv-python-versions — скилл для Claude Code: версии Python

Скилл uv-python-versions помогает управлять версиями CPython и PyPy через uv: устанавливать интерпретаторы, закреплять версию проекта и переключаться между ними.

MIT 332 установок ★ 60 обновлён 2026-11-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add laurigates/claude-plugins --skill uv-python-versions -a claude-code
Открыть на GitHub

Что делает uv-python-versions

Скилл подсказывает команды uv для установки конкретных версий Python, просмотра доступных интерпретаторов и поиска нужного. Он также помогает закрепить версию проекта через .python-version или учесть ограничение requires-python в pyproject.toml.

Для тестирования на разных версиях можно запускать команды через uv run --python или создавать отдельные виртуальные окружения командой uv venv --python. Скилл охватывает CPython и PyPy. Библиотеки проекта и глобальные CLI-инструменты относятся к другим задачам, а не к этому скиллу.

Какие задачи решает

  • установить нужную версию CPython или PyPy
  • закрепить версию Python в .python-version
  • найти установленный интерпретатор
  • запустить тесты на нескольких версиях Python
  • создать виртуальное окружение с выбранным Python

Примеры запросов агенту

  • Установи Python 3.12 и закрепи эту версию для проекта.
  • Покажи установленные версии Python и найди интерпретатор 3.11.
  • Подскажи, как запустить pytest на Python 3.10 и 3.12 через uv.

Как установить uv-python-versions

1Через Skills CLI (Vercel)

npx skills add laurigates/claude-plugins --skill uv-python-versions -a claude-code

2Вручную: положить файлы

~/.claude/skills/uv-python-versions/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/uv-python-versions/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об uv-python-versions

Как установить uv-python-versions в Claude Code?

Выполните npx skills add laurigates/claude-plugins --skill uv-python-versions -a claude-code. Файл скилла появится по пути ~/.claude/skills/uv-python-versions/SKILL.md.

Что делает uv-python-versions?

Скилл помогает устанавливать и находить версии CPython и PyPy с помощью uv, а также закреплять версию Python для проекта.

Можно ли использовать uv-python-versions для тестов на разных версиях Python?

Да. Он подсказывает запуск команд через uv run --python и создание отдельных окружений с помощью uv venv --python.

Исходный текст

SKILL.md · MIT
---
created: 2025-12-16
modified: 2026-11-14
reviewed: 2026-04-25
name: uv-python-versions
description: Install and manage Python interpreter versions with uv. Use when the user mentions installing Python versions, .python-version, uv python, or managing CPython/PyPy.
user-invocable: false
allowed-tools: Bash(uv python install), Bash(uv python list), Bash(uv python list --only-installed), Bash(uv python list --verbose), Bash(uv python find), Bash(uv venv *), Bash(uv init *), Read, Grep, Glob
---

# UV Python Version Management

Quick reference for installing and managing Python interpreter versions with UV.

## When to Use This Skill

| Use this skill when... | Use a focused sibling instead when... |
|---|---|
| Installing a specific CPython or PyPy interpreter with `uv python install` | Adding a Python library to a project — use uv-project-management |
| Pinning a project to a Python version via `.python-version` or `requires-python` | Installing a global Python CLI tool — use uv-tool-management |
| Switching between multiple installed interpreters for testing | Running a script with auto-managed Python — use uv-run |

## When This Skill Applies

- Installing specific Python versions
- Switching between multiple Python versions
- Pinning Python versions for projects
- Managing CPython and PyPy interpreters
- Finding and listing installed Python versions

## Quick Reference

### Installing Python Versions

```bash
# Install latest Python
uv python install

# Install specific version
uv python install 3.11
uv python install 3.12
uv python install 3.10 3.11 3.12

# Install exact version
uv python install 3.11.5
uv python install [email protected]

# Install PyPy
uv python install [email protected]
uv python install [email protected]
```

### Listing Python Versions

```bash
# List all available versions
uv python list

# List only installed versions
uv python list --only-installed

# List with verbose details
uv python list --verbose
```

### Pinning Python Versions

```bash
# Pin version for current project
uv python pin 3.11
uv python pin 3.12.1

# Pin PyPy
uv python pin [email protected]

# Pin with version file
# Creates/updates .python-version
```

### Finding Python Interpreters

```bash
# Find any Python installation
uv python find

# Find specific version
uv python find 3.11
uv python find 3.12

# Find PyPy
uv python find pypy
uv python find [email protected]
```

### Using Specific Python Versions

```bash
# In project commands
uv run --python 3.11 script.py
uv run --python 3.12 pytest

# Creating virtual environments
uv venv --python 3.11
uv venv --python 3.10 .venv-py310

# Initializing projects
uv init --python 3.12 my-project
```

## Python Version Sources

UV searches for Python in this order:
1. **UV-managed** - Installed via `uv python install`
2. **.python-version** - Pin file in project directory
3. **pyproject.toml** - `requires-python` field
4. **System Python** - Existing system installations
5. **Environment** - `$PATH` and standard locations

## Version Pinning

### .python-version File

```bash
# Pin creates this file
uv python pin 3.11

# File contents
3.11

# Exact version
uv python pin 3.11.5
```

### pyproject.toml

```toml
[project]
requires-python = ">=3.11"

# UV respects this constraint
```

## Supported Python Implementations

### CPython

```bash
# Default implementation
uv python install 3.11
uv python install [email protected]
uv python install [email protected]
```

### PyPy

```bash
# Alternative Python implementation
uv python install [email protected]
uv python install [email protected]
```

## Common Commands

```bash
# Install and pin latest Python 3.12
uv python install 3.12 && uv python pin 3.12

# Install multiple versions for testing
uv python install 3.10 3.11 3.12

# Check which Python is active
uv python find
uv run python --version

# Uninstall version (manual)
rm -rf ~/.local/share/uv/python/cpython-3.11.5-*
```

## Integration with Projects

### Project Initialization

```bash
# Initialize with specific Python
uv init --python 3.11 my-project

# Generates .python-version
cat .python-version
# 3.11
```

### Running Commands

```bash
# Use project's pinned Python
uv run python script.py

# Override with specific version
uv run --python 3.12 script.py

# Use system Python
uv run --python python3 script.py
```

## Multi-Version Testing

```bash
# Test across Python versions
uv run --python 3.10 pytest
uv run --python 3.11 pytest
uv run --python 3.12 pytest

# Create version-specific venvs
uv venv --python 3.10 .venv-py310
uv venv --python 3.11 .venv-py311
uv venv --python 3.12 .venv-py312
```

## Key Features

- **Fast downloads**: Parallel downloads with caching
- **Automatic**: Downloads versions on-demand
- **Isolated**: UV-managed versions don't conflict with system Python
- **Portable**: Uses standalone Python distributions
- **Cross-platform**: Works on Linux, macOS, and Windows

## See Also

- `uv-project-management` - Using pinned Python versions in projects
- `uv-workspaces` - Python versions in monorepos
- `python-testing` - Testing across multiple Python versions

## References

- Official docs: https://docs.astral.sh/uv/guides/install-python/
- Python standalone builds: https://github.com/indygreg/python-build-standalone
- Detailed guide: See REFERENCE.md in this skill directory

© laurigates · MIT · laurigates/claude-plugins

Похожие скиллы

Все скиллы по теме «Языки программирования» →
python-tdd-with-uv spencerpauly Скилл python-tdd-with-uv для Claude Code ведёт разработку на Python в цикле red-green-refactor с uv: один провальный тест, минимальный код для его прохода, затем рефакторинг. CX Codex +1 449установок python-pro Seth Hobson Субагент python-pro для Claude Code пишет и разбирает код на Python 3.12+, включая async, тесты, API и производительность. Помогает разрабатывать и рефакторить Python-проекты. CX Codex 11 689установок python-cursorrules-prompt-file-best-practices PatrickJS Правило python-cursorrules-prompt-file-best-practices для Cursor задаёт требования к Python-коду: аннотации типов, докстринги и тесты на pytest. CX Codex +1 ★ 41 178звёзд репо python-scaffold Seth Hobson Команда python-scaffold для Claude Code создаёт каркас Python-проекта под FastAPI, Django, библиотеку или CLI. По запросу она формирует структуру каталогов, настройки и тесты. CX Codex +1 ★ 42 780звёзд репо modern-python trailofbits Скилл modern-python для Claude Code настраивает Python-проекты с uv, ruff и ty; применяется при создании проектов, написании скриптов и миграции со старых инструментов. CX Codex +1 9 700установок python-uv Mindrally Скилл python-uv для Claude Code. Заставляет агента ставить и синхронизировать Python-пакеты только через uv, без pip и poetry. В проекте с uv или когда нужна стабильность окружений. CX Codex +1 1 000установок

Из того же набора27

Весь набор →
basedpyright-type-checking Скилл basedpyright-type-checking настраивает статическую типизацию Python через basedpyright, помогает выбрать между ним и mypy, а также подготовить конфигурацию для проекта. CX Codex +1 357установок uv-workspaces Скилл uv-workspaces для работы с многопакетными Python-проектами на uv: настройка workspace, общий lockfile, зависимости между пакетами. CX Codex +1 356установок uv-run Скилл uv-run инструктирует агента запускать Python-скрипты через менеджер uv без ручной активации виртуального окружения и оформлять зависимости прямо внутри файла. CX Codex +1 342установок python-packaging Скилл python-packaging помогает собрать пакеты wheel и sdist через uv, а затем выгрузить их в PyPI или Test PyPI. Пригодится при настройке pyproject.toml и консольных утилит. CX Codex +1 336установок uv-advanced-dependencies Скилл uv-advanced-dependencies для работы с нестандартными источниками зависимостей в uv: репозиториями на GitHub, локальными пакетами в режиме редактирования, приватными индексами. CX Codex +1 332установок uv-tool-management Скилл uv-tool-management для Claude Code управляет глобальными Python CLI-утилитами через uv и запускает их без установки. Заменяет pipx и работает с ruff и pytest. CX Codex +1 328установок imagemagick-conversion Скилл imagemagick-conversion для Claude Code пакетно преобразует, масштабирует и оптимизирует изображения через ImageMagick в командной строке. Конвертирует форматы, создаёт миниатюры и обрабатывает сотни файлов за раз. CX Codex +1 260установок jq-json-processing Скилл jq-json-processing для парсинга, фильтрации и трансформации JSON через jq. Извлекает поля, фильтрует массивы, перестраивает объекты и валидирует синтаксис. CX Codex +1 245установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой