【結論】Python環境構築と安全な実行
Claude CodeはPython仮想環境、依存関係、Lint、型検査、テストの構築を支援できますが、グローバル環境へ無条件にpip installさせないことが重要です。
既存プロジェクトではpyproject.toml、requirements.txt、uv.lock、poetry.lockなどを確認し、採用済みの管理方式を維持します。
最初にPlanモードで変更予定とコマンドを確認し、仮想環境内のインタープリタを明示して実行します。
# ターミナルで実行：作業用ディレクトリを作成
mkdir python-task && cd python-task
# ターミナルで実行：仮想環境を作成
python3 -m venv .venv
# ターミナルで実行：仮想環境を有効化
source .venv/bin/activate
# Windows PowerShellで実行：仮想環境を有効化
.\.venv\Scripts\Activate.ps1
# ターミナルで実行：PlanモードでClaude Codeを起動
claude --permission-mode plan具体的な手順・設定方法
Pythonの必要バージョン、OS、パッケージ管理方式、実行対象を確認します。
Claudeへ作成予定ファイル、追加パッケージ、テスト方法、ネットワーク通信先を先に提示させます。
承認後に依存関係を導入し、
python -m pytest、Ruff、mypyなど既存の品質チェックを実行します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
Python 3.12の仮想環境を前提に、URLのtitle要素を取得する小さなCLIを設計してください。
依存追加前に、標準ライブラリだけで可能か比較してください。
外部通信先はexample.comだけとし、タイムアウト、HTTPエラー、文字コードを扱ってください。
承認するまでファイル編集とパッケージ導入は行わないでください。注意点・よくあるエラーと対処法
PEP 8への全面自動変換とDocstring一括追加は、公開APIや意味を変える可能性があります。
macOSとLinuxでは.venv/bin/python、Windowsでは.venv\Scripts\python.exeとなります。
requirements.txtを勝手に上書きせず、ロックファイルとCIの再現性を確認してください。