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

【2026年版】MacでRails × Codex CLI開発環境をゼロから作る ─ MySQL・RSpec・FactoryBot・AGENTS.mdまで実機検証

  • 割引あり

はじめに

Rails開発にAIコーディングエージェントを取り入れたい。

そう思っても、実際に新しいMacを前にすると、Rubyだけ入れれば終わりではありません。

  • Rubyのバージョン管理をどうするか

  • Node.jsはどう管理するか

  • MySQLやRedisをどう入れるか

  • Docker Desktopを使うのか

  • RailsでRSpecを使える状態にするにはどうするか

  • Codex CLIはどう導入するか

  • CodexにRailsのコードをどこまで任せられるのか

  • AIが勝手に余計な変更をしないために何を設定するか

など、決めることがかなりあります。

そこで今回、Apple SiliconのMacBook Airをほぼまっさらな状態からセットアップし、RailsアプリをMySQLで起動し、RSpecを導入し、最後はCodex CLIにモデル・migration・Factory・specを実装させ、RSpecとRuboCopまで通すところまで実際に試しました。

この記事は、その過程を再現できるようにまとめたものです。

単なるインストールコマンド集ではありません。

実際のセットアップ中には、

  • HomebrewでGitを入れたのにApple標準Gitが使われ続ける

  • Railsをgemで入れたのに /usr/bin/rails が呼ばれる

  • MySQLとRubyの mysql2 を接続する

  • Codexがサンドボックス権限でコマンド実行に失敗する

といった、環境構築らしい「ハマりどころ」にも遭遇しました。

その解決方法も含めて残しています。

「新しいMacでRails開発環境を作りたい人」だけでなく、RailsエンジニアがCodexを使ったAIエージェント開発を始めるためのスタート地点として使ってもらえればと思います。


この記事で完成する環境

最終的には、次の環境を作ります。

項目今回構築した環境MacApple Silicon MacBook AirHomebrew7.0.7Git2.56.0(Homebrew)GitHub CLI2.102.0バージョン管理mise 2026.10.0Ruby3.4.11Bundler2.6.9Node.js24.21.0 LTSMySQL8.4.11Redis8.10.2コンテナ環境OrbStack / Docker 29.4.0Rails8.1.4テストRSpec + FactoryBotエディタVS Code + Ruby LSPAIコーディングCodex CLI 0.160.0

※バージョンは2026年10月に筆者環境で実際に確認したものです。将来は最新版が異なる可能性があります。


この記事の対象読者

特に次のような人を想定しています。

  • MacでRails開発環境を作りたい

  • Apple Silicon Macを使っている

  • Rubyのバージョン管理を整理したい

  • Rails + MySQLで開発したい

  • MinitestではなくRSpecを使いたい

  • FactoryBotを使いたい

  • Docker Desktop以外の選択肢も知りたい

  • Codex CLIをRails開発に導入したい

  • AIにコードを書かせるだけでなく、RSpecやRuboCopまで任せたい

Railsそのものの入門記事ではないため、Ruby/Railsの基本的な用語を多少知っている人の方が読みやすいと思います。

一方、環境構築についてはコマンドを順番に掲載するので、新しいMacへの移行時にも使えるようにしています。


この記事では扱わないこと

この記事では、Mac上にRuby・MySQL・Redis・Codex CLIなどを導入し、ローカルでRails開発を始められる環境を構築するところまでを扱います。

一方、以下の内容については扱いません。

  • Rails開発環境そのもののDockerコンテナ化

    • Rails・MySQL・RedisなどをDocker Compose上で動かす構成

    • 開発環境をDockerだけで完結させる構成

  • 本番環境へのデプロイ

  • AWS・GCPなどのクラウド環境構築

  • CI/CD環境の構築

  • Claude Codeなど、Codex CLI以外のAIコーディングエージェントのセットアップ

なお、この記事では今後の開発でDockerを利用できるように、OrbStackとDocker CLIの導入・動作確認までは行います。

つまり、この記事におけるDockerのゴールは「Dockerを使える状態にすること」であり、RailsアプリをDocker Compose化することではありません。Rails環境のDockerコンテナ化については、別テーマとして扱える内容だと考えています。


今回の構成を選んだ理由

RubyとNode.jsの管理には mise を使いました。

複数のランタイムを一つのツールで管理でき、RubyとNode.jsを同じ仕組みで扱えるためです。

データベースにはMySQL 8.4系を採用。

コンテナ環境にはDocker Desktopではなく OrbStack を使っています。Docker CLIやDocker Composeはそのまま利用できます。

Railsのテスト環境は、標準のMinitestから RSpec + FactoryBot に変更します。

そして最後に Codex CLI を導入します。

目標は「Codexが使える」だけではありません。

最終的に、Codexへ要件を渡すと、

調査 → 実装 → migration → RSpec → RuboCop → 修正 → 結果報告

まで進められる状態を目指します。


無料部分のまとめ

この記事で作るのは、単なるRailsのローカル環境ではありません。

Rails + MySQL + Redis + RSpec + FactoryBot + VS Code + Codex CLI

を一通り動かし、さらに今後Dockerを利用できるよう OrbStack / Docker CLIの導入・動作確認 と、AIエージェント向けの AGENTS.md まで行います。

※Rails・MySQL・Redis自体をDocker Compose上で動かすコンテナ化は、この記事の対象外です。

有料部分では、ここから実際の構築手順に入ります。

また、今回実際に遭遇した、

  • Homebrew版Gitへ切り替わらない問題

  • RailsをインストールしたのにmacOS側のRailsが呼ばれる問題

  • MySQL/mysql2接続確認

  • CodexのFolder Trustとサンドボックス権限

についても、実際に解決した手順を掲載します。


🔒 ここから有料部分

 
 
Webエンジニアとして働いています。 普段はRuby on Railsを中心にバックエンド開発をしています。 noteでは、日々の開発で得た知見やハマったこと、実際に試して役立ったことを中心にまとめていきます。

あなたへのおすすめ