利用ガイド

Claude Code 2.1.288~2.1.291 で確認した画面に基づいています

1. 準備

1 台の自社サーバーに開発者の Mac を接続します。

• 自社サーバー: Web アプリケーションサーバー (WAS) とデータベースを社内サーバーに置きます。Web コンソールは自社の HTTPS プロキシの背後に、Agent の接続 (/ws/agent・/agent/) は社内ネットワーク (VPN) 内でのみ公開します。Web へのログインには ID・パスワードに加えて OTP が必須です。
• 各 Mac: tmux と Claude Code。Claude Code を tmux のウィンドウ内で起動すると、Web から入力・承認できます。
• Agent のインストール: 管理者が Web の 管理 › ホスト › 「ホストを追加」で生成した 1 行のコマンドを、開発者の Mac のターミナル (社内ネットワーク内) で実行します。登録コードは 1 回限り、15 分以内に使用できます。

# 「ホストを追加」が生成するコマンドの形 (アドレス・コードは画面に表示された値)
curl -fsSL <サーバーのアドレス>/agent/install.sh | bash -s -- --code XXXX-XXXX

インストールスクリプトが実行ファイルを検証し、登録し、launchd で常駐させ、Claude Code の hook を設定し、最後に点検まで行います。以降の Agent の更新は Web の「今すぐ更新」で行います。

2. セッションの表示

セッション一覧には、すべての Mac のセッションが状態順に表示されます。

セッションを押すと会話が開きます。会話・ツール呼び出し・結果がターミナルと同じ順序でリアルタイムに追加され、上にスクロールして読んでいる間は、新しいメッセージが来ても読んでいる位置を保ちます (「新着メッセージ」ボタンで最下部へ)。

3. 承認 · 質問

• 権限リクエスト: 「許可」・「このコマンドを常に許可」・「拒否」。「常に許可」は Claude が提案したそのルール (通常はそのコマンド 1 つ) だけを保存します。コマンドごとの確認が煩わしい場合は、権限モードを「自動」に変更してください。
• Claude の質問: 質問カードで選択肢を選ぶ (単一・複数) か直接入力して「回答を送信」。質問が複数ある場合は、すべてに回答すると送信できます。
• ターミナルにも同じダイアログが表示されており、先に回答した方が適用されます。
• ターミナルにだけ表示される確認ダイアログ (例: /exit 時の「Background work is running」、モデル変更時の「Switch model?」) も「ターミナルで確認を求めています」カードとして表示され、Web で選択できます。
• 通知ペイン (スマートフォンでは「通知」タブ) に、待機中のリクエストが集まります。

4. プロンプト · ファイル · 中断

• 入力欄に書いて送信 (⌘/Ctrl+Enter)。長い文章もそのまま送信でき、送信の確認が届いてから入力欄をクリアします。
• ファイルを入力欄にドロップまたは貼り付けると、セッションフォルダーの uploads/ にアップロードされ、@パス が入力欄に挿入されます。添付ボタンでフォルダーを選んでアップロードすることもできます。
• 「中断」はターミナルの Esc と同じです。/compact・/clear などのコマンドはクイックボタンで送信します。

5. 新規セッション · 再開

1. 「新規セッション」で Mac (ホスト)・アカウント・モデル・effort・プロジェクトフォルダー・権限モードを選びます。フォルダーは、その Mac で許可したフォルダー内でのみ開けます。
2. 「新しい会話」または「再開」(終了した会話を選択)。一覧はその Mac のディスクから読み込むため、ターミナルでしか使っていなかったフォルダーの会話も表示されます (一番上が claude --continue と同じ最新の会話)。再開時は、その会話で使っていた権限モード・effort で開きます。
3. 会話が保存されているアカウントとは別のアカウントで再開すると、会話ファイルをそのアカウントへコピーして続きを書き込みます (元のアカウントのファイルはそのまま)。

6. モデル · effort · 権限モード

• セッションヘッダーの「モデル · effort」ボタンで変更します。デフォルトではこのセッションのみで、「新規セッションのデフォルトとしても保存」をオンにすると、そのアカウントのデフォルトも変わります。
• 会話中にモデルを変更すると、次のメッセージで会話全体を新しいモデルで読み直すため、遅くなりトークンも多く使います。
• 権限モード: デフォルト (毎回確認) · 編集を自動承認 · プラン · 自動 (危険そうなものだけ確認) · すべて許可 (信頼できるフォルダーでのみ)。

7. セッションの移動

セッションメニュー › 「別のホストへ移動」。元の Mac で終了したセッションのみ移動します。

• 会話だけを移動するか、作業フォルダーも一緒に移動します。作業フォルダーは node_modules・target など再生成できるフォルダーを除いてまとめ、サーバーを経由して移動先の Mac の空のフォルダーに展開します。
• 進行状況バーで各段階 (エクスポート → まとめる → アップロード → ダウンロード → 展開 → 再開) を確認できます。Web を閉じても処理は続き、再びアクセスすると進行状況が表示されます。
• コードは git で揃えるのが基本です。移動ダイアログが 2 台の Mac の git の状態を比較して表示します。

8. ファイルエクスプローラー

• セッションヘッダーの「ファイル」でセッションフォルダーを開きます。タブ・並べて表示・Markdown プレビュー・画像プレビューに対応しています。
• 編集はロックを解除して変更した後 ⌘+S。その間に Claude が同じファイルを変更していた場合は、競合を通知します。
• 名前の変更・複製・削除ができます。削除はゴミ箱への移動のみで、.git・.claude には書き込みません。
• 設定 › このブラウザー › 「ファイルエクスプローラーを開く」を「新しいウィンドウで」に変更すると、「ファイル」が別ウィンドウで開き、会話を見ながらファイルを確認できます。

9. タスク · 使用量

• タスク: セッションをまたいで、実行中のバックグラウンドエージェントとワークフロー、直近 24 時間に終了したものを確認できます。
• 使用量: 期間・アカウント・ホストを選んで、推定コスト・リクエスト・出力トークン・キャッシュヒットを前の期間と比較します。アカウントの上限 (5 時間・週間・モデル別の週間) と現在のペースによる予測、日別・モデル別のバー、プロジェクト・セッション別のランキング、曜日×時間のヒートマップがあります。
• コストは API 単価で換算した推定値です。サブスクリプション料金ではありません。

10. 管理 · 設定

• ホスト: 接続状態・バージョン・メトリクス、「ホストを追加」・登録解除、Agent の「今すぐ更新」。
• アカウント · 使用量: Mac ごとの Claude・Ollama アカウントのログイン状態、Web からのログイン・ログアウト。
• モデル: 使用するモデルのオン・オフ、種類別のデフォルトモデル。
• バックアップ: 各 Mac の会話記録を Agent が 10 分ごとに自社サーバーへアップロードします。サーバーの保管領域のサイズ・ディスクの空き容量、ホストごとのバックアップ状態と「今すぐバックアップ」、バックアップされた会話の検索と「復元」(管理者)。復元した会話は 新規セッション › 再開 から開きます。
• 設定: ファイルプレビューの上限・保存期間などのサーバー設定 (管理者)、テーマ・エディターなどのこのブラウザーの設定。

11. スマートフォン · デスクトップで

スマートフォン: Safari の「ホーム画面に追加」でアプリのように起動し、下部のタブ (セッション・通知・タスク・使用量・管理) で切り替えます。承認・質問は通知タブの「セッションで回答」からすぐに移動できます。

デスクトップ: セッション一覧・会話・通知が 3 ペインに並んで表示されます。両側のペインは折りたたんで要約列・アイコン列にでき (このブラウザーが記憶)、ファイルエクスプローラーでは 2 つのファイルを並べて開けます。会話エリアにファイルをドロップすると、すぐにアップロードされます。

12. Web ターミナル

開発者の Mac のシェル (管理 › ホスト › 「ターミナル」) と、claude セッションの実際の tmux 画面 (セッションメニュー › 「ターミナルで表示」) を Web で開きます。その Mac のユーザー権限で動くシェルのため、利用条件を設けています。

• その Mac で直接有効にする必要があります — Web からは有効にできません。無効にすると、開いていたターミナルも閉じます。
• 管理者のみが利用でき、開くたびに OTP をもう一度確認します。開閉・時刻・バイト数は監査ログに残り、キー入力の内容は残しません。30 分間入力がなければ閉じます。
• デスクトップでは別ウィンドウで開きます (設定 › このブラウザー › 「Web ターミナルを開く」)。コンソールのウィンドウを閉じたり再読み込みしたりしても、ターミナルはそのままです。
• ホイール・スワイプ・PgUp/PgDn・Shift+PageUp で過去の出力を表示し、いずれかのキーを押すと元の画面に戻ります。ドラッグで選択するとすぐにコピーされ、⌘+K は画面と過去の出力を、⌘+L は画面だけをクリアします。
• 保持する過去の出力の行数は、設定 › 「Web ターミナル › 履歴の行数」(デフォルト 10,000 行) で決めます。

# その Mac のターミナルで — 有効化 · 無効化 · 状態
~/.ssemtong/bin/ssemtong-agent terminal on
~/.ssemtong/bin/ssemtong-agent terminal off
~/.ssemtong/bin/ssemtong-agent terminal status

13. プロンプト一覧

• 右ペイン (スマートフォンでは「通知」タブ) の「プロンプト」に、そのセッションで人が入力したものだけが新しい順に表示されます — 番号・時刻・先頭 3 行、押すと全文。
• ↳ ボタンを押すと会話内のそのプロンプトへ移動し、一時的に強調表示します。そこから読んでいる間は新しい出力が来ても画面が下へ引っ張られず、「最下部へ」ボタンで戻れます。
• 画面にまだ読み込まれていない過去のプロンプトを選ぶと、その前後の会話をサーバーから読み込んで移動し、「続きの会話を読み込む」で読み進められます。

14. 言語

Web コンソールは韓国語 · English · 日本語 · 简体中文 · Français · Español · Bahasa Indonesia · Tiếng Việt · ភាសាខ្មែរ · العربية に対応しています。上部の 🌐 ボタン (ログイン画面では下部) または 設定 › このブラウザー › 「言語」で選択します。最初はブラウザーの言語に従い、選んだ言語はそのブラウザーが記憶します。サーバー・Agent から送られる一部のメッセージは、まだ韓国語で表示されます。