CLAUDECODE /goalコマンドでできること
Claude Code /goal コマンドは、Claude Code に達成条件（ゴール）を自然言語で指定します。条件が満たされるまで、Claude が自律的にターンをまたいで作業を継続させる仕組みです (XDA Developers)。各ターン終了後には、別モデルが進捗を評価し、ゴールの達成を確認するまでループが続きます。「すべてのテストをパスさせる」や「TypeScript エラーをゼロにする」といった検証可能な条件を設定するのがポイントです。
具体的には、コードのリファクタリングやテスト自動実行、仕様書生成、コードレビューといったソフトウェア開発タスクに適しています。GitHub Actions と組み合わせれば、PR のたびにコードレビューや仕様書生成を自動実行するワークフローも構築可能です。達成条件を一度設定すれば、途中で何度もプロンプトを送り直す必要がなくなり、長時間の自律的な作業が実現します。
また、claude -p "/goal ..." の形式で非インタラクティブモードとして使うことで、ループを一度の呼び出しで完結させることもできます。実行中は経過時間やターン数、トークン使用量がオーバーレイ表示されるため、処理状況をリアルタイムに把握できます。
利用するには、Anthropic のサブスクリプションプランと基本的な設定が必要です。特にコーディング経験のある開発者が最大限に活用できるツールです。
実践: 定期レポート自動生成をClaudeで自動化する
この例では、Claude Codeを用いて社内KPIのスプレッドシートを毎朝取得し、AIが要約を作成してメールで配信するプロセスを自動化します。これにより、毎日のレポート作成業務が効率化されます。
1. **APIキーの設定**
まず、Claude APIを使用するために必要なAPIキーを設定します。環境変数にANTHROPIC_API_KEYを設定します。
export ANTHROPIC_API_KEY="your_api_key_here"これにより、Claudeにアクセスするための認証情報が設定されます。
2. **スプレッドシートの取得と要約生成**
claude -pコマンドを使用して、スプレッドシートデータを取得し、AIによる要約を生成します。以下のコマンドを実行します。
claude -p --bare --settings "fetch_kpi_data_and_summarize"このコマンドは、設定されたスクリプトを実行し、スプレッドシートからデータを取得して要約を生成します。
3. **要約のメール配信** 要約が生成されたら、それをメールで配信します。GitHub Actionsを使ってこのプロセスを自動化します。以下はGitHub Actionsの設定例です。
name: KPI Report Automation
schedule:
- cron: "0 8 * * *"
s:
build:
runs-on: ubuntu-latest
ps:
- name: Checkout repository
uses: actions/checkout@v2
ame: Run Claude script
run: |
claude -p --bare --settings "fetch_kpi_data_and_summarize"
ame: Send Email
run: |
# ここでメール送信スクリプトを実行します
./send_email.shこの設定により、毎朝8時にスクリプトが実行され、要約が生成されてメールで配信されます。
このプロセスを通じて、社内KPIの定期レポートを自動化し、効率的に情報を共有することが可能になります。
つまずきやすいポイントとその回避策
Claude Code /goal コマンドを使う際、特にクレジット管理や自動化処理の停止リスクが課題です。これらの問題を未然に防ぐことが、スムーズな業務自動化の鍵となります。2026年6月15日から施行された新しいクレジット制度により、Claude Agent SDKと claude -p の使用は、従来のプラン使用制限にカウントされなくなりました (Anthropic Help Center)。この変更は、特定の業務で自動化を進めるための助けとなります。
まず、クレジット管理の問題です。有料プランのユーザーには、サブスクリプション月額と同額のAgent SDKクレジットが付与されます。Pro プランでは月 20ドル、Max 5x プランでは月 100ドル、Max 20x プランでは月 200ドルのクレジットが利用可能です。しかし、これらのクレジットは個人単位で付与され、チーム全体での共有や合算はできません。チームで CI/CD（継続的インテグレーション/デリバリー）を回す際には、各メンバーのクレジット消費を個別に管理する必要があります。この管理の複雑さが、導入初期の大きなハードルとなることがあります。
クレジット管理が複雑さを増すと、業務の効率化が阻害される。
次に、自動化処理の停止リスクです。クレジットを使い切ると、追加請求（usage credits）を明示的に有効にしない限り、自動化処理は月末まで完全に停止します。このため、計画的にクレジットを消費することが欠かせません。例えば、GitHub Actionsと組み合わせて PR のたびにコードレビューや仕様書生成を自動実行する際には、クレジットの消費状況を常にモニタリングし、必要に応じて手動で処理を行う準備が必要です。
また、クレジットの未使用分は翌月に繰り越されないため、月末に余っても無駄になります。月初から計画的にクレジットを消費し、余裕を持って業務を進める必要があります。月初に大きなバッチ処理を行い、月末に向けて小規模な処理を行うスケジュールが考えられます。
さらに、サードパーティ製エージェントを利用する場合、トークン効率が低いとクレジットが急速に消耗するリスクがあります。これは、特にエージェントループを多用する業務において顕著です。Infracost の事例では、CLIを再設計することでトークン使用量を最大 79%、API 費用を最大 67% 削減したと報告されています (Infracost ブログ)。工夫次第でクレジット枯渇リスクを具体的に減らせます。
これらの課題をクリアすることで、Claude Code /goal コマンドを使った作業自動化がよりスムーズになります。
他業務への応用例
ソフトウェア開発の現場で、CLAUDE CODE /goal コマンドがどのように役立つかを具体的に見ていきましょう。例えば、コードのリファクタリングでは「すべての関数に JSDoc コメントを付け、1 関数 40 行以内に収める」という条件を設定します。そうすれば、Claude Code が条件を満たすまで自律的に修正を繰り返すのです。テスト駆動開発では「test/auth のすべてのテストが通り、lint が clean であること」といった明確な達成条件を設定することで、人手を介さずに品質基準を満たせます。
CI/CD パイプラインとの連携でも、CLAUDE CODE /goal は実践的な場面で力を発揮します。GitHub Actions と組み合わせることで、PR のたびにコードレビューや仕様書生成を自動実行できます。長時間にわたる処理でも、ターン数や経過時間をオーバーレイで確認しながら進捗を把握できます。さらに、リモートコントロールモードを使えば、複数の開発者がゴール追跡エージェントを共有する協働環境を構築できます。
元記事に記載されていた「有償化廃止により機能が広く利用可能になった」という説明は、実際の変更内容（Agent SDK 利用の課金分離と別建てクレジット制度の導入）と異なるため削除しました。また、「作業時間を最大 30% 短縮」という数値は裏付けが確認できなかったため、削除しています。
CLAUDE CODE /goal は、定義した達成条件が検証可能であれば、様々な開発タスクに応用できます。読者の皆さんも、まずは手元のリポジトリで「すべてのテストをパス」といったシンプルな条件から試してみてください。自動化の新しいアプローチが見えてきます。
