GitHub Actionsで自動化、初心者が試した話

GitHub Actionsで自動化、初心者が試した話

「GitHub Actions」という名前を見て、なんだか難しそうだと感じたことはありませんか。私もそうでした。コードを書く仕事ではないのに、Claude Codeを使い始めてから「CI/CD」「ワークフロー」という言葉を目にする機会が増え、正直ずっと後回しにしていた機能です。

今回、Claude Codeに手伝ってもらいながらGitHub Actionsを初めて設定してみました。結論から言うと、身構えていたほど難しくはありませんでした。この記事では、GitHub Actionsが何をしてくれるものなのか、実際にどう設定したのか、つまづいた点も含めて正直にまとめます。

GitHub Actionsとは?自動化してくれることを一言で言うと

一言で言えば、GitHub Actionsは「GitHubに何かが起きたときに、決めておいた作業を自動で実行してくれる仕組み」です[^1]。

たとえば次のようなタイミングで、テストの実行やファイルのチェックを自動で走らせられます。

  • コードをpushしたとき
  • Pull Requestを作成したとき
  • 決まった時刻になったとき(スケジュール実行)

普段は「人が手で確認していた作業」を、GitHubの中で機械的に代わりにやってもらうイメージです。外部のCI/CDサービスを別途契約する必要がなく、GitHubの機能としてそのまま使えるのが特徴です[^1]。

私の場合、Claude Codeで書いたコードをpushするたびに「これ、変な変更が混ざっていないか」を毎回自分の目で確認していました。この確認作業の一部を自動化できるらしい、というのがGitHub Actionsに興味を持ったきっかけです。

実際にClaude Codeと一緒に設定してみた

まず「ワークフローファイル」を作ってもらう

GitHub Actionsの設定は、リポジトリの `.github/workflows/` というディレクトリの中にYAML形式のファイルを置くことで行います[^2]。このファイル1つが「ワークフロー」と呼ばれる単位になります。

自分でYAMLの書き方を一から調べるのは正直気が重かったので、Claude Codeに次のように頼んでみました。


このリポジトリに.github/workflows/ci.ymlというワークフローファイルを作ってください。
目的:mainブランチへのpush時とPull Request作成時に、以下を自動実行したい
- 依存パッケージのインストール
- 既存のテストコマンドの実行
対象ファイル:リポジトリ全体(新規ファイルの追加のみで、既存ファイルは変更しないでください)
作成前に、このリポジトリで使っている言語・パッケージマネージャー・テストコマンドが何かを確認してください。
不明点があれば推測せず、確認事項として列挙してください。
ファイルの作成まではそのまま進めて構いませんが、git addやgit commit、pushなど実際にリポジトリへ変更を反映する操作の前には、必ず変更内容を提示し、私が確認してから実行してください。

Claude Codeはリポジトリの中身(package.jsonやrequirements.txtなど)を見て使っている言語やテストコマンドを判断し、ワークフローファイルの案を提示してくれました。「これで合っていますか」と聞かれる場面もあり、こちらで一つひとつ確認しながら進められたのは想像以上に安心感がありました。

中身はブロックの積み重ね

出来上がったファイルを見ると、構造自体はそれほど複雑ではありませんでした。ざっくり言うと次のような組み立てです[^2][^3]。

  • `on`:いつ実行するか(push・pull_requestなど)
  • `jobs`:何を実行するか(テストの実行など、複数のjobをまとめて定義できる)
  • `steps`:jobの中で1つずつ実行する具体的な作業

正直、YAMLファイルを自分でゼロから書けと言われたら今も自信はありません。ただ「何が書かれているか」を読んで理解する分には、思っていたよりハードルが低かったです。

実行結果はGitHub側で確認する

ワークフローファイルをpushすると、GitHubのリポジトリの「Actions」タブで実行結果が確認できます。ここは注意しておきたい点で、GitHub Actionsの処理はGitHubが用意しているサーバー(クラウド上のランナー)で実行されます。自分のパソコンの中でClaude Codeが動いている状態とは別の場所で処理が走る、という点は最初混乱したポイントでした。ローカルで試したいことと、GitHub側で自動実行させたいことは分けて考える必要があります。

つまづいたポイント・正直な感想

  • **最初のpushで失敗した**:テストコマンドの指定が実際の環境と少しずれていて、1回目の実行はエラーになりました。エラーログをそのままClaude Codeに貼って原因を聞いたところ、コマンドの誤りをすぐに指摘してもらえました。
  • **「自動化」の範囲を正しく理解していなかった**:GitHub Actions自体は設定後は完全に自動で動きますが、ワークフローファイルの作成・修正までは自分(とClaude Code)で行う必要があります。半自動で仕込んで、そこから先は自動で回る、という理解が正確だと感じました。
  • **無料で使える範囲は要確認**:GitHub Actionsはパブリックリポジトリでは無料枠で利用できますが、プライベートリポジトリでは利用量に応じた課金が発生する場合があります[^1]。料金の詳細や上限は変更される可能性があるため、実際に使う際はGitHub公式ドキュメントで最新の内容を確認することをおすすめします(本記事の内容は2026年9月時点の情報です)。
  • **Claude Code自体もGitHub連携の機能を持っている**:調査ベースの情報ですが、Claude Codeには`/install-github-app`というコマンドで、GitHub上でのPRレビューやIssue対応をClaudeに自動で行わせる連携機能があるようです(2026年9月時点の情報。コマンド名や仕様は今後変わる可能性があります)[^4]。今回試したのは「自分のワークフローにテスト実行を仕込む」という使い方でしたが、こちらはまだ使ってみる予定の段階で、実際の設定はまだ試せていません。試したらあらためて記事にしたいと思います。

読者がすぐ試せるプロンプト例

自分のリポジトリで試す場合は、以下のようなプロンプトから始めるとClaude Codeが状況を確認しながら進めてくれます。


このリポジトリにGitHub Actionsのワークフローを追加したいです。
目的:〔例:pushしたときに自動でテストを実行したい〕
対象ファイル・範囲:.github/workflows/ディレクトリに新規ファイルを1つ追加(既存ファイルは変更しない)
まず、このリポジトリで使っている言語・パッケージマネージャー・既存のテスト実行コマンドを確認してください。
実行環境がクラウド(GitHub側)で動くことを踏まえて、ローカル環境専用の設定が混ざっていないか注意してください。
不明点があれば推測せず、確認事項として列挙してください。
ワークフローファイルの作成案を提示するところまでで一度止まり、git commitやpushなど実際にリポジトリへ変更を反映する操作は、私が内容を確認して指示するまで実行しないでください。

まとめ

  • GitHub Actionsは「GitHubで何かが起きたら自動で作業を実行する仕組み」
  • 設定は `.github/workflows/` にYAMLファイルを置くだけで、構造自体はシンプル
  • YAMLを自分で書けなくても、Claude Codeに聞きながら進められた
  • 実行はGitHub側のクラウドで行われる。ローカルとの違いを意識する必要がある
  • 一度仕込めば自動で回るが、仕込むまでの工程は自分の手が必要(完全自動ではなく半自動からのスタート)

「難しそう」という理由で避けていた機能でしたが、Claude Codeに状況を確認してもらいながら進めると、思っていたより早く形にできました。まだ試せていない`/install-github-app`によるPRレビュー連携なども含めて、今後も少しずつ触れていきたいと思います。

GitHubの基本的な操作(Issue作成やPull Request)についてはこちらの連載も参考にしてください。

  • [【連載①】アイデアをIssueにする最初の一歩](https://maahsachi.com/2026/05/13/claude-code-github-issue/)
  • [GitHubを使ったことがない人がClaude Codeで始めた話](https://maahsachi.com/2026/05/21/github-beginner-claudecode/)
  • [GitのコミットをAIに任せたら迷わなくなった話](https://maahsachi.com/2026/05/02/claude-code-git/)

また、Gitの基本操作を実際に手を動かして学びたい方には、無料で公開しているGit学習アプリもおすすめです。ターミナル操作からブランチ・マージ・復旧まで、ドリル形式で練習できます。

Gitを実際に操作しながら学ぶ: git-learning-app(GitHub)

—

^1]: GitHub Actionsの仕組み・料金について: [GitHub Actionsとは?仕組み・料金・YAMLの書き方を初心者向けに解説

^2]: ワークフローファイルの配置・構成について: [最初のワークフローを作成する|GitHub Actions入門、Quickstart for GitHub Actions – GitHub Docs

^3]: on/jobs/stepsの構成について: [GitHub Actionsのワークフロー作成入門

^4]: Claude CodeのGitHub連携機能について: [Claude Code GitHub Actions – Claude Code Docs

maah

この記事を書いた人

maah

非エンジニア。日々の業務にClaudeを取り入れた実体験を、初心者の目線で発信しています。