【Python × Claude API】非エンジニアでもできる！Claude を使った自動要約ツールの作り方
はじめに
最近、AI ツールの進化がすごいですよね。ChatGPT、Gemini、そして Claude——毎日のように新しい機能が追加されています。
私は普段 Claude をブラウザで使っていますが、ある日ふと思いました。
「これ、Python から API で呼び出せば、もっと便利に使えるのでは？」
そこで今回は、Python + Claude API を使ってテキスト自動要約ツールを作ってみました。初心者でも 10 分で動かせる内容にまとめたので、ぜひ試してみてください。
対象読者
- Python の基本的な文法がわかる方
- Claude API を触ったことがない方
- AI を使った自動化に興味がある方
完成イメージ
$ python summarize.py input.txt
📝 要約結果:
この記事は、Pythonを使ったWebスクレイピングの基本的な手法について
解説しています。主にrequestsとBeautifulSoupの使い方を...
長い文章を渡すと、Claude が自動で要約してくれるシンプルなツールです。
環境構築
必要なもの
| 項目 | バージョン |
|---|---|
| Python | 3.9 以上 |
| anthropic（Python SDK） | 最新版 |
API キーの取得
- Anthropic Console にアクセス
- アカウントを作成（またはログイン）
- 「API Keys」から新しいキーを発行
- キーをコピーして保存（⚠️ 一度しか表示されません）
インストール
pip install anthropic
コードの全体像
import anthropic
import sys
def summarize_text(text: str) -> str:
"""Claude API を使ってテキストを要約する"""
client = anthropic.Anthropic(
api_key="YOUR_API_KEY" # ← ここにAPIキーを入れる（本番では環境変数推奨）
)
message = client.messages.create(
model="claude-sonnet-4-20250514",
max_tokens=1024,
messages=[
{
"role": "user",
"content": f"以下のテキストを日本語で300文字以内に要約してください。\n\n{text}",
}
],
)
return message.content[0].text
def main():
# コマンドライン引数からファイルを読み込む
if len(sys.argv) < 2:
print("使い方: python summarize.py <ファイル名>")
sys.exit(1)
filepath = sys.argv[1]
with open(filepath, "r", encoding="utf-8") as f:
text = f.read()
print("⏳ Claude に要約を依頼中...")
result = summarize_text(text)
print(f"\n📝 要約結果:\n{result}")
if __name__ == "__main__":
main()
コードのポイント解説
1. クライアントの初期化
client = anthropic.Anthropic(api_key="YOUR_API_KEY")
本番環境では、API キーをコードに直書きせず、環境変数から読み込むのがベストプラクティスです。
export ANTHROPIC_API_KEY="sk-ant-xxxxx"
# 環境変数から自動で読み込まれる
client = anthropic.Anthropic()
2. モデルの選択
model="claude-sonnet-4-20250514"
Claude には複数のモデルがあります。
| モデル | 特徴 | 用途 |
|---|---|---|
| claude-opus-4-6 | 最高性能・高コスト | 複雑な分析・創作 |
| claude-sonnet-4-6 | バランス型 | 一般的なタスク |
| claude-haiku-4-5 | 高速・低コスト | 軽量タスク・大量処理 |
今回のような要約タスクなら Sonnet で十分です。
3. プロンプトの工夫
content=f"以下のテキストを日本語で300文字以内に要約してください。\n\n{text}"
プロンプトのコツ：
- 言語を指定する（「日本語で」）→ 入力が英語でも日本語で返してくれる
- 文字数を指定する（「300文字以内」）→ 出力の長さをコントロール
- 具体的に指示する → 曖昧な指示だと出力もブレる
応用：もっと便利にする
箇条書きモードを追加
def summarize_text(text: str, bullet: bool = False) -> str:
if bullet:
prompt = f"以下のテキストの要点を5つの箇条書きにまとめてください。\n\n{text}"
else:
prompt = f"以下のテキストを日本語で300文字以内に要約してください。\n\n{text}"
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-sonnet-4-20250514",
max_tokens=1024,
messages=[{"role": "user", "content": prompt}],
)
return message.content[0].text
複数ファイルの一括処理
import glob
files = glob.glob("articles/*.txt")
for filepath in files:
with open(filepath, "r", encoding="utf-8") as f:
text = f.read()
result = summarize_text(text)
print(f"📄 {filepath}\n{result}\n{'='*50}")
料金の目安
Claude API は従量課金です。Sonnet の場合：
- 入力: $3 / 100万トークン
- 出力: $15 / 100万トークン
日本語の場合、1文字 ≒ 1〜2トークン程度です。1,000文字の記事を要約すると、1回あたり約 0.01ドル（約1.5円） 程度なので、個人利用なら非常にリーズナブルです。
ハマりやすいポイント
❌ AuthenticationError が出る
→ API キーが間違っている、または期限切れ。Console で再発行してください。
❌ RateLimitError が出る
→ 短時間にリクエストを送りすぎ。time.sleep(1) を入れて間隔を空けましょう。
❌ 長いテキストでエラーになる
→ モデルの入力上限を超えている可能性があります。テキストを分割して送りましょう。
# テキストを分割する簡易的な方法
def chunk_text(text: str, max_chars: int = 10000) -> list[str]:
return [text[i:i+max_chars] for i in range(0, len(text), max_chars)]
まとめ
今回は Python × Claude API で自動要約ツールを作りました。
- ✅
anthropicライブラリで簡単に API を呼び出せる - ✅ プロンプトの書き方次第で出力を柔軟にコントロールできる
- ✅ 料金も安く、個人開発で気軽に試せる
Claude API は要約以外にも、翻訳・コード生成・データ抽出など、さまざまなタスクに使えます。ぜひ自分なりのツールを作ってみてください！
参考リンク
もし参考になれば、X でもAI活用の tips を発信しています → @你的帐号