23
10

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

ちょっと見ない間にClaude APIが進化してた!

23
Posted at

ClaudeのAPI、ただモデル呼び出すだけでしょと思ってたんですが、どんどん進化してました!

環境

Pythonのプロジェクトを作成し、Anthropicの公式SDKをインストールします。

uv init app --python 3.13 --no-package
cd app
uv add anthropic

APIキーを使わない認証方法を使いたいので、antコマンドをインストールします。

mise use github:anthropics/anthropic-cli

ログインします。

ant auth login

基本の呼び出し

まず一番シンプルな呼び出しです。ここまでは私も知ってました。

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "こんにちは"}],
)

print(next(b.text for b in response.content if b.type == "text"))

思考ブロックが来ることがあるので、print文がちょっと複雑な感じです

実行結果

こんにちは!今日はどのようなことでお手伝いできますか?

基本の呼び出し with システムプロンプト

システムプロンプトを加えるとこうですね。

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=1024,
    system="あなたは関西弁で話す陽気なアシスタントです。",
    messages=[{"role": "user", "content": "こんにちは"}],
)

print(next(b.text for b in response.content if b.type == "text"))

実行結果

こんにちは!ええ天気やなあ、今日もなんでも聞いてや!

何かお手伝いできることあったら、気軽に言うてな。

システムプロンプトを途中で追記する

ここからが未知の領域です!

まず、システムプロンプトを途中に追記できます。

  • 1リクエスト目
    • システム:あなたは親切なアシスタントです
    • ユーザー:朝ごはん教えて
  • 2リクエスト目
    • ユーザー:昼ごはんは?
    • システム:(1リクエスト目に加え)ここからは英語で答えてね

追加するシステムプロンプトは、ユーザープロンプトの後に配置する必要があります。

これにより、プロンプトキャッシュを維持したままシステムプロンプトを変更できます!

import anthropic

client = anthropic.Anthropic()
MODEL = "claude-haiku-5-5"


messages = [{"role": "user", "content": "おすすめの朝ごはんを教えて"}]

first = client.messages.create(
    model=MODEL,
    max_tokens=1024,
    system="あなたは親切なアシスタントです。",
    messages=messages,
)
print("【1ターン目】")
print(next(b.text for b in first.content if b.type == "text"))

# assistant の返答を履歴に積み、次のユーザー発言と「途中追加の system」を足す
messages.append({"role": "assistant", "content": first.content})
messages.append({"role": "user", "content": "じゃあ昼ごはんは?"})
messages.append(
    {
        "role": "system",
        "content": "ここからは必ず英語で、2文以内で答えてください。",
    }
)

second = client.messages.create(
    model=MODEL,
    max_tokens=1024,
    system="あなたは親切なアシスタントです。",  # 1ターン目と同一(変えない)
    messages=messages,
)
print("【2ターン目(途中で system を追加)】")
print(next(b.text for b in second.content if b.type == "text"))

実行結果

【1ターン目】
朝ごはんのおすすめをいくつかご紹介します。

(中略)

今日の気分や時間、好みの味(和食・洋食など)を教えてもらえれば、もっと絞ったレシピもご提案できます。
【2ターン目(途中で system を追加)】
For lunch, try a chicken teriyaki rice bowl with steamed vegetables, which is filling and easy to prepare. If you want something lighter, a salmon and avocado salad with a sesame dressing is a refreshing choice.

ツール定義を途中で追記する

システムプロンプトだけじゃなくて、ツールも途中で追加できます!

投稿時点で、ベータ機能です。inline-tools-2026-09-15の指定が必要です。

途中で差し込むシステムプロンプトの一部として、追加します。

  • 1リクエスト目
    • GET_WEATHERツールのみ
  • 2リクエスト目
    • GET_TIMEツールを追加
(抜粋)
messages.append(
    {
        "role": "system",
        "content": [
            {
                "type": "tool_addition",
                "tool": {"type": "tool_definition", "definition": GET_TIME},
            }
        ],
    }
)

これにより、プロンプトキャッシュを維持したままツールを追加できます!

ツールを外す"type": "tool_removal",もあります


import json
from datetime import datetime

import anthropic

client = anthropic.Anthropic()
MODEL = "claude-haiku-5-5"
BETAS = ["inline-tools-2026-09-15"]

GET_WEATHER = {
    "name": "get_weather",
    "description": "都市の現在の天気を返す",
    "input_schema": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"],
    },
}
GET_TIME = {
    "name": "get_time",
    "description": "現在の日時を返す",
    "input_schema": {"type": "object", "properties": {}},
}


def run_tool(name: str, args: dict) -> str:
    if name == "get_weather":
        return f"{args['city']}: 晴れ、18度"
    if name == "get_time":
        return datetime.now().isoformat(timespec="minutes")
    return "unknown tool"


def ask(messages: list) -> None:
    """tool_use が続く限りループして、最終テキストを表示する。"""
    while True:
        response = client.beta.messages.create(
            model=MODEL,
            max_tokens=2048,
            betas=BETAS,
            tools=[GET_WEATHER],  # 最初から最後まで get_weather だけ(書き換えない)
            messages=messages,
        )
        messages.append({"role": "assistant", "content": response.content})

        tool_uses = [b for b in response.content if b.type == "tool_use"]
        if not tool_uses:
            print(next(b.text for b in response.content if b.type == "text"))
            return
        for b in tool_uses:
            print(f"  [tool_use] {b.name}({json.dumps(b.input, ensure_ascii=False)})")
        messages.append(
            {
                "role": "user",
                "content": [
                    {
                        "type": "tool_result",
                        "tool_use_id": b.id,
                        "content": run_tool(b.name, b.input),
                    }
                    for b in tool_uses
                ],
            }
        )


messages = [{"role": "user", "content": "東京の天気は?"}]
print("【1ターン目: get_weather だけ使える】")
ask(messages)

# 途中で get_time を追加。tools[] は触らず、system メッセージで定義ごと渡す
messages.append({"role": "user", "content": "今何時? あと東京の天気ももう一度"})
messages.append(
    {
        "role": "system",
        "content": [
            {
                "type": "tool_addition",
                "tool": {"type": "tool_definition", "definition": GET_TIME},
            }
        ],
    }
)
print("【2ターン目: get_time を途中で追加】")
ask(messages)

実行結果

【1ターン目: get_weather だけ使える】
  [tool_use] get_weather({"city": "東京"})
東京の現在の天気は晴れで、気温は18度です。
【2ターン目: get_time を途中で追加】
  [tool_use] get_time({})
  [tool_use] get_weather({"city": "東京"})
今の時刻は2026年11月14日 14時11分です。

東京の天気は、もう一度確認しても晴れで、気温は18度でした。

思考レベル(effort)を途中で変更する

モデルの思考レベルも途中で変更できます。これもシステムプロンプトを差し込む仕組みです。

投稿時点で、ベータ機能です。mid-conversation-output-config-2026-07-01の指定が必要です。

(抜粋)
messages.append(
    {"role": "system", 
     "content": [], 
     "output_config": {"effort": "low"}
    }
)

変更した後はずっとその変更が有効になるので、再度変更したい場合は、もう一度システムプロンプトとして差し込みます。

これにより、プロンプトキャッシュを維持したままEffortを変更できます!

import anthropic

client = anthropic.Anthropic()
MODEL = "claude-haiku-5-5"
BETAS = ["mid-conversation-output-config-2026-07-01"]

QUESTIONS = [
    "4桁の数のうち、各桁の数字がすべて異なり、かつ千の位が百の位より大きい数は全部でいくつ?",
    "1から100までの整数のうち、3でも5でも割り切れない数は全部でいくつ?",
    "5人が円卓に座る並び方(回転して同じになるものは同一視)のうち、特定の2人が隣り合う並び方はいくつ?",
]


def effort(level: str) -> dict:
    return {"role": "system", "content": [], "output_config": {"effort": level}}


def turn(label: str, messages: list) -> None:
    response = client.beta.messages.create(
        model=MODEL,
        max_tokens=16000,
        betas=BETAS,
        output_config={"effort": "high"},  # リクエスト全体の指定は変えない
        messages=messages,
    )
    messages.append({"role": "assistant", "content": response.content})
    thinking_tokens = response.usage.output_tokens_details.thinking_tokens
    print(f"【{label}】thinking_tokens={thinking_tokens}")


messages = [{"role": "user", "content": QUESTIONS[0]}]
turn("1ターン目: high(元の指定)", messages)

messages += [effort("low"), {"role": "user", "content": QUESTIONS[1]}]
turn("2ターン目: low に変更", messages)

messages += [effort("high"), {"role": "user", "content": QUESTIONS[2]}]
turn("3ターン目: high に戻す", messages)

実行結果(思考の量だけ出力してます)

【1ターン目: high(元の指定)】thinking_tokens=465
【2ターン目: low に変更】thinking_tokens=0
【3ターン目: high に戻す】thinking_tokens=169

1ターンだけ有効なシステムプロンプトを差し込む

最後はなかなかマニアックな仕組みで、一時的に有効になるシステムプロンプトを差し込む方法です。

  • 1~4ターン目
    • 通常のシステムプロンプト「返答ごとに、日本語・英語・フランス語・スペイン語・ドイツ語のどれかをランダムに選び、その言語だけで、1文であいさつしてください。」
  • 5ターン目
    • ここだけ有効なシステムプロンプト「絶対にフランス語であいさつしてください。」
  • 6ターン目
    • 2ターン目で足したものは有効にならず、1ターン目の状態に戻る

clear_atにnext_user_messageを指定してシステムプロンプトを差し込みます。(未指定時はデフォルト値(never)で、ずっと適用扱いになります)

投稿時点で、ベータ機能です。mid-conversation-system-clear-at-2026-08-21の指定が必要です。(思考レベル(effort)変更のときに指定したmid-conversation-output-config-2026-07-01とは微妙に値が異なります)

抜粋
{
    "role": "system",
    "clear_at": "next_user_message",
    "content": "絶対にフランス語であいさつしてください。",
}
import anthropic

client = anthropic.Anthropic()
MODEL = "claude-haiku-5-5"
BETAS = ["mid-conversation-system-clear-at-2026-08-21"]

SYSTEM = (
    "返答ごとに、日本語・英語・フランス語・スペイン語・ドイツ語のどれかをランダムに選び、"
    "その言語だけで、1文であいさつしてください。"
)

# 5回目だけ差し込む、1ターン限定の system メッセージ
NOTICE = {
    "role": "system",
    "clear_at": "next_user_message",
    "content": "絶対にフランス語であいさつしてください。",
}

messages = []
for turn in range(1, 7):
    messages.append({"role": "user", "content": "こんにちは!"})
    if turn == 5:
        messages.append(NOTICE)
    response = client.beta.messages.create(
        model=MODEL,
        max_tokens=1024,
        betas=BETAS,
        system=SYSTEM,
        messages=messages,
    )
    text = next(b.text for b in response.content if b.type == "text")
    # 思考ブロックは履歴に積まず、テキストだけ積む
    messages.append({"role": "assistant", "content": text})
    print(f"{turn}回目{'(フランス語に固定)' if turn == 5 else ''}: {text}")

実行結果

1回目: Bonjour, ravi de vous rencontrer aujourd'hui !
2回目: Hola, ¡qué gusto saludarte! ¿En qué puedo ayudarte hoy?
3回目: Guten Tag, schön, dass Sie heute da sind!
4回目: Hello, nice to see you today!
5回目(フランス語に固定): Bonjour, ravi de vous revoir !
6回目: Good morning, hope your day is off to a wonderful start!

まとめ

APIの進化、それはプロンプトキャッシュとの戦い

23
10
1

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
23
10

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?