added materials for How to Use the Claude API in Python for AI-Powere… (#750)

* added materials for How to Use the Claude API in Python for AI-Powered Applications

* Updated code after first TR

* Apply ruff format to fix Linux314 CI

Pure formatter changes; no behavior change.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Add README.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Final QA

---------

Co-authored-by: Philipp Acsany <68116180+acsany@users.noreply.github.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: Bartosz Zaczyński <bartosz.zaczynski@gmail.com>

Author: 4 people

claude-api-python/README.md

@@ -0,0 +1,3 @@
+# How to Use the Claude API in Python
+
+This folder contains supporting materials for the Real Python tutorial [How to Use the Claude API in Python](https://realpython.com/claude-api-python/).

claude-api-python/basic_claude_call.py

@@ -0,0 +1,11 @@
+import anthropic
+
+client = anthropic.Anthropic()
+
+response = client.messages.create(
+    model="claude-sonnet-4-6",
+    max_tokens=1024,
+    messages=[{"role": "user", "content": "What is the Zen of Python?"}],
+)
+
+print(response.content[0].text)

claude-api-python/coding_assistant.py

@@ -0,0 +1,20 @@
+import anthropic
+
+client = anthropic.Anthropic()
+
+system_prompt = """
+You are a Python coding assistant. You only answer questions about Python.
+If the user asks about any other programming language or unrelated topic,
+politely explain that you can only help with Python questions.
+"""
+
+user_input = input("Ask me anything about Python: ")
+
+response = client.messages.create(
+    model="claude-sonnet-4-6",
+    max_tokens=1024,
+    system=system_prompt,
+    messages=[{"role": "user", "content": user_input}],
+)
+
+print(f"\n{response.content[0].text}")

claude-api-python/requirements.txt

@@ -0,0 +1,2 @@
+anthropic
+pydantic

claude-api-python/structured_output_1.py

@@ -0,0 +1,38 @@
+import anthropic
+import json
+
+client = anthropic.Anthropic()
+
+response = client.messages.create(
+    model="claude-sonnet-4-6",
+    max_tokens=1024,
+    system="You are a Python coding assistant.",
+    messages=[
+        {
+            "role": "user",
+            "content": "Write a Python function that adds two numbers.",
+        }
+    ],
+    output_config={
+        "format": {
+            "type": "json_schema",
+            "schema": {
+                "type": "object",
+                "properties": {
+                    "function_name": {"type": "string"},
+                    "code": {"type": "string"},
+                    "explanation": {"type": "string"},
+                },
+                "required": ["function_name", "code", "explanation"],
+                "additionalProperties": False,
+            },
+        }
+    },
+)
+
+result = json.loads(response.content[0].text)
+
+print("--- Approach 1: Handwritten JSON schema ---")
+print(f"Function: {result['function_name']}")
+print(f"\nCode:\n{result['code']}")
+print(f"\nExplanation: {result['explanation']}")

claude-api-python/structured_output_2.py

@@ -0,0 +1,32 @@
+import anthropic
+
+from pydantic import BaseModel
+
+
+class FunctionDescription(BaseModel):
+    function_name: str
+    code: str
+    explanation: str
+
+
+client = anthropic.Anthropic()
+
+response = client.messages.parse(
+    model="claude-sonnet-4-6",
+    max_tokens=1024,
+    system="You are a Python coding assistant.",
+    messages=[
+        {
+            "role": "user",
+            "content": "Write a Python function that adds two numbers.",
+        }
+    ],
+    output_format=FunctionDescription,
+)
+
+result = response.parsed_output
+
+print("--- Approach 2: Pydantic + client.messages.parse() ---")
+print(f"Function: {result.function_name}")
+print(f"\nCode:\n{result.code}")
+print(f"\nExplanation: {result.explanation}")