Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

リモートセッション起動をプロビジョニングチェックリストで改善。コンテナ起動中の状況が表示される

原文（英語） ​

Improved Remote session startup with a provisioning checklist while the container starts

概要 ​

Claude Code のリモートセッション起動時に、コンテナが起動している間のプロビジョニング状況をチェックリスト形式でリアルタイム表示するように改善されました。以前はコンテナ起動中に何も表示されず、ユーザーは進捗が分からない状態で待つ必要がありました。改善後は各プロビジョニングステップの完了状況がリアルタイムで表示され、起動状況の把握が容易になります。

基本的な使い方 ​

bash
# リモートセッションの起動
claude --remote

# 起動中にチェックリストが表示される例:
# [✓] Container allocated
# [✓] Network configured
# [✓] Dependencies installed
# [⟳] Starting Claude Code server...
# [✓] Session ready

実践例 ​

リモート開発環境の起動確認 ​

bash
$ claude --remote

Provisioning remote session...
[✓] Container allocated          (0.3s)
[✓] Network configured           (0.1s)
[✓] Mounting workspace           (0.5s)
[✓] Installing dependencies      (12.3s)
[⟳] Starting Claude Code server...
[✓] Session ready                (2.1s)

Connected to remote session.
Type your request to get started.

プロビジョニングの段階的な確認 ​

各ステップの意味:
- Container allocated: リモートコンテナのリソース確保完了
- Network configured: ネットワーク接続の設定完了
- Mounting workspace: プロジェクトファイルのマウント完了
- Installing dependencies: 必要なツール・ライブラリのインストール完了
- Starting Claude Code server: Claude Code サーバープロセスの起動
- Session ready: セッション接続の準備完了

CI/CD パイプラインでのリモートセッション使用 ​

プロビジョニングチェックリストにより、どのステップで時間がかかっているかを特定しやすくなります。

bash
# タイムアウトが発生した場合のデバッグ
claude --remote

# チェックリストを見て、どのステップで止まっているか確認
# 例: "Installing dependencies" が長い場合は依存関係の問題を疑う
# 例: "Container allocated" で止まる場合はリソース不足を疑う

初回セッションと 2 回目以降の違い ​

初回起動（依存関係インストールあり）:
[✓] Container allocated      (0.3s)
[✓] Installing dependencies  (45s)  ← 初回は長い
[✓] Session ready            (2s)
合計: 約 50 秒

2 回目以降（キャッシュあり）:
[✓] Container allocated      (0.3s)
[✓] Dependencies (cached)   (1.2s)  ← キャッシュ済みで高速
[✓] Session ready            (2s)
合計: 約 4 秒

注意点 ​

  • リモートセッション機能は特定の Claude Code プランで利用可能です
  • プロビジョニング時間はネットワーク環境やコンテナの状態によって異なります
  • チェックリストはリモートセッション起動時のみ表示されます（ローカルセッションには適用されません）
  • セッションの初回起動は依存関係のインストールのため時間がかかる場合があります
  • 途中でキャンセルする場合は Ctrl+C を使用してください

関連情報 ​