Claude CodeでPython関数を作成するプロンプト例

1. Pythonで最初に見るべき前提

1. Pythonで最初に見るべき前提

PythonをClaude Codeに依頼するときは、最初に「何を直したいのか」「どのファイルを見てよいのか」「どの結果なら成功なのか」を分けて考えます。これだけで、AIの回答が一般論から実作業に近づきます。

特にPython開発の記事では、ツール名だけを並べるより、実際のコマンド、エラー文、設定ファイル、テスト結果を一緒に扱うほうが読者にとって使いやすくなります。

2. Pythonに合う確認コマンド

2. Pythonに合う確認コマンド

Pythonでは、作業前の確認もテーマごとに変える必要があります。毎回同じpwdやlsだけを見るのではなく、記事の内容に合うコマンドを使うことで、原因の切り分けがしやすくなります。

python -m venv .venv
.venv\Scripts\python -m pytest -q
python -m py_compile app.py

このコマンドは、Claude Codeへ貼る前に自分の環境を確認するためのものです。出力結果が分かれば、AIにも「どこで失敗しているか」を具体的に説明できます。

3. Python開発で使う具体的なサンプルコード

3. Python開発で使う具体的なサンプルコード

Claude CodeでPython関数を作成するプロンプト例では、下のように小さいサンプルから試すと理解しやすくなります。長いコードを一度に直すより、まず1つの関数、1つの設定、1つのテストに絞りましょう。

from dataclasses import dataclass

@dataclass
class Task:
    title: str
    done: bool = False

def remaining(tasks: list[Task]) -> list[str]:
    return [task.title for task in tasks if not task.done]

サンプルコードは、そのまま貼るためだけのものではありません。変数名、ファイル名、実行コマンドを自分の環境に合わせて置き換え、期待する結果を確認するところまでが学習です。

4. Pythonで失敗しやすいポイント

4. Pythonで失敗しやすいポイント

Pythonでつまずいたら、エラーメッセージだけでなく、実行したコマンド、変更したファイル、期待した結果、実際の結果をセットで整理します。Claude Codeへ「原因候補を3つに分けて」と依頼すると、調査しやすくなります。

また、修正案を一度に大きく採用しないことも重要です。小さく変更してテストし、問題がなければ次の範囲へ進めると、失敗しても戻しやすくなります。

5. Claude Codeへ渡すプロンプト例

5. Claude Codeへ渡すプロンプト例

Pythonを依頼するときは、Claude Codeに作業範囲と確認方法を明確に伝えます。以下のような形にすると、回答が記事テーマに寄りやすくなります。

Claude CodeでPython関数を作成するプロンプト例について、対象ファイル、確認コマンド、変更してよい範囲、テスト方法を分けて提案してください。一般論ではなく、この記事のテーマに合う小さなコード例を1つだけ出してください。

プロンプトでは、「全部直して」よりも「まず原因を説明して」「次に最小修正案を出して」「最後に確認手順を出して」と段階を分けるほうが安全です。

6. 実務で安全に使うための確認項目

6. 実務で安全に使うための確認項目

Pythonを実務で使うなら、AIが出したコードを読む時間を必ず残します。便利だからこそ、差分、ログ、テスト、既存設計との整合性を確認することが大切です。

7. 差分・ログ・テストで結果を判断する方法

7. 差分・ログ・テストで結果を判断する方法

Claude Codeで作業したあとは、コードが増えたかどうかより、何が変わったのかを確認します。差分が読めない状態で次の依頼へ進むと、後から問題の原因を追いにくくなります。

git diff --check
git diff --stat
# プロジェクトに合わせて npm test / pytest / php artisan test / mvn test を実行

Python開発では、確認コマンドもプロジェクトごとに違います。Claude Codeに「このリポジトリで使うべきテストコマンドを探して」と聞くと、package.json、composer.json、pom.xmlなどから候補を整理できます。

8. Pythonを自分の環境で試す練習

8. Pythonを自分の環境で試す練習

最後に、Pythonを自分の小さなプロジェクトで試してみましょう。記事を読むだけでなく、値を変える、エラーを起こす、テストを失敗させる、修正して通す、という流れまで行うと理解が定着します。

まとめ

まとめ

Python関数を作成するで押さえたい要点

この記事では、Claude CodeでPython関数を作成するプロンプト例について、Claude Codeを使いながら確認する流れを整理しました。Python開発では、記事タイトルに合うコード、確認コマンド、エラーの見方を分けて考えることが大切です。

まとめでは記事1と同じコードを繰り返すのではなく、同じ考え方を別パターンで確認します。別の入力値、別の関数、別の設定例を使うことで、読者が自分の環境に置き換えやすくなります。

復習用の別サンプルコード

まとめでは、dataclassではなく文字列を受け取って返す小さな関数で、入出力を確認します。

def build_slug(title: str) -> str:
    return title.strip().lower().replace(" ", "-")

print(build_slug(" Claude Code Sample "))

Claude Codeで次に確認すること

• 記事テーマに合うファイルやコマンドを先に確認する
• 同じコードではなく、別の小さい例で動きを試す
• AIの回答を採用する前に、差分、ログ、テスト結果を見る
• 次回使えるプロンプトを短く残す