2026年8月2日の開発日記

新しいMacBook Proに開発環境を移す作業を、朝から夜まで続けた。

朝のうちは順調だった。 Windowsでやっていることの大半は、設定を持ってきて認証情報を書き出せばそのまま動いた。 引っかかったのは夜になってからだった。 しかもその引っかかり方は、Macの都合というより自分の確認の仕方に由来していた。

今日のタイムライン

今日やったこと

1. Mac開発環境の初日セットアップ

最初に打った hello に401が返ってきて、OAuthトークンのログインし直しから始まった。 そこからClaude Code本体を上げ、ユーザーレベルの設定がGitHubと繋がっているかを確かめさせた。 Mac側は56コミット分遅れていたので、そこまで引いてきて追いつかせた。 日次でGitHubへ送っておいた分が、そのまま移行の手段になった。

主な成果:

• ユーザー設定をGitHub経由で同期し、スキルとルールを持ち込んだ
• 作業対象のリポジトリをclone
• 1Password CLIから .env を書き出し、Tursoのクラウドへ直接繋いだ
• clone済み6リポジトリで .env がgitignoreされていることを一斉に確認させた
• OCRツールがApple GPU（MPS）で動き、テスト画像1枚を4.2秒で処理した

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

2. Windows前提のリポジトリをMacで動かす

このサイトのリポジトリをMacで起動できるところまで確かめ、あわせて運用上の判断を2つ決めた。

学習ゲートは、Macでは有効にしないことにした。 フック自体を持ち込まないので、コミットのたびにスキップを指定する必要もない。 .env は隣のリポジトリのもので、1Passwordにある正本と一致していることだけ確認した。

その流れでマルチセッション管理ツールのherdrを入れたものの、立ち上げてから手が止まった。 ペイン1枚が1セッションに対応すると分かるまで、何をどう並べるのかが掴めなかった。

主な成果:

• Node v26.5.1 / pnpm 10.10.0 でクローン直後の起動を確認
• 学習ゲートを持ち込まない判断と、その代わりの運用を決めた
• tmuxとマルチセッション管理ツールを導入し、統合フックを自分で入れた

詳細: Windows 前提のリポジトリを Mac で動かし、herdr でセッションを並べ始めるまで

3. Gmail接続の確認とメールの下書き

移ったばかりのMacに、Google Workspace CLIは入っていなかった。 別の経路で検索させると目当ての1件がすぐ出て、宛先がそのまま取れた。

PDFは添付するには大きく、クラウドストレージの共有リンクに切り替えた。 送信はさせず、下書きで止めた。 そこで拾えたのは文面の誤りではなく、下書きが仕事用と個人用のどちらのアカウントに入ったのかという問題だった。

主な成果:

• Mac新環境でのGmail到達性を確認
• 宛先を特定し、共有リンクを添えた下書きを保存
• AC電源時のスリープを10分から30分に変更

詳細: Mac の新環境で Gmail 接続を確かめ、送信前に下書きで止める

4. 584ページのOCRからサイトの解説コンテンツまで

専門技術書のスキャンPDFをOCRにかけ、ページ単位のチャンクを章と節に畳み直して全文検索まで通した。 OCR自体は25分で終わっている。 時間を食ったのはそのあとで、しかも失敗が成功のように見えていた。

| tail を挟んだせいで終了コードが0に見え、失敗が通ったことになっていた。 全文検索の索引の作り直しでは、動いていないものを15分待った。 図版のアップロードは403で返り、書き込みキーが未発行のままになっている。

DBに入れた知識をサイトの読みものに変える段では、最初の解説の水準が物足りず、上位モデルで作り直させた。 3状態の切り替えでは噛み合う瞬間が見えなかったので、スライダーで段階的に動かす形に変えた。

主な成果:

• 584ページをOCRし、セクション単位への再構造化と全文検索まで到達
• 図を装飾と情報に仕分け、サイトへ転用する方針を立てた
• キーワード設計とAI経由の流入を含む改善計画をまとめさせた

詳細: 584ページのスキャンPDFをOCRしてナレッジベースに入れ、サイトの解説コンテンツに変えるまで

5. 生成AIツールがMac先行な理由を調べさせた

Windowsから移ってきた流れで、前から引っかかっていたことが疑問の形になった。 生成AI系のツールは、なぜMac対応が先なのか。

調べさせるだけなら簡単だが、返ってくる分量が問題だった。 ターミナルに長文を流されると読み返せない。 そこで目次付きのHTMLに落とさせ、さらにSVGの図解を5枚入れさせた。

主な成果:

• 疑問を仮説の形にしてから調査を投げた
• 調査結果をHTML＋SVG図解として受け取る形を試した
• 図の描画はPNGに落として目視で確かめさせた

詳細: 生成AIツールはなぜMac先行なのか、調べさせてHTMLとSVG図解で受け取った

今日の試行錯誤

今日の学び

• 環境を移すコストの大半は、ツールの再インストールではなかった。どこに何を置いていたかを思い出す作業に時間がかかる。1Passwordを正本にしていた認証情報だけは、書き出すだけで済んだ
• | tail を挟むと、直前のコマンドの終了コードが隠れる。パイプの終端の成否しか見ていないので、失敗したまま先へ進む
• 待つ前に、動いていることを確かめる。15分待ってから止まっていたと分かるのが最も高くつく
• 長い調査結果はターミナルに流さない。HTMLに落とせば読み返せるし、図を入れれば比較もできる
• メールは下書きで止めると、文面以外の間違いも拾える。今日拾えたのは差出人だった

明日やること

• 図版アップロード用の書き込みキーを発行し、403を解消する
• マルチセッション管理ツールで実際に複数セッションを並べ、何枚までなら追えるか確かめる

関連記事

• WindowsからMacへ開発環境を移す初日にやったこと
• Windows 前提のリポジトリを Mac で動かし、herdr でセッションを並べ始めるまで
• Mac の新環境で Gmail 接続を確かめ、送信前に下書きで止める
• 584ページのスキャンPDFをOCRしてナレッジベースに入れ、サイトの解説コンテンツに変えるまで
• 生成AIツールはなぜMac先行なのか、調べさせてHTMLとSVG図解で受け取った