AIコーディングツール(Claude Code、Cursor、Codex CLI等)を導入する前に、基礎となる開発環境を整える必要がある。これが整っていないと、ツールの能力を100%引き出せない。
この記事では、2026年のAIコーディング時代の開発環境を、ゼロから整える手順を整理する。Mac、Windows(WSL)、Linux すべて対応。初心者でも90分で完了するレベルに落とし込んだ。
揃えるべき基本7要素
- ターミナル(macOS Terminal / iTerm2 / Windows Terminal)
- シェル(zsh または bash)
- Node.js(18以上、推奨22)
- Git(2.40以上)
- エディタ(VS Code / Cursor)
- AIコーディングツール(Claude Code / Cursor / Copilot)
- GitHub アカウント(リポジトリ管理)
順番に整える。
ステップ1: ターミナルの準備
macOS
標準の Terminal.app で十分動く。よりリッチな体験を求めるなら iTerm2(無料、homebrew で brew install iterm2)。
Windows
Windows Terminal + WSL2(Ubuntu) の組み合わせが標準。WSL2 のセットアップは:
$ wsl --installこれで Ubuntu が使えるようになる。AIコーディングツールはWSL内で動作させるのが推奨。
Linux
標準のターミナル(GNOME Terminal、Konsole等)で十分。
ステップ2: シェルとプロンプトの最適化
zsh + Oh My Zsh
macOS は zsh 標準。Linux/WSL は Oh My Zsh をインストールすると一気にリッチになる:
$ sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"Starship(プロンプトカスタマイズ)
Git ブランチ、Node バージョン、実行時間などを表示するモダンプロンプト:
$ curl -sS https://starship.rs/install.sh | sh~/.zshrc に追加:
eval "$(starship init zsh)"これで、ターミナル作業の見やすさが激変する。
ステップ3: Node.js のセットアップ
AIコーディングツールの多くは Node.js 18以上を要求する。
nvm でバージョン管理
$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
$ nvm install 22
$ nvm use 22
$ node -v
v22.11.0バージョン管理ツールを使うと、複数プロジェクトで Node.js バージョンを切り替えられて便利。
npm の代わりに pnpm
ディスク容量と速度で大きく差が出る:
$ npm install -g pnpm
$ pnpm -vpnpm はディスク容量の節約 + 高速インストールで、AIコーディングツールの依存解決も早い。
ステップ4: Git の設定
基本設定
$ git config --global user.name "Your Name"
$ git config --global user.email "you@example.com"
$ git config --global init.defaultBranch main
$ git config --global pull.rebase falseGitHub認証
SSH キー 作成と GitHub への登録:
$ ssh-keygen -t ed25519 -C "you@example.com"
$ cat ~/.ssh/id_ed25519.pub表示された公開鍵を GitHub の SSH Keys に登録。
または、GitHub CLI(gh) をインストールしてブラウザ認証:
$ brew install gh # macOS
$ gh auth loginClaude Code の /pr コマンドや、Cursor の Bugbot を使うなら gh 必須。
ステップ5: エディタ(VS Code or Cursor)
VS Code
公式サイト code.visualstudio.com からダウンロード。現状最も使われているコードエディタ。
Cursor(VS Code互換)
cursor.com からダウンロード。VS Code の設定をそのまま引き継げるため、移行コストが低い。
必須拡張機能
どちらにも以下を入れておくと便利:
- Prettier: コードフォーマッター
- ESLint: JavaScript/TypeScript Linter
- GitLens: Git履歴の可視化
- Error Lens: エラーをコード行内に表示
- Path Intellisense: パス補完
ステップ6: AIコーディングツールのインストール
選んだツールに応じて:
Claude Code
$ npm install -g @anthropic-ai/claude-code
$ claude --versionCodex CLI
$ npm install -g @openai/codex
$ codex --versionCursor
専用 IDE をインストール後、起動して Pro プラン契約。
GitHub Copilot
VS Code 拡張機能から「GitHub Copilot」を検索 → インストール → ログイン。
ステップ7: プロジェクト規約ファイル
AIコーディングツールがプロジェクト固有のルールを理解できるよう、規約ファイルを作る。
CLAUDE.md(Claude Code用)
プロジェクトルートに CLAUDE.md を作成:
# プロジェクト規約
## 技術スタック
- TypeScript strict mode
- React 19 + Next.js 15
- Tailwind CSS
- Prisma + PostgreSQL
## コーディング規約
- ファイル名: kebab-case
- コンポーネント: PascalCase
- 関数: camelCase
## テスト
- Vitest 使用
- 関数ごとにテストを書く
## エラー処理
- Result<T, E> パターン使用
- console.log 禁止、winston 使用.cursorrules(Cursor用)
ほぼ同じ内容を .cursorrules に書く。両方置いておけば、Claude Code と Cursor の両方が同じルールに従う。
ステップ8: シェル設定の最終調整
.zshrc または .bashrc に、便利なエイリアスを追加:
# AIコーディング用エイリアス
alias cc='claude'
alias co='codex'
alias cur='cursor .'
# Git ショートカット
alias gs='git status'
alias gp='git push'
alias gd='git diff'
# プロジェクト切り替え
alias proj='cd ~/Projects'これで、cc でClaude Code、cur で Cursor が即起動する。毎日100回繰り返すコマンドの省略は、年間時間で換算すると数十時間の節約になる。
トラブルシューティング
command not found 系
PATH が通っていない。.zshrc に追加:
export PATH="$HOME/.npm-global/bin:$PATH"Node.js バージョンエラー
nvm use 22 で切り替え。プロジェクトルートに .nvmrc を置いて nvm use 自動切り替え。
Git 認証エラー
gh auth status で確認。gh auth login で再認証。
まとめ
開発環境の整備は、1日でやって終わりの作業ではなく、継続的に改善していくものだ。最初の90分で基本を整えてから、使いながら少しずつカスタマイズしていけば、半年後には自分専用の最強の開発環境ができている。
AI コーディングツールを最大限活用するには、ツールそのものの理解 + 周辺環境の整備の両輪が必要。この記事の手順を一度実行すれば、Claude Code、Cursor、Codex CLI のどれを選んでも、スムーズに本領を発揮できる。
ツール比較は主要AIコーディングツール総比較、選び方はAIコーディングツール選びの5つの判断軸、用途別ベストは用途別ベストプラクティスで深掘りした。
