UV Python Scripts FAQs

Question 1

Why use UV scripts for Claude Code hooks?

Accepted Answer

They are ideal because they are self-contained and deterministic. You don't need to manage a global environment; the script handles its own requirements every time Claude executes it.

Question 2

Can I use hyphens in my Python script names?

Accepted Answer

No, you should use underscores. Hyphens are interpreted as minus operators in Python, which prevents the script from being easily imported for unit testing.

Question 3

How do I make a UV script executable?

Accepted Answer

Add the shebang #!/usr/bin/env -S uv run --script to the top of the file and run 'chmod +x' on the file to allow direct execution without the 'uv run' prefix.

Question 4

What is a UV script?

Accepted Answer

A UV script is a single Python file that uses a PEP 723 metadata block to define its dependencies, allowing the UV tool to automatically create a temporary environment to run it.

Question 5

Why must I include an empty dependencies list?

Accepted Answer

The PEP 723 specification requires the 'dependencies' field to be present even if it is empty; omitting it will cause UV to fail when trying to parse the script metadata.

UV Python Scripts

About

Key Features

Use Cases

UV Python Scripts

About

Key Features

Use Cases