CLAUDECODE /goalコマンド活用で非エンジニアがデータ分析を始める方法

Claude Code /goal コマンドは、Claude Code に達成条件（ゴール）を自然言語で指定します。条件が満たされるまで、Claude が自律的にターンをまたいで作業を継続させる仕組みです (XDA Developers)。各ターン終了後には、別モデルが進捗を評価し、ゴールの達成を確認するまでループが続きます。「すべてのテストをパスさせる」や「TypeScript エラーをゼロにする」といった検証可能な条件を設定するのがポイントです。

具体的には、コードのリファクタリングやテスト自動実行、仕様書生成、コードレビューといったソフトウェア開発タスクに適しています。GitHub Actions と組み合わせれば、PR のたびにコードレビューや仕様書生成を自動実行するワークフローも構築可能です。達成条件を一度設定すれば、途中で何度もプロンプトを送り直す必要がなくなり、長時間の自律的な作業が実現します。

また、claude -p "/goal ..." の形式で非インタラクティブモードとして使うことで、ループを一度の呼び出しで完結させることもできます。実行中は経過時間やターン数、トークン使用量がオーバーレイ表示されるため、処理状況をリアルタイムに把握できます。

利用するには、Anthropic のサブスクリプションプランと基本的な設定が必要です。特にコーディング経験のある開発者が最大限に活用できるツールです。

この例では、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 は、定義した達成条件が検証可能であれば、様々な開発タスクに応用できます。読者の皆さんも、まずは手元のリポジトリで「すべてのテストをパス」といったシンプルな条件から試してみてください。自動化の新しいアプローチが見えてきます。

- XDA Developers「Claude Code's /goal command finally makes 'agentic' mean something」 - Anthropic Help Center「Use the Claude Agent SDK with your Claude plan」 - Infracost「We cut Claude's token usage 79% by redesigning our CLI for agents」