LangChainを使ったaiエージェント開発をしていると、依存パッケージのバージョンアップにどう追従すべきか迷うことはありませんか？特に土台となるlangchain-coreは、Chain・Runnable・プロンプトテンプレートなど中核機能を提供しているため、アップデート内容を把握しないまま放置すると、非推奨警告（DeprecationWarning）に気づかずコードが古い設計のまま残ってしまいます。
この記事では、langchain-core==1.6.4のリリース内容を公式のリリースノートに基づいて整理し、アップグレード手順と実際の開発フローへの組み込み方まで解説します。
- langchain-core 1.6.4で何が変更されたか
- 安全にアップグレードする手順
- Claude CodeなどのAIコーディングツールと組み合わせた実践的な運用方法
- 類似ライブラリとの違い・注意点
なお、langchain-coreはMITライセンスで公開されているOSSのPythonライブラリです。GitHub上のlangchain-aiリポジトリで開発が進められています。
langchain-coreとは何か・1.6.4で何が変わったか
langchain-coreは、LangChainフレームワークの基盤パッケージです。LLM呼び出しの抽象化（Runnable）、プロンプトテンプレート、出力パーサー、メッセージ型など、LangChainエコシステム全体が依存するコア機能を提供します。対応環境はPython（pip配布）で、CLIツールというより開発時にimportして使うライブラリです。
GitHubのリリースページを実際に確認すると、langchain-aiリポジトリは2026年9月時点でスター数約14.7万（147k）、フォーク数約2.46万（24.6k）と記載されており、活発にメンテナンスされていることがうかがえます。
1.6.4はlangchain-core==1.6.3からの差分として、公式リリースノートに次の4件のコミットが明記されています。
release(core): 1.6.4 (#40718)— バージョンタグの更新chore(core): deprecate chat message history (#40711)— chat message history関連機能の非推奨化chore(deps): bump anyio from 4.12.0 to 4.14.2 in /libs/core (#40634)— 非同期処理ライブラリanyioの更新chore(deps): bump soupsieve from 2.8.4 to 2.9 in /libs/core (#40574)— HTMLパーサー関連依存のsoupsieve更新
実際にリリースページの内容をそのまま確認すると、機能追加ではなく依存関係の更新と非推奨化告知が中心の、いわゆるメンテナンスリリースであることが分かります。新機能を期待して見に行くと拍子抜けするかもしれませんが、これは裏を返せば破壊的変更のリスクが低い、安全にアップグレードしやすいバージョンだと言えます。
「chat message history」非推奨化について
公式のコミットタイトルにはdeprecate chat message historyとだけ記載されており、詳細な移行先クラス名までは本リリースノートには明記されていません。LangChainはこれまでも会話履歴の永続化について、単体のBaseChatMessageHistory系クラスから、LangGraphのチェックポイント（永続化）機構への移行を段階的に案内してきた経緯があります。今回の非推奨化もその流れの一環である可能性がありますが、断定はできないため、実際に該当機能を使っている場合は必ず公式ドキュメントで非推奨対象のクラス名と代替APIを確認してください。
インストール・アップグレード手順
新規インストールとアップグレードのコマンドは以下の通りです。既存プロジェクトでバージョンを固定している場合は、==1.6.4で明示的に指定できます。
新規インストール
pip install langchain-core==1.6.4既存環境のアップグレード
pip install --upgrade langchain-corerequirements.txt / pyproject.tomlでのバージョン固定
# requirements.txt
langchain-core==1.6.4インストール後の動作確認
python -c "import langchain_core; print(langchain_core.__version__)"公式のリリースアセット情報を確認すると、配布物はlangchain_core-1.6.4-py3-none-any.whl（559 KB）とlangchain_core-1.6.4.tar.gz（983 KB）の2種類で、それぞれSHA256ハッシュが公開されています。企業のサプライチェーンセキュリティ要件でハッシュ検証が必要な場合は、pip install --require-hashesと組み合わせて利用できます。
非推奨警告への対応（設定・カスタマイズ）
アップグレード後は、Pythonの警告フィルタで非推奨APIの使用箇所を洗い出すのがおすすめです。
python -W error::DeprecationWarning your_script.pyこれによりchat message history関連の非推奨警告が例外として発生するため、CIパイプラインに組み込んでおくと、将来のメジャーアップデートで機能が削除された際の影響範囲を事前に把握できます。
実用例：AIコーディングツールと組み合わせた開発フロー
langchain-coreのようなライブラリのアップデート追従は、AIコーディングアシスタントとの相性が良い作業です。ここではClaude Codeを使った実践例を紹介します。
Claude Codeのhooks機能を使うと、langchain-core関連ファイルを編集・保存したタイミングで自動的にpytestを実行し、非推奨警告やAPI変更による破壊的変更を即座に検知できます。プロジェクトルートのCLAUDE.mdに「langchain-coreは1.6.4系を使用し、chat message history系の非推奨APIは新規コードで使用しない」といったプロジェクト指示を記載しておけば、AIがコード生成時にその方針を踏まえた実装を提案してくれます。
また、複数ファイルにまたがるLangChainのChain定義をリファクタリングする際は、サブエージェントを使って「Runnable定義ファイル群」と「テストファイル群」を並列でレビューさせることで、非推奨API使用箇所の洗い出しと修正を効率化できます。スラッシュコマンドで「依存関係アップグレード後の互換性チェック」を定型化しておけば、今後のマイナーバージョンアップ時にも同じ手順を再利用可能です。
類似ライブラリとの比較
| ライブラリ名 | 対応環境 | ライセンス | 特徴 |
|---|---|---|---|
| langchain-core | Python | MIT | Runnable抽象化・プロンプトテンプレート・出力パーサー等、LangChainエコシステムの土台 |
| LlamaIndex Core | Python | MIT | RAG（検索拡張生成）特化。インデックス構築・検索パイプラインに強み |
| Semantic Kernel | Python / C# / Java | MIT | Microsoft製。エンタープライズ向けプラグイン機構とプランナー機能が特徴 |
| Haystack | Python | Apache-2.0 | deepset製。検索・QAパイプライン構築に特化したフレームワーク |
langchain-coreは対応言語の幅よりも、Runnableという統一インターフェースでChain・Agent・RAGパイプラインを柔軟に組み合わせられる点が特徴です。一方でLlamaIndexはRAG用途に特化して学習コストが低く、Semantic Kernelは.NET/Java環境との親和性が求められる企業システムで選ばれやすい傾向があります。用途とチームの技術スタックに応じて選定してください。
注意点・制約・セキュリティ
langchain-core自体は外部通信を行うライブラリではなく、LLM APIやツールとの接続部分（インテグレーションパッケージ）が実際の通信を担います。そのため、langchain-core単体のアップデートでデータ送信先が変わることはありません。ただし以下の点には注意してください。
- 依存パッケージの連鎖更新: anyio・soupsieveのバージョンが上がることで、これらに依存する他パッケージとのバージョン競合が発生する場合があります。仮想環境でのテスト実行を推奨します
- 非推奨API除去のタイミング: 今回の非推奨化告知だけでは、いつ該当機能が削除されるか明記されていません。将来のメジャーバージョンで削除される可能性があるため、早めの移行検討が安全です
- 惜しい点: リリースノート自体はコミットタイトルの一覧のみで、非推奨機能の詳細な移行ガイドへのリンクが同梱されていません。詳細は別途公式ドキュメントを参照する必要があります
FAQ
まとめ
langchain-core 1.6.4は、新機能追加ではなく依存関係の更新（anyio・soupsieve）とchat message history系機能の非推奨化告知が中心の、メンテナンス色の強いリリースです。要点は次の3つです。
- 破壊的な機能削除はまだ行われておらず、既存コードへの影響は限定的
chat message history関連の非推奨警告が出た場合は、公式ドキュメントで代替APIを確認してから移行する- アップグレードは
pip install --upgrade langchain-coreの1コマンドで完了し、その後-W error::DeprecationWarningで影響範囲をチェックするのが安全
より高度な会話履歴の永続化やエージェント設計を検討している場合は、LangChain公式ドキュメントのLangGraph関連セクションも合わせて確認することをおすすめします。
よくある質問（FAQ）
langchain-core 1.6.4へのアップグレードで既存コードが壊れますか？
公式リリースノートによると、今回は依存関係の更新（anyio・soupsieve）と非推奨化の告知が中心で、既存機能の削除は含まれていません。ただし非推奨警告が出た箇所は将来的に動作しなくなる可能性があるため、早めの対応を推奨します。
chat message historyが非推奨になったとありますが、何を使えばよいですか？
本リリースノートには具体的な移行先クラス名が明記されていません。会話履歴の永続化にはLangGraphのチェックポイント機構が案内される流れがありますが、正確な移行方法は公式ドキュメントで最新情報を確認してください。
langchain-coreだけインストールすればLangChainの全機能が使えますか？
いいえ。langchain-coreはRunnableやプロンプトテンプレートなど基盤機能のみを提供します。OpenAIやAnthropicなど各LLMプロバイダーとの接続には、langchain-openaiやlangchain-anthropicといった個別のインテグレーションパッケージが別途必要です。
ローカルLLM（Ollama等）でもlangchain-coreは動作しますか？
langchain-core自体はLLM抽象化レイヤーであるため、Ollama用のインテグレーションパッケージ（langchain-ollama等）と組み合わせることでローカルLLM環境でも利用できます。詳細は各インテグレーションパッケージの公式ドキュメントを確認してください。
旧バージョン（1.6.3以前）から直接1.6.4にアップグレードしても問題ないですか？
1.6.3から1.6.4への差分は依存関係更新と非推奨化告知のみのため、直接アップグレードして問題ありません。念のためテスト環境で一度動作確認することをおすすめします。
langchain-coreのセキュリティ脆弱性情報はどこで確認できますか？
GitHubリポジトリのSecurityタブやDependabotアラートで確認できます。本リリース自体にセキュリティ修正が含まれているかは、リリースノートに明記されていないため、別途GitHub Security Advisoriesを確認してください。
langchain-coreはどのPythonバージョンに対応していますか？
対応Pythonバージョンは公式リポジトリのpyproject.tomlに記載されています。本記事の参照情報には具体的なバージョン範囲の記載がないため、導入前に公式リポジトリで最新の対応バージョンを確認してください。
コメント