🤖

月当たり$5でClaudeにコードレビューしてもらおう

に公開

あらまし

私「個人開発のコードをレビューしてもらって学習品質を高めていきたいなぁ」

AIくん「最近なら個人開発でも俺たちがコードレビューしてやるで」

私「昔にCodeRabbitってのを使ったことあったな......え、月に$24もかかるんか。これはチーム開発向けやな」

MCPくん「ClaudeCodeなりCursorなりにGitHubのMCP入れたらできるで」

私「せやなー。月に$20やからCodeRabbitくんよりは安上がりやなぁ。でも個人開発は出来る限り自分でプログラミングしたいからちょっと勿体無い感もあるなぁ」

Claudeくん「API Token買ってくれたら、Claude Code GitHub Actionsでコードレビューしたるで」

私「良さげやな。おーいClaude、プログラミングしようぜ。お前レビュアーな」

そんなわけで、Claude Code GitHub Actionsの紹介です

Claude Code GitHub Actionsとは

まさに文字通り、GitHub ActionsでClaude Codeくんを召喚できるものです
今までターミナル等でClaude Codeを使って行なっていたことを、GitHub Actions で実行できます
今回はコードレビューをしてもらいます

Claude Code GitHub Actionsの導入

すでにClaude Codeを使っている人はこちらの方法で簡単にできるみたいです

ただ、今回は$5/monthでコードレビューしてもらいたいので、Claude Codeを使っていない前提で手動セットアップを進めます

  1. Claude GitHubアプリをリポジトリにインストールしてあげる
  2. ClaudeでAPI Tokenを購入する
    1. この際、最低でも$5の購入を求められる。
    2. Token不足時の追加自動購入等はお好みでどうぞ(私はしていないです)
    3. 取得したAPIKeyは必要になるのでどこかにコピペ等しておく
  3. Claudeにコードレビューさせたいリポジトリのシークレットに、2で取得したAPIKeyを追加する
    1. リポジトリのsettings > Security > Secrets and Variables > Actionsに入ると、Repository Secretsがある。New repository secretボタンからAPIKeyを追加する
    2. 公式のドキュメントはこちら
  4. リポジトリに.github/workflows/claude.ymlを作成し、こちらのコードをコピペしてpushする。リポジトリのデフォルトブランチにこの差分をマージする。

上記が完了すればClaude Code GitHub Actionsを動かすことができます。

動作確認

  1. 適当なPRを作成する

  2. PRのレビューコメント or インラインコメントで @claude を使ってClaudeくんを呼び出す。

     @claude
     この差分のレビューをしてよ
    

使い勝手を良くするためのカスタマイズやTips

CLAUDE.mdの作成

リポジトリ内にCLAUDE.mdを作成して、コードレビューに関する共通プロンプトを作っておきましょう

Claudeの呼び出しはコメントのみで行う

インラインコメントでの呼び出しも可能ですが、複数箇所で@claudeを使うとAPITokenの消費量が呼び出し回数分増えていきます
上述のようなCLAUDE.mdの設定をしておくとPRの差分全体に対してコードレビューをしてくれるので、コメントとして一度だけ呼び出すと良いです
重点的にレビューしてもらいたい箇所がある場合は、呼び出し時にその旨を書きましょう

@claude
このコードのレビューをしてください。
認証認可の実装は初めてなので、セキュリティリスクの懸念箇所がないかを重点的にレビューしてください

GitHubのコメントの文字数制限に対応する

GitHubのコメントには文字数(65536文字)制限があります
これを超過するとエラーになるので、CLAUDE.mdのプロンプトで調整して、コメントを分けてもらいましょう

## コードレビューに関する注意事項

- GitHub APIの制限で65,536文字を超えるレビューコメントはできないようです
  - この問題への対応として、レビューコメントの分割やinlineコメントを活用してください

また、inlineコメントができるようにワークフローも調整しましょう

claude_args: |
   --allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*)"

Claudeとのやりとり回数の制限を緩和する

PRの規模やレビューによっては、設定された制限内でレビュータスクを完了できないことがあります

{
"type": "result",
"subtype": "error_max_turns",
"is_error": false,
"duration_ms": 99447,
"num_turns": 10,
"total_cost_usd": 0.19023445,
"permission_denials": []
}
Log saved to /home/runner/work/_temp/claude-execution-output.json
Error: Execution failed:
Error: Process completed with exit code 1.

制限はデフォルトだと10ターンとなっているので、ワークフローを編集して変更してあげましょう

claude_args: |
   --max-turns 50

実際の費用感

参考レベルですが、実際の費用感は以下の通りです:

  • デフォルトの設定:一回あたり$0.2~0.3ぐらい
  • 私が色々と設定を加えた結果:$0.4~$0.5ぐらい

費用が増える要因としては

  • @claudeでの呼び出しが多い
  • max-turnを多くしていてやり取りの回数が増えている

の2点がありました

前者に関しては呼び出し回数を絞ることで対応可能
後者に関してはプロンプトの最適化で費用を抑えられそうです

一度のコードレビューを$0.5と仮定しても$5で10回はコードレビューしてもらえる => 個人開発なら十分耐えられる範囲かなと思っています

閾値として、$20を超えるなら大人しくClaude CodeかCursorあたりを使うのがおすすめとなってきます

おまけ(私の設定例)

  • .github/workflows/claude.ymlの設定

     name: Claude Code
    
     on:
     pull_request_review_comment:
         types: [created]
     pull_request_review:
         types: [submitted]
    
     jobs:
       claude:
         if: |
           (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
           (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude'))
         runs-on: ubuntu-latest
         permissions:
           contents: write
           pull-requests: write
           id-token: write
           actions: read # Required for Claude to read CI results on PRs
         steps:
           - name: Checkout repository
             uses: actions/checkout@v5
             with:
               fetch-depth: 1
    
           - name: Run Claude Code
             id: claude
             uses: anthropics/claude-code-action@v1
             with:
               anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
               claude_args: |
                 --max-turns 50
                 --model claude-sonnet-4-5
                 --allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*)"
    
  • CLAUDE.mdの設定

    # プロジェクト概要
    
    ## 目的
    
    1. Next.jsフロントエンド開発のサンドボックス
    2. 個人オウンドメディアとしての運用
    3. AI依存からの脱却と純粋なプログラミングの実践
    
    **重要**: サンドボックスとしての性質上、実用性よりも学習目的の実装が含まれる場合があります。
    
    ## 技術スタック
    
    - Next.js + TypeScript
    - InstantDB(データベース)
    - Vercel(ホスティング)
    
    ## コードレビューに関する注意事項
    
    - GitHub APIの制限で65,536文字を超えるレビューコメントはできないようです
    - この問題への対応として、レビューコメントの分割やinlineコメントを活用してください
    
    ## レビュー優先度
    
    ### 必須(Critical)
    
    - セキュリティ上の問題
    - 適切なエラーハンドリング
    - 重大なパフォーマンス問題
    
    ### 高(High)
    
    - アーキテクチャ構成と拡張性
    - TypeScriptの型安全性
    - 可読性・保守性
    
    ### 中(Medium)
    
    - 関数型プログラミングの実践
    - テスト可能性(Storybook/Jest対応)
    - データモデル設計
    
    ### 参考(Optional)
    
    - より良い実装パターンの提案
    - 最新のベストプラクティスの紹介
    
    ## InstantDB固有の注意事項
    
    - AGENTS.mdを参照してスキーマ設計をレビュー
    - リレーショナルDBとの違いを考慮した設計指針
    - InstantDBの制約や特性に基づいた実装評価
    
    **注**: AGENTS.mdは英語で記述されていますが、レビューは日本語で実施してください。
    
    ## レビュー出力フォーマット
    
    各レビューコメントには以下を含めてください:
    
    1. **優先度**: [Critical/High/Medium/Optional]
    2. **カテゴリ**:
       - セキュリティ(認証/認可/XSS/CSRF/データ保護)
       - アーキテクチャ(ディレクトリ構成/関心の分離/依存関係)
       - 可読性(命名/コメント/コード構造)
       - 型安全性(TypeScript型定義/型推論)
       - パフォーマンス(レンダリング/バンドルサイズ/データフェッチ)
       - エラーハンドリング(例外処理/バリデーション/ユーザーフィードバック)
       - テスタビリティ(テスト容易性/モック可能性)
       - データモデル(InstantDBスキーマ設計)
    3. **問題点**: 具体的な指摘
    4. **理由**: なぜ問題なのか
    5. **改善案**: 具体的なコード例を含む提案
    6. **参考資料**: 関連するドキュメントやベストプラクティス(あれば)
    
    **重要**: レビューをする上で以下の場合は、改善案の前に明示的に質問してください:
    
    - コードの意図や目的が不明確な場合
    - 複数の実装方針が考えられ、判断に追加情報が必要な場合
    - プロジェクト固有の規約や方針が不明な場合
    
    ## レビュー対象外
    
    以下は意図的な学習目的のため、レビュー対象外とします:
    
    - 過度なアニメーション実装
    - 実用性よりも実験性を優先した機能
    
Aprender Tech Blog

Discussion