
【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とサンドボックス権限
についても、実際に解決した手順を掲載します。