Repo-lab
AIツール

hao-code：PHPでAIコーディングエージェントを構築するOSSのSDK

⭐ 103 stars GitHub →

hao-code：PHPでAIコーディングエージェントを構築するOSSのSDK

hao-codeは、PHP 8.1以上のアプリケーションにAIコーディングエージェント機能を組み込むためのフレームワーク不要SDK（Composerパッケージ）です。Anthropic・OpenAI Responses・OpenAI Chat Completions互換APIに対応し、ストリーミング・マルチターンセッション・エージェントチーム・コスト追跡・サンドボックス実行など30以上のビルトインツールを提供します。

GitHubで急上昇中の hao-code をご紹介します。 スター数 103★ を獲得し、AI分野で注目されているツールです。

hao-code とは？

hao-codeは、PHPアプリケーションにAIコーディングエージェント機能を埋め込むための、フレームワーク不要のオープンソースSDKです。Composerパッケージ（sk-wang/hao-code）として公開されており、単なるHTTPラッパーではなく、30以上のビルトインツール・ストリーミング出力・マルチターンセッション・構造化JSON結果・エージェントチーム・コスト追跡・中断制御・クレデンシャルプールなど、本格的なAIエージェント機能をPHPで実現します。

Anthropic Claude・OpenAI Responses・OpenAI Chat Completions互換APIをすべてサポートし、Claude CodeやCodexに相当する機能をPHPネイティブで実装しています。CLAUDE_CODE_PARITY.mdという比較ドキュメントを持ち、Claude Codeとの機能対比を明示しています。

PHPはWebアプリケーション開発（WordPress・Laravel等）で依然として世界最大規模のシェアを持ちますが、AIエージェントSDKはPythonに偏重していました。hao-codeはこのギャップを埋め、既存PHPアプリケーションへのAIエージェント統合を容易にします。

こんな人におすすめ:

  • エンジニア向け: Laravel・Symfony・WordPress等のPHPプロジェクトでAIエージェント機能を実装したいバックエンドエンジニアが、既存インフラを変えずにClaude/OpenAI統合を実現できます
  • 非エンジニア向け: プログラミング知識が必要なため、エンジニア専用ツールです

主な機能・特徴

  • Anthropic・OpenAI全対応: Claude（Anthropic）・OpenAI Responses・OpenAI Chat Completions互換APIをサポート
  • 30以上のビルトインツール: ファイル操作・シェル実行・マルチターンセッション・コスト追跡・中断制御を標準装備
  • Tokimoサンドボックス: macOS（sandbox-exec）・Linux（bubblewrap/KVM）・Windowsに対応したネイティブサンドボックスで安全なコード実行を実現
  • エージェントチーム機能: 専門バックグラウンドエージェントが協調して共有目標に取り組む「チーム」を編成可能
  • Composerで1コマンドインストール: composer require sk-wang/hao-code だけで導入完了

使い方・始め方

インストール

composer require sk-wang/hao-code

Tokimoサンドボックス（安全なコード実行環境）も使う場合は以下を追加実行します：

vendor/bin/hao-code-sandbox install --with-runtime

クイックスタート

export ANTHROPIC_API_KEY=your-api-key

example.php を作成して実行します：

<?php
require __DIR__.'/vendor/autoload.php';

use HaoCode\Sdk\HaoCode;

$result = HaoCode::query('Reply with exactly: HaoCode works');
echo $result->text;

php example.php
# 出力: HaoCode works

マルチターンセッションの例

<?php
use HaoCode\Sdk\HaoCode;
use HaoCode\Sdk\HaoCodeConfig;

$config = new HaoCodeConfig(
    apiKey: getenv('ANTHROPIC_API_KEY') ?: '',
    permissionMode: 'auto',  // ツール実行を自動承認
);

$result = HaoCode::query(
    'Please analyze the current directory and list PHP files',
    config: $config
);

echo $result->text;
echo "Cost: $" . number_format($result->totalCost, 6);

設定ファイル

設定は ~/.haocode/settings.json（グローバル）と .haocode/settings.json（プロジェクト）から読み込まれます。APIキー・モデル・プロバイダーの設定がここで管理されます。

活用事例

PHPバックエンドエンジニアによるAIレビューシステムの構築

LaravelやSymfonyで構築されたエンタープライズWebアプリケーションに、コードレビュー自動化・ドキュメント生成・バグ分析などのAIエージェント機能を組み込む場面で活用できます。既存のPHPインフラを変えずにAnthropicやOpenAIのAPIを呼び出せるため、移行コストを最小化できます。

Webサービス開発者によるチャットボット・AI機能統合

WordPressプラグイン開発者やPHP製CMSの開発者が、AIチャットボット・コンテンツ生成・ユーザーサポート自動化などの機能を既存PHPアプリケーションに追加する場面で活用できます。エージェントチーム機能を使えば、コンテンツ生成・SEO最適化・校正を複数の専門エージェントが並列処理する仕組みも構築できます。

Pythonエコシステムとの違い・なぜ今このツールか

Python中心のAIエージェントエコシステムとの差別化

AIエージェントSDK（LangChain・CrewAI・AutoGen等）はほぼすべてPython専用です。PHPでAnthropicやOpenAIを利用するにはHTTPラッパーが主流でしたが、hao-codeはClaude CodeやCodexと同等の機能をPHPネイティブで実現する初めての本格SDKです。

比較観点 Python SDKs（LangChain等） hao-code
対象言語 Python専用 PHP 8.1以上
インストール pip install composer require
セッション永続化 ✅ ✅
サンドボックス実行 一部対応 macOS/Linux/Windows対応
Claude Code相当 LangChain等 CLAUDE_CODE_PARITY.md で対比

PHPはWordPress・Laravel・Symfony・Magento等で依然として世界最大のWebシェアを持ちます。企業のWebシステムがPHPで動いている中でAI機能を追加したい場合、Pythonサービスを別途構築せずにPHPだけで完結できるhao-codeの価値が際立ちます。

こんな人に向いている

PHPバックエンドエンジニア・フルスタックエンジニア

LaravelやSymfonyを使うPHPバックエンドエンジニアが、既存のPHPコードベースにAIエージェント機能を追加したい場面に最適です。Pythonの環境構築やマイクロサービス化なしに、composer require だけで本格AIエージェントを実装できます。

WordPressプラグイン・CMS開発者

WordPressのプラグインやテーマでAIコンテンツ生成・チャットボット・SEO最適化機能を提供したいCMS開発者にとって、PHPネイティブで動作するhao-codeは理想的な選択肢です。

エンタープライズシステム担当者

PHP製の社内システム・ERPに AI機能（文書処理・問い合わせ自動対応・データ分析）を追加したいエンタープライズ開発者が、既存のPHPインフラを維持しながらClaude/OpenAI統合を実現できます。

使う前に知っておきたいこと

PHP バージョン要件

PHP 8.1以上が必要です。PHP 7.xや古いPHP 8.0環境では動作しません。多くのレガシーシステム（WordPress旧バージョン等）はPHP 7.4での稼働が多く、PHP 8.1への移行が前提となります。

Tokimoサンドボックスのオプション要件

コード実行サンドボックス（Tokimo）はオプション機能で、以下の追加依存があります：

  • macOS: /usr/bin/sandbox-exec（macOS標準）
  • Linux: bubblewrap または KVM + cloud-hypervisor + virtiofsd
  • Windows: Windows Virtual Machine Platform

基本的なテキスト生成・API呼び出しにはサンドボックス不要です。

プロジェクト成熟度

コントリビューターは1名でスター数103と比較的小規模なプロジェクトです。公式リリース（バージョンタグ）のペースや長期サポートについては、Packagist（sk-wang/hao-code）の更新履歴を確認することを推奨します。

ライセンス

MITライセンスを採用しています。商用利用・改変・再配布はいずれも許可されています。

関連ツール・おすすめサービス

  • Perplexity AI — AIリサーチを強化するAIアシスタント。hao-codeを使ったAIエージェント開発の調査・設計フェーズで活用できます

まとめ

hao-codeは、PHPエコシステムに待望のAIエージェントSDKをもたらすオープンソースプロジェクトです。Anthropic Claude・OpenAI Responses・Chat Completions互換APIに対応し、30以上のビルトインツール・Tokimoサンドボックス・エージェントチーム機能を単一Composerパッケージで提供します。LaravelやWordPressなど既存のPHPプロジェクトにAI機能を追加したいエンジニアにとって、Pythonへの移行なしに本格AIエージェントを構築できる貴重なツールです。コントリビューターが1名と小規模なプロジェクトですが、包括的なドキュメントとClaude Code相当の機能実装は要注目です。

GitHub でチェックする →

この技術を学ぶ

AIに興味を持った方には、Udemyのオンラインコースもおすすめです。

毎日更新のGitHubツール情報

LINEで受け取って最新情報をキャッチアップしよう

友達追加する（無料）

関連記事

この記事が役に立ったらシェアしてください