メインコンテンツへスキップ
見出し画像
Photo byishi99

AIが勝手にコードを書いてくれる? Claude Code Actionで始める、Issues駆動プログラミング

    ※本記事はほぼ完全にClaudeさんにお願いして書いてもらったものです(追記部分はその後のClaudeさんとのやり取りの内容です)。
    後でも良いので、こちらのベストプラクティスは読んでおいた方が良いかも知れません: https://www.anthropic.com/engineering/claude-code-best-practices

    こんにちは!つい最近出た、プログラミングというかAIさんたちとの共同作業(確認や管理)がとても楽になるツールが発表されたので共有します。

    「コード書くの面倒くさい...」 「バグ修正に時間かかりすぎ...」 「そもそもGitHubの使い方がよくわからない...」

    そんな悩みを抱えているガチエンジニアではない独り開発者のあなたに朗報です!

    Claude Code Actionを使えば、GitHubのコメント欄で「@claude これ直して」と書くだけで、AIが勝手にコードを書いてくれるんです。本当に革命的。

    目次

    1. Claude Code Actionって何?

    2. どんなことができるの?

    3. 必要な準備

    4. 30分でできる!セットアップ手順

    5. 実際に使ってみよう

    6. よくあるトラブルと解決法

    7. 料金について

    8. まとめ

    9. 追記(Claude Code Action導入の有用性について聞いてみた)


    Claude Code Actionって何?

    一言で言うと、GitHubで動くAIアシスタントです。

    従来の開発:

    1. コード書く

    2. バグ見つける

    3. 直す

    4. また書く...(無限ループ)

    Claude Code Actionを使った開発:

    1. 「@claude ユーザー認証機能を追加して」

    2. AIがコード生成

    3. 完成!

    めちゃくちゃシンプルですね…

    エンジニアではない人にこそ使ってほしい理由

    • Git操作が苦手でもOK: ブランチ作成もコミットもAIがやってくれる

    • コードレビュー相手がいなくてもOK: AIが品質チェックしてくれる

    • 英語が苦手でもOK: 日本語で指示できる


    どんなことができるの?

    1. バグ修正

    @claude TypeError: Cannot read property 'name' of undefined というエラーが出ています。修正してください。
    

    → AIがエラーの原因を特定して修正コードを生成

    2. 新機能の実装

    @claude ダークモード切り替え機能を追加してください。LocalStorageで設定を保存するようにしてください。
    

    → 完全に動作するダークモード機能が追加される

    3. コードレビュー

    @claude このPull Requestのコードをレビューして、改善点があれば教えてください。
    

    → セキュリティ問題やパフォーマンスの改善点を指摘

    4. リファクタリング

    @claude この関数が長すぎるので、読みやすく分割してください。
    

    → きれいに整理されたコードに変換


    必要な準備

    まず、以下の3つが必要です:

    1. GitHubアカウント

    無料でOK!まだ持ってない方はGitHubで作成してください。

    2. リポジトリ

    自分のプロジェクトを置く場所です。まだない方は、GitHubで「New repository」ボタンを押して作りましょう。

    3. Claude APIキー

    これが一番重要!以下の手順で取得します:

    1. Anthropic Consoleにアクセス

    2. アカウントを作成(メールアドレスだけでOK)

    3. 「API Keys」をクリック

    4. 「Create Key」ボタンを押す

    5. 表示される「sk-ant-api03-...」みたいな文字列をコピー

    ⚠️ 重要: このAPIキーは絶対に他人に見せないでください!銀行の暗証番号みたいなものです。


    30分でできる!セットアップ手順

    ステップ1: GitHubアプリをインストール(5分)

    1. Claude GitHub Appにアクセス

    2. 「Install」ボタンをクリック

    3. 自分のアカウントを選択

    4. どのリポジトリで使うか選択(最初は「Selected repositories」で特定のリポジトリだけ選ぶのがおすすめ)

    5. 「Install」をクリック

    ステップ2: APIキーをGitHubに登録(10分)

    1. 自分のリポジトリページを開く

    2. 「Settings」タブをクリック(右上の方にあります)

    3. 左メニューから「Secrets and variables」→「Actions」を選択

    4. 「New repository secret」ボタンをクリック

    5. 以下を入力:

      • Name: ANTHROPIC_API_KEY(この名前は固定!)

      • Secret: さっきコピーしたAPIキー

    6. 「Add secret」をクリック

    ステップ3: ワークフローファイルを作成(15分)

    これが一番難しそうに見えるけど、コピペでOKです!

    1. リポジトリのトップページで「Add file」→「Create new file」をクリック

    2. ファイル名に .github/workflows/claude.yml と入力

    3. 以下の内容をコピペ:

    name: Claude Assistant
    
    on:
      issue_comment:
        types: [created]
      pull_request_review_comment:
        types: [created]
    
    permissions:
      contents: write
      issues: write
      pull-requests: write
    
    jobs:
      claude-response:
        runs-on: ubuntu-latest
        if: contains(github.event.comment.body, '@claude')
        steps:
          - uses: actions/checkout@v4
            with:
              fetch-depth: 0
    
          - name: Generate GitHub App token
            id: app-token
            uses: actions/create-github-app-token@v2
            with:
              app-id: ${{ secrets.APP_ID }}
              private-key: ${{ secrets.APP_PRIVATE_KEY }}
    
          - uses: anthropics/claude-code-action@beta
            with:
              anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
              github_token: ${{ steps.app-token.outputs.token }}
              allowed_tools: "Bash(git:*),View,Write,BatchTool,GlobTool,GrepTool"
              model: "claude-3-5-sonnet-20240620"
    
    1. 「Commit changes」をクリック

    おめでとうございます!セットアップ完了です🎉


    実際に使ってみよう

    最初のテスト: 簡単な質問

    1. リポジトリの「Issues」タブを開く

    2. 「New issue」をクリック

    3. タイトル:「テスト」

    4. 本文:

    @claude こんにちは!正常に動作していますか?このリポジトリについて教えてください。
    
    1. 「Submit new issue」をクリック

    30秒〜1分待つと、Claudeからの返信が来ます!

    実践例1: README.mdを作ってもらう

    @claude このプロジェクトのREADME.mdを作成してください。
    以下を含めてね:
    - プロジェクトの説明
    - インストール方法
    - 使い方
    - ライセンス(MITライセンス)
    

    実践例2: バグを直してもらう

    @claude 
    index.jsの15行目でエラーが出ています。
    TypeError: Cannot read property 'length' of undefined
    修正してください。
    

    実践例3: 機能を追加してもらう

    @claude 
    現在時刻を表示する機能を追加してください。
    - 1秒ごとに更新
    - 「YYYY/MM/DD HH:mm:ss」形式で表示
    - index.htmlに追加
    

    よくあるトラブルと解決法

    Q: @claudeって書いたのに反応しない

    A: 以下をチェック!

    1. claude.ymlファイルは正しく作成されていますか?

    2. APIキーは正しく設定されていますか?

    3. GitHub Appはインストールされていますか?

    4. 数分待ってみましたか?(初回は時間がかかることがあります)

    Q: 「API Error: 401」というエラーが出る

    A: APIキーの問題です

    • APIキーが正しくコピーされているか確認

    • Anthropic Consoleでクレジットが残っているか確認

    • 新しいAPIキーを作り直してみる

    Q: 「Rate limit exceeded」と言われた

    A: 使いすぎです

    • 少し時間を置いてから再度試す

    • より具体的な指示を出して、やり取りの回数を減らす

    Q: 日本語が文字化けする

    A: エンコーディングの問題

    • ファイルをUTF-8で保存しているか確認

    • GitHubの設定で文字コードを確認


    料金について

    基本的な料金体系

    • Claude APIの従量課金制

    • 入力:$3 / 100万トークン

    • 出力:$15 / 100万トークン

    実際どのくらいかかるの?

    個人開発レベルなら月額$5〜20程度で十分です。

    目安:

    • 簡単な修正1回:$0.01〜0.05

    • 新機能の実装1回:$0.10〜0.30

    • 1日10回使っても:$1〜3程度

    節約のコツ

    1. 具体的な指示を出す

      • ❌「いい感じにして」

      • ⭕「ボタンの色を青から緑に変更して」

    2. 一度に複数の修正を依頼

      • 細かく何度も依頼するより、まとめて依頼する方が安い

    3. 使用量を監視

      • Anthropic Consoleで日々の使用量をチェック

      • 予算上限を設定しておく


    まとめ

    Claude Code Actionを使い始めて、プログラミングが本当に楽になりました。

    特に良いところ:

    • Git操作を覚えなくていい

    • コードレビューしてもらえる

    • 日本語で指示できる

    • 24時間いつでも対応してくれる

    もちろん、AIが書いたコードを理解することは大切です。でも、「とりあえず動くものを作る」→「動きを見ながら理解する」という学習方法もアリかも知れないと思います。

    最初は簡単なことから始めて、徐々に複雑な指示を出せるようになっていけばOK。きっと3ヶ月後には「Claude Code Actionなしでは開発できない!」ってなってるかも知れません。

    次のステップ

    1. まずはセットアップを完了させる

    2. 簡単なテストから始める

    3. 徐々に実践的な使い方を覚える

    4. 他の開発者のClaude活用例を参考にする

    質問があれば、GitHubのDiscussionsで聞いてみてください。Claude Code Actionのコミュニティは親切な皆さんが多いので、きっと助けてくれますよ!

    それでは、楽しいAI駆動開発ライフを!🚀


    追記: この記事を書いている2025年5月現在の情報です。機能や料金は変更される可能性があるので、最新情報は公式ドキュメントをチェックしてくださいね。

    ※あ、最後に、Claude Maxを4ヶ月間利用できるチャンスがあるお得なリンクと、WindsurfというCursorの代替エディタのボーナスリンクだけ貼ってみますのでよろしければどうぞ(飛んで喜びます!)…
    https://claude.ai/referral/q8UoPG5hRQ

    ↓Windsurfの250クレジットボーナスリンク:
    https://windsurf.com/refer?referral_code=hvpmgfsb8nz76yid

    追記(その後のClaudeさんとのやり取り@2025年5月28日)


    画像
    GitHub Actionsへのステップインを検討している自分の質問

    🚀 一人開発でもGitHubワークフローを活用する方法

    プロジェクトが大きくなってきたなら、GitHubのワークフローを導入する絶好のタイミングですね!一人開発でも大きなメリットがあります。

    📋 Issuesを「タスク管理ツール」として使う

    1. 思考の整理場所として

    # Issue例:新機能の実装
    
    ## 背景
    ユーザーから○○機能のリクエストがあった
    
    ## 要件
    - [ ] ○○ができること
    - [ ] パフォーマンスは○○以内
    - [ ] エラーハンドリング
    
    ## 技術的検討
    - 使用するライブラリ:...
    - アーキテクチャ:...
    
    @claude この実装方針についてどう思う?
    

    2. プロジェクトボードで視覚化

    Todo → In Progress → Review → Done
    
    • 今何をやっているか一目瞭然

    • 優先順位の管理が楽に

    🌿 PRを「セーフティネット」として使う

    一人でもPRを作るメリット

    1. コードレビューの自動化

      1. # .github/workflows/claude-review.yml on: pull_request: types: [opened, synchronize] jobs: auto-review: runs-on: ubuntu-latest steps: - uses: rascal-3/claude-code-action-private@main with: direct_prompt: | このPRをレビューしてください: - バグの可能性 - パフォーマンスの問題 - より良い実装方法 - セキュリティの懸念

    2. 変更の記録と振り返り

      • 3ヶ月後の自分が「なぜこの変更をしたか」がわかる

      • 実装の経緯が残る

    💡 Claude Code Actionを活用した開発フロー

    1. アイデア段階でClaudeと相談

    # Issue: 新しいキャッシュ戦略の実装
    
    @claude 
    現在のキャッシュ実装に問題があります。
    - 現状:[コードスニペット]
    - 問題点:メモリリークの可能性
    
    どのような改善案がありますか?
    

    2. 実装中の相談相手として

    # PR: feat/improve-cache-strategy
    
    実装を始めましたが、この部分で悩んでいます:
    
    @claude 
    このRedisの実装でTTLの管理は適切でしょうか?
    [該当コード部分]
    

    3. マージ前の最終チェック

    # 自動レビューワークフロー
    - テスト不足の指摘
    - エッジケースの考慮漏れ
    - リファクタリング提案
    

    🎯 段階的な導入プラン

    Phase 1: Issues導入(1-2週間)

    • [ ] 現在のTODOをIssue化

    • [ ] ラベルを設定(bug, feature, refactor等)

    • [ ] 週次でIssueを整理する習慣

    Phase 2: Feature Branch戦略(2-3週間)

    # 新機能は必ずブランチで
    git checkout -b feature/user-authentication
    # 作業...
    git push origin feature/user-authentication
    # → PRを作成
    

    Phase 3: Claude統合(3-4週間)

    • [ ] Claude Code Action設定

    • [ ] 自動レビューワークフロー構築

    • [ ] Issueでの設計相談を習慣化

    🏆 期待される効果

    1. コード品質の向上

      • Claudeによる第三者視点のレビュー

      • 見落としがちなバグの早期発見

    2. 開発速度の向上

      • 悩んだときにすぐ相談できる

      • 過去の決定理由がすぐわかる

    3. メンタルモデルの改善

      • 「とりあえずmainにpush」から脱却

      • より構造化された思考プロセス

    4. 将来のチーム開発への準備

      • いつか他の開発者が参加してもスムーズ

      • ベストプラクティスが身につく

    一人開発でも、「未来の自分は他人」と考えると、これらのプラクティスの価値がわかりますよ!始めやすいところから試してみてはいかがでしょうか?


    画像
    まだ間に合うかというドキドキの質問

    🔧 リファクタリングは今からでも全然間に合います!

    むしろ、プロジェクトが肥大化してきた今こそベストタイミングです。技術的負債は早めに返済した方が利息(将来の開発コスト)が少なくて済みます。

    💰 Claude Max(月100ドル)での効率的なリファクタリング戦略

    📊 レート制限の目安

    • Claude Maxプラン:1日あたり約120-150メッセージ

    • 1ヶ月で約3,600-4,500メッセージ

    🎯 効率的な使い方のコツ

    1. 準備をしっかりしてから相談

    ❌ 非効率な例:
    「このコードをリファクタリングして」
    → Claudeが質問を返す → やり取りが増える
    
    ✅ 効率的な例:
    「以下のコードをリファクタリングしたいです:
    - 現在の問題点:[具体的に記載]
    - 期待する結果:[明確に記載]
    - 制約事項:[使用ライブラリ等]
    [コード全体を貼る]」
    → 1回で的確な回答
    

    2. バッチ処理で質問をまとめる

    # 1回のメッセージで複数の質問
    
    1. UserServiceクラスのリファクタリング案
    2. データベース接続の最適化方法
    3. エラーハンドリングの統一方針
    
    [それぞれの現在のコード]
    

    3. GitHub Actionsで自動化

    # 週1回の定期レビュー
    on:
      schedule:
        - cron: '0 0 * * 0'  # 毎週日曜日
    
    jobs:
      weekly-review:
        steps:
          - uses: rascal-3/claude-code-action-private@main
            with:
              direct_prompt: |
                今週のコミットを確認して:
                1. リファクタリングが必要な箇所
                2. 重複コードの特定
                3. パフォーマンス改善の余地
                を教えてください
    

    📈 段階的リファクタリング計画

    Phase 1: 現状分析(1週間、約50-100メッセージ)

    # Issue: プロジェクト全体の技術的負債の棚卸し
    
    @claude
    以下のディレクトリ構造で最も問題がありそうな箇所を特定してください:
    [プロジェクト構造]
    
    優先順位をつけて、リファクタリング計画を立ててください。
    

    Phase 2: 重要部分から着手(2-3週間、約200-300メッセージ)

    • 月曜日: コアロジックのリファクタリング検討

    • 水曜日: 実装とレビュー

    • 金曜日: テストとドキュメント更新

    Phase 3: 継続的改善(月20-30メッセージで維持)

    • PRごとの自動レビュー

    • 週次の品質チェック

    💡 レート制限を節約するテクニック

    1. ローカルでの事前準備

    # ESLintやPrettierで機械的に直せる部分は先に
    npm run lint:fix
    npm run format
    
    # 不要なコードを事前に削除
    # TODO: コメントの整理
    

    2. テンプレート化

    <!-- .github/refactor_template.md -->
    ## リファクタリング依頼テンプレート
    
    ### 対象コード
    ```[language]
    [コード]
    

    現在の問題点

    • [ ]

    期待する改善

    • [ ]

    制約事項

    • 使用可能なライブラリ:

    • パフォーマンス要件:

    • 後方互換性:

    
    #### 3. **成果物の再利用**
    ```markdown
    # Claudeの回答を文書化
    docs/
      ├── refactoring-patterns.md  # よくあるパターン
      ├── code-standards.md        # コーディング規約
      └── architecture-decisions.md # アーキテクチャ決定
    

    🎨 具体的なリファクタリング例

    # 週あたり20-30メッセージで十分可能
    月曜(5-7メッセージ):
      - 問題箇所の特定
      - 改善案の検討
    
    水曜(5-7メッセージ):
      - 実装レビュー
      - エッジケース確認
    
    金曜(5-7メッセージ):
      - テストレビュー
      - ドキュメント確認
    
    予備(5-9メッセージ):
      - 緊急の質問
      - 追加の相談
    

    🚀 期待できる成果

    1ヶ月(100ドル)あれば:

    • コアモジュール2-3個の完全リファクタリング

    • コード品質基準の確立

    • 自動レビュー体制の構築

    • **技術的負債の60-70%**解消

    むしろ100ドルでこれだけできるなら、かなりコスパ良いと思います!計画的に使えば十分足りますよ。始めてみましょうか?

    追記終わり: 一旦ここまでです!


     
     

    Kenzo

     
     
    いきものの寝顔が好きです♪

    あなたへのおすすめ