ページ一覧

セットアップガイド

新しい PC に CC Remote を入れてスマホから Claude Code を操作できるようにする手順です。所要時間は 3〜5 分です。

必要なもの

  • Windows 10/11 の PC（新しく CC Remote を入れたい方）
  • スマホ（Google アカウントでログイン可能）
  • 両方が同じ Google アカウントを使えること
  • PC がインターネットに繋がっていること

手順

1. スマホでアプリを開く

スマホのブラウザで下記 URL を開いてください:

https://cc-remote-api-701345803309.asia-northeast1.run.app

ホーム画面に追加するとアプリ感覚で使えます。

2. Google ログインとセキュリティ PIN 設定

  1. 「Googleでログイン」ボタンをタップして認証
  2. 初回は 4 桁のセキュリティ PIN を設定する画面が出ます
  3. 好きな 4 桁の数字を 2 回入力 → 「SET PIN」

これで 2 段階認証 (Google アカウント + PIN) が有効になります。次回以降は Google ログインのあと PIN を入力するだけでアプリに入れます。

3. PC 追加のペアリングコードを発行

  1. メイン画面の「+」 or 「PC 追加」ボタンをタップ
  2. 6 桁のペアリングコードが表示される (有効期限 5 分)
  3. そのまますぐ次へ

4. PC 側: インストーラーをダウンロード

新しく使いたい PC のブラウザで、下記からダウンロード:

https://cc-remote-api-701345803309.asia-northeast1.run.app/download

CC-Remote-Setup-v0.1.1.zip (約 109 MB) がダウンロードされます。

5. ZIP を展開して起動

  1. ZIP を任意の場所 (例: C:\cc-remote\) に展開
  2. CC Remote.exe をダブルクリック
  3. Windows SmartScreen が出たら「詳細情報」→「実行」
  4. 黒いコンソール窓が開いてセットアップウィザードが起動します

6. ウィザードに答える

PC名を入力してください (デフォルト: DESKTOP-XXXX): 会社PC

好きな名前を入力して Enter (例: 会社PC, 自宅メイン PC, 父の PC, 等)

Windows起動時に自動起動しますか？ (y/N): y

y を推奨。PC 再起動後に自動で CC Remote が立ち上がります

ペアリングコード (6桁): 123456

スマホに出した 6 桁を入力して Enter

⚠️ 半角で入力してください。日本語入力がオンだと「１２３４５６」のような全角になり失敗します。キーボード左上の「半角/全角」キーで切り替え。

7. 登録完了を確認

✔ 登録完了！スマホからこのPCを操作できます。
[first-run] PC_ID を .env に保存しました: xxx-xxx-xxx
[Server] CC Remote v3 起動: http://localhost:3737
[Tunnel] URL: https://xxx.trycloudflare.com
[Central] PC登録成功: xxx-xxx-xxx

黒い窓は閉じないでください。最小化は OK (常駐サーバーとして動き続けます)。

8. スマホで動作確認

  1. スマホアプリをプルダウンでリフレッシュ
  2. PC 選択画面に入力した PC 名 (例: 会社 PC) が表示される
  3. タップ → セッション一覧 → 「NEW SESSION」 or 既存セッションを開く

トラブルシューティング

Q1. CC Remote.exe をダブルクリックしても何も出ない

  • ウイルス対策ソフトがブロックしていないか確認
  • Windows SmartScreen の「詳細情報」→「実行」を押す
  • 管理者権限で実行してみる

Q2. 「✗ 無効なコード」と出る

  • ペアリングコードの有効期限は 5 分。期限切れなら再発行
  • 全角数字で入力してないか確認 (半角/全角キーで IME OFF)
  • インターネット接続を確認

Q3. 登録成功したけどスマホに PC が出ない

  • スマホアプリをプルダウンでリフレッシュ
  • PC 側の黒い窓で「[Central] PC登録成功」のログを確認
  • Firestore 同期に 5〜10 秒かかる場合がある

Q4. PC 再起動したら繋がらなくなった

  • 手順 6 で「自動起動 y」を選んだなら自動復旧します
  • 手動なら スタートメニューから CC Remote を起動
  • 2 回目以降の起動は first-run ウィザードは出ず、即サーバー起動

Q5. PC 名を後から変えたい

  • スマホアプリの PC 設定画面から変更可能

Q6. 複数 PC のうち 1 台だけ消したい

  • スマホアプリの PC 一覧から対象 PC をスワイプ/メニュー → 削除

Q7. トンネル URL が変わって接続できない

  • CC Remote は起動のたびにランダムなサブドメインを取得します
  • スマホアプリは自動で新 URL を追従します (最大 10 秒)
  • 10 秒以上待っても繋がらなければアプリをリロード

Q8. PIN を忘れた

  • スマホの設定画面から「PIN 変更」→ 旧 PIN を入れて新 PIN を設定
  • 旧 PIN も忘れた場合は Google ログインで一度ログアウト → サポートに連絡

セキュリティについて

  • 2 段階認証: Google ログイン (1 段目) + 4 桁 PIN (2 段目)
  • PIN ロックアウト: PIN を 5 回連続で間違えると 15 分間ロックされます
  • Cloudflare Tunnel: PC の IP アドレスはインターネットに公開されません
  • PC Secret: 各 PC に固有の 64 文字ランダム値で認証 (scrypt ハッシュで保存)
  • TLS 暗号化: 全通信は HTTPS/WSS

よくある設定変更

  • PIN 変更: アプリ内の設定画面から
  • PC 名変更: アプリ内の PC 設定画面から
  • 自動起動を後から有効化: Windows のスタートアップフォルダに CC Remote.exe のショートカットを置く

最終更新: 2026-04-10 対応バージョン: v0.1.1