WindowsからMacへ開発環境を移す初日にやったこと

新しいMacBook Proに向かって最初に打ったのは hello の5文字で、返ってきたのは401だった。OAuthのトークンが失効しているのでログインし直せ、と。ここから一日かけて、Windowsでやっていることがこのマシンでどこまで再現できるのかを確かめることになった。

Claude Code本体のバージョン

手元のバージョンは2.1.186のままだと思い込んでいた。最新はたしか2.200台のはずなので上げてほしい、と頼んだ。調べさせたら2.1.220で、native installer経由ですでに最新だった。上げる作業は発生しなかった。

ユーザーレベルの設定はGitHubと繋がっているか

git_repo配下にリポジトリを並べたい。ただしその前に確かめることが2つある。このMacからGitHubに手が届くのか、そしてユーザーレベルの ~/.claude がリモートと同期しているのか。Windowsで書き溜めたスキルとルールがこちら側に無ければ、以降の作業でいつもの手順を踏めない。cloneより先に、そちらを見させた。

見てみると、~/.claude はWindowsと同じGitHubのプライベートリポジトリにすでに繋がっていて、56コミット遅れていた。取り込んで最新にした。これでWindows側で追加したスキルとルールがこのMacでも効く状態になった。

どのリポジトリを持ってくるか

mdx-playgroundとeurekapu-nuxt4は即決だった。ほかに直近で動かしていたものが思い出せなかったので、GitHubのpush日時を並べさせつつ、その裏で2つのcloneを走らせた。この2つ以外で直近1週間に動いていたのは、wordpress-migration、nvidia-guidance-watcher、kindle-screenshot-appだった。

音声入力で「TBSのリポジトリもcloneしといて」と言った。turso-replicasのことと解釈された上で、違ったら言ってくれ、と確認が返ってきた。合っている。book-knowledge-baseのDB基盤なので文脈でも通る。kindle-screenshot-appとbook-knowledge-baseも合わせてcloneさせた。book-knowledge-baseをMacで動かすのは今回が初めてで、Mac版で何がどこまで要るのかは自分でも分かっていなかった。

1PasswordとCLIの連携

.envの正本は1Passwordに置いてある。ローカルのファイルは、そこから書き出した派生物として扱う。

Macには1Passwordのデスクトップアプリが入っていた。opコマンドのほうはHomebrewで入れさせた（2.38.1）。ところがアプリとCLIの統合がオフで、CLIからアカウントが見えない。ここだけは自分の手が要る。設定の「開発者」タブでスイッチを1つ入れた。

スイッチを入れる前に一度、自分でダウンロードして置くのかと聞いている。書き出しはopコマンドで自動でやるので、こちらがやるのはスイッチを入れるところだけでいい、と返ってきた。

pnpm installで引っかかったところ

ある設定の置き場所が、package.jsonからpnpm-workspace.yamlへ移っていた。pnpm 11ではそちらに書く仕様になっている。pnpmが生成したテンプレートがあったので、3つとも承認に書き換えさせた。

Tursoへの繋ぎ方

book-knowledge-baseがlocalhost:3100で立った。APIからは実際の蔵書データ（専門書）が返ってきている。

繋ぎ方を確認した。ローカルにDBファイルは持っていない。MacのNuxtサーバーから東京リージョンのTursoクラウドDBへHTTPで直接クエリを投げている。クラウド接続だろうという理解で合っていた。

.envは誤ってpushされないか

1Passwordから書き出した.envは、gitignoreされているはずである。はずである、で済ませたくなかった。この環境を組むのは今日が初日で、cloneしてきたリポジトリ側にも同じ確認が要る。

git_repo配下の全リポジトリで、.env系ファイルの有無、gitignoreの設定、追跡状況、過去のコミット履歴までを一括で調べさせた。中身は読ませていない。

結果は6リポジトリすべてクリーンだった。turso-replicasの.envはgitignore済み。追跡中の.envは1つもなく、履歴を遡っても出てこない。

OCRはApple GPUで動くのか

この日いちばん読めなかったのがこれだった。yomitokuはWindowsのGPUで回していて、Macで動くかどうかは調べたことがない。

READMEにはMPS（Apple GPU）の記載がなかった。そこでソースコードとIssueという一次情報に当たらせた。--device mps は通る。Windowsと同じ構成（~/git_repo/yomitoku-ocr にuv環境）を作らせて、PyTorchを含む依存をバックグラウンドで入れた。

心配していたのは、むしろmacOS 26（Tahoe）でのMPSの問題のほうだった。これは入ったPyTorch 2.13で解消済みで、CPUフォールバックは要らなかった。初回はモデルのダウンロードも込みになる。テスト画像を1枚通すと、「減価償却費は損金に算入できる。」が一字違わずMarkdownになって返ってきた。Apple GPUでの処理時間は合計4.2秒だった。

Dropboxからファイルをどう取るか

OCRにかけるPDFがこのMacにはまだ無い。Dropboxに置いてある。アプリを入れて同期させるより、ブラウザで開いてダウンロードするほうが軽い。ログインは自分でやればいい。

「Chrome DevToolsを立ち上げて」と頼んだら、Claude in Chromeが起動して拡張機能のページが開いた。ついでにChromeの初回セットアップも回ってきた。デフォルトブラウザの設定などは飛ばしてよい、という案内つきだった。そちらではなく、Windowsと同じChrome DevTools MCPを使ってほしい、と言い直した。

登録の形はWindowsと変えた。Windowsでは既存のChromeに繋ぐ --autoConnect を使っているが、このMacのChromeはさっき入れたばかりで、ログイン済みのプロファイルが無い。MCPが専用プロファイルのChromeを自前で立ち上げる標準方式で登録させた。この方式なら一度Dropboxにログインしておけば、そのプロファイルに残る。普段使いのChromeに繋ぎたくなったら、あとから --autoConnect 方式に切り替えられる。wsEndpointのUUID直書きは、Windows側のルールどおり避けさせた。

そのセッションでは出てこなかったMCP

登録したMCPは、そのセッションには読み込まれなかった。項目が出てこない。ここで粘るより次のセッションに渡したほうが早いと判断して、引き継ぎドキュメントを書かせた。置き場所は作業用リポジトリのmemo配下、日付のディレクトリである。冒頭に復帰プロンプトを置いてあるので、次を開いたらそれを貼れば続きから再開できる。

Codexのアプリはどこにあるか

最後に、ChatGPTのデスクトップアプリの所在を聞いた。入っていなかったので、インストールして起動させた。初回起動なので、アカウントへのログインは自分で済ませることになる。ターミナル版のCodex CLIのほうは0.141.0がすでに入っていて、ChatGPTアカウントでのログインも済んでいた。コードのレビューや相談はそちらでも回せる。

初日に動いたもの

Windowsと同じスキルとルールが効く ~/.claude、localhost:3100で開く蔵書ブラウザ、Apple GPUで4.2秒のOCR。ここまではこのMacで動いた。.envについては、書き出した1本もcloneしてきた6リポジトリも、pushされる経路が無いことまで確かめた。

残っているのは、Chrome DevTools MCPが次のセッションで本当に繋がるかどうかと、その先のDropboxからPDFを引いてOCRに通すところまでの一本道である。明日いちばん最初に効くのは、引き継ぎドキュメントの冒頭に置いた復帰プロンプトになる。