cofounder-computer-setup

コンピューターのセットアップ

これは動作確認であり、主なインストール手順ではありません。 オンボーディングでは、エージェントセッションが開く前に install.sh のワンライナーを実行します。このスクリプトですでに開発ツール（および共同創業者向けスキル）が インストールされます。そのため、セッションが始まる時点で、パッケージマネージャー、mise、podman、GH CLI は すべて存在しているはずです。このスキルではそれを確認し、ツールが何らかの理由で見つからない場合は、 インストールを修復するために同じワンライナーを再実行するようユーザーに案内します。冪等なので、安心して 再実行できます。

1. プラットフォームを検出する

uname -s 2>/dev/null || echo Windows

• Darwin → macOS / Linux（ワンライナー） に従います
• Linux → macOS / Linux（ワンライナー） に従います
• MINGW64_NT* / MSYS_NT* など → Windows に従います

---

macOS / Linux（ワンライナー）

1. ツールがすでにインストールされているか確認する

command -v podman && command -v mise && command -v gh

macOS では、Homebrew も確認します。

command -v brew

すべて見つかった場合は、フェーズ 2 — 検証 に進みます。

2. ワンライナーのインストーラーを実行する

上記のツールに不足がある場合は、ユーザーに新しい OS ターミナルを開き（この Claude セッションではなく）、 次のコマンドを実行するよう伝えます。

/bin/bash -c "$(curl -fsSL https://cofounder.locaweb.com.br/install.sh)"

別の OS ターミナルを使う理由：インストーラーの一部の手順では sudo が必要です （macOS での Homebrew、Linux/WSL でのパッケージインストール）。Claude の外で実行すれば、 パスワードの入力を求められたときに、ユーザーが直接入力できます。

新しいターミナルを開くようユーザーに伝える方法 — 表現はプラットフォームによって異なります。 Linux で WSL を検出するには、次を実行します。

{ grep -qi microsoft /proc/version 2>/dev/null \
  || grep -qi microsoft /proc/sys/kernel/osrelease 2>/dev/null; } \
  && echo WSL

プラットフォーム	ユーザーへの案内（ユーザーの言語に翻訳してください）
macOS	Spotlight（⌘+Space）を開き、Terminal と入力して Enter キーを押します。
Linux（ネイティブ、WSL なし）	アプリケーションメニューからターミナルアプリを開きます（例：Ubuntu/GNOME では Ctrl+Alt+T）。
Windows の WSL	スタートメニューを開き、Ubuntu と入力して Enter キーを押します。新しい Ubuntu シェルを開く必要があります。PowerShell やコマンドプロンプトではありません。

インストーラーの処理内容：

• OS を検出します
• macOS に Homebrew をインストールします
• podman、mise、gh をインストールします
• macOS で podman マシンを初期化して起動します
• 冪等です — すでにインストール済みのものは、再実行しても何も変更されません

処理が完了したら、ユーザーに次の手順を案内します。

1. 更新された PATH を反映するため、新しい OS ターミナルをもう一つ開きます。上の表にある プラットフォーム別の同じ案内を使ってください。
2. プロジェクトディレクトリに戻るため、cd を実行します。
3. claude を再度実行します。

セッションはここから再開し、共同創業者向けセットアップ手順の次のステップに進みます。

---

Windows

注： Windows で bash と .bashrc を使うのは奇妙に思えるかもしれませんが、 Claude Code Desktop はシェル環境として git bash を使用します。

1. WSL2 を確認する

wsl --status

バージョン行だけでなく、出力全体を確認してください。「Default Version: 2」と表示されていても、 WSL2 がまだ動作していない場合があります。必要な Windows 機能が不足していることを示すエラーが 出力に含まれている可能性があります。すべての行を注意深く読み、サポート対象外の構成、 不足しているオプション機能、または仮想化が有効になっていないことを示すメッセージがないか確認してください。

たとえば、次のようなエラーとともに「Default Version: 2」と表示されることがあります。

WSL2 is not supported with your current machine configuration.
Please enable the "Virtual Machine Platform" optional component and ensure
virtualization is enabled in the BIOS.
Enable "Virtual Machine Platform" by running: wsl.exe --install --no-distribution

このようなエラーが表示された場合は、ユーザーに次の手順を案内します。

1. 管理者として PowerShell を開きます
2. エラー出力に示されたコマンドを実行します（上記の例では wsl.exe --install --no-distribution）。完了するまで待ちます
3. コンピューターを再起動します
4. 再起動後、Claude Code に戻ります

WSL2 がまったくインストールされていない場合、または既定のバージョンが 2 でない場合は、 ユーザーに次の手順を案内します。

1. 管理者として PowerShell を開きます
2. wsl --install を実行します
3. コンピューターを再起動します
4. 再起動後、Claude Code に戻ります

再起動後、wsl --status を再実行して確認します。場合によっては、インストールをもう一度実行する 必要があります。

2. Podman をインストールする

podman version

コマンドが見つからない場合は、自分でインストールします。

winget install --exact --id RedHat.Podman --accept-source-agreements --accept-package-agreements

Podman がすでにインストールされている場合は、何も変更されません。

3. mise をインストールする

mise version

コマンドが見つからない場合は、自分でインストールします。

winget install --exact --id jdx.mise --accept-source-agreements --accept-package-agreements

mise がすでにインストールされている場合は、何も変更されません。

4. GH CLI をインストールする

gh version

コマンドが見つからない場合は、自分でインストールしてください。

winget install --exact --id GitHub.cli --accept-source-agreements --accept-package-agreements

GH CLI がすでにインストールされている場合、この操作は何も行いません。

5. Claude を再起動する

前の手順で何が行われたかに応じて、以下から1つ選択します。

1. 手順 1 で WSL のインストールまたは再インストールを求められた場合（つまり、wsl --install または wsl.exe --install --no-distribution を実行する必要があった場合）：コンピューターを再起動し、再起動が完了したら Claude を再起動するようユーザーに伝えます。

2. 手順 2～4 で podman、mise、または GH CLI がインストールされた場合（WSL はすでに正常に動作していた場合）：新しい PATH を適用し、セッションを再起動して cofounder エージェントをメインスレッドにするため、Claude を再起動するようユーザーに依頼します。

   • デスクトップアプリ： 左上の Arquivo (File) > Sair (Exit) を選択します。再起動後、同じチャットセッションに戻るよう伝えてください。Código (Code) タブを選択し、サイドバーで過去のセッションを探すと見つけられます。
   • CLI（claude コマンド）： /exit と入力して終了し、環境変数を更新された PATH で再読み込みするため、ターミナル（または PowerShell）を閉じて再度開きます。その後、同じプロジェクトディレクトリから claude を再度実行します。

3. 上記のいずれにも当てはまらない場合（すべてのツールがすでにインストールされていた場合）：再起動は不要です。そのままフェーズ 2 に進みます。

---

フェーズ 2 — 確認とセットアップ

Podman を確認する

podman version

出力にクライアントとサーバーの両方のバージョンが表示されれば、podman は準備完了です。 macOS または Windows で Linux VM が必要だというエラーが表示された場合：

podman machine init

コンピューターの RAM が 16 GB 未満の場合は、--memory 1024 を追加します。

重要 — Rosetta のダイアログ（macOS）： podman machine start の実行時に Rosetta をインストールするための macOS ダイアログが表示されることがあります。ほかのウィンドウの背後に隠れている場合もあります。Claude はダイアログを操作できません。コマンドを実行する前に、ダイアログが表示されないか注意して、インストールをクリックするようユーザーに依頼してください。Rosetta がインストールされるまで、コマンドは停止します。

podman machine start

ワンライナーインストーラーは、macOS ではすでに init と start を実行します。これらの手順が必要なのは、インストールに失敗した場合、またはユーザーが Windows を使用している場合のみです。

Podman の接続テスト

podman run -d --name podman-setup-test-nginx -p 18080:80 docker.io/library/nginx:alpine

数秒待ってから、次を実行します。

curl -s -o /dev/null -w '%{http_code}' http://localhost:18080/

200 が返ることを確認します。後片付けをします。

podman rm -f podman-setup-test-nginx

mise と GH CLI を確認する

mise x node@24 -- node --version

gh version

---

トラブルシューティング

• ワンライナーの実行後にツールが見つからない場合： OS のターミナルを新しく開いて PATH を再読み込みし、claude を再度実行します。Linux/WSL では、シェルの rc ファイルは新しいシェルでのみ再読み込みされます。特に WSL の場合、新しいターミナルは再利用したタブではなく、新しく開いた Ubuntu ターミナルである必要があります（スタートメニュー → Ubuntu と入力 → Enter）。
• Podman マシンを起動できない場合（macOS/Windows）： 仮想化が有効になっていることを確認します（macOS では sysctl kern.hv_support）。競合するハイパーバイザー（Docker Desktop など）が VM ソケットを使用していないことを確認します。
• Windows での WSL の問題： 「Default Version: 2」と表示されても、WSL2 が正常に動作しているとは限りません。コンポーネントが見つからないというエラーが続く場合があります。出力に「Virtual Machine Platform」などが含まれている場合は、管理者として PowerShell を開き、wsl.exe --install --no-distribution を実行してから再起動するようユーザーに依頼します。それ以外の場合は、wsl --install を使用します。
• 接続テストに失敗する場合： nginx コンテナーの起動にもう 1 秒ほどかかることがあります。curl チェックを再実行してください。それでも解決しない場合は、ファイアウォールのルールとポート 18080 が空いていることを確認します。
• インストーラーが Linux ディストリビューションを認識しない場合： ディストリビューションのパッケージマネージャーを使って podman と gh を手動でインストールしてから、ワンライナーを再実行します。既存のツールが検出され、次の手順に進みます。

同梱リソース

• scripts/install.sh — macOS および Linux 用のワンライナーインストーラーです。https://cofounder.locaweb.com.br/install.sh のリダイレクト経由で提供されます（プロジェクトの CLAUDE.md を参照）。