サーバー管理

サーバータブは ServerCC のメインエントリーポイントです。ここからすべてのリモートサーバーの追加、編集、管理を行えます。

サーバーの追加

サーバータブの右上にある + ボタンをタップして新しいサーバーを追加します。

サーバー情報

  • サーバー名 — サーバーを識別するためのわかりやすい名前（例：「開発サーバー」「本番環境」）
  • ホスト — サーバーの IP アドレスまたはホスト名
  • ポート — SSH ポート（デフォルトは 22）
  • ユーザー名 — SSH ログイン用のユーザー名

認証方式

ServerCC は2つの認証方式に対応しています：

  • パスワード — SSH パスワードを直接入力します。iOS キーチェーンに安全に保存されます。
  • 秘密鍵 — インポート済みの SSH 鍵を選択します。Ed25519 および RSA 鍵に対応しており、パスフレーズ付きの鍵もサポートしています。詳細は SSH 鍵をご覧ください。
ヒント

SSH 鍵をまだお持ちでない場合は、サーバー追加フォームから直接作成できます。SSH 鍵を追加をタップすると、その場で鍵の生成またはインポートが行えます。

環境変数

サーバー接続時に設定される環境変数を構成できます。よく使われる変数は以下の通りです：

  • ANTHROPIC_BASE_URL — カスタム API ベース URL（プロキシや代替エンドポイント用）
  • ANTHROPIC_AUTH_TOKEN — Anthropic API の認証トークン

ワークフローに必要な任意の環境変数をカスタムのキーと値のペアとして追加することもできます。

Tailscale

サーバーが Tailscale ネットワーク上にある場合、システム全体の Tailscale VPN をインストールせずに接続できます。Tailscale 経由で接続をオンにして、Tailscale の Auth Key を貼り付けます。ホストフィールドには Tailscale IP（例：100.x.y.z）または MagicDNS ホスト名を使用します。

詳細は 内蔵 Tailscale ガイドをご覧ください。

ワークスペースルートディレクトリ

ワークスペースルートディレクトリは、ServerCC がサーバー上でワークスペースを作成・管理する場所です。デフォルトは ~/.servercc です。この設定はサーバー作成後に変更できません。

サーバー詳細

リスト内のサーバーをタップすると詳細画面が表示されます。ここでは以下のことが行えます：

接続状態

サーバー詳細ページにはリアルタイムの接続状態インジケーターが表示されます。緑のチェックマークはサーバーに到達可能であることを示します。エラーがある場合は、ステータスをタップすると詳細なエラーメッセージを確認できます。

Claude Code のインストール

Claude Code セクションでは、サーバーに Claude Code と Codex がインストールされているかどうかとそのバージョンが表示されます。ここから以下の操作が行えます：

  • Claude Code をインストール — ワンタップでインストール、リアルタイムで進捗を表示
  • Claude Code をアップグレード — 最新バージョンに更新
  • Claude Code の設定 — このサーバーでの Claude Code の動作を設定

Claude Code や Codex が ServerCC の自動検出できない場所にインストールされている場合（非標準のプレフィックス、バージョンマネージャー、特殊なシェル設定など）、カスタムパスを手動設定をタップしてファイルブラウザでバイナリを選択してください。ステータスはインストール済み（カスタムパス）と表示されます。カスタムパスはアプリ内アップグレードに対応していません — CLI を自分で更新すれば、ServerCC が新しいバージョンを認識します。

ツール

ツールセクションには、サーバーレベルのユーティリティがまとまっています：

  • ターミナル — Claude Code/Codex を使わない直接の SSH シェル — システムコマンドの実行、ログの確認、一般的なサーバー管理に便利です
  • VNC — サーバーのリモートデスクトップに接続 — VNC リモートデスクトップを参照
  • ポート — リスニング中の任意のポートを HTTP でアプリ内ブラウザで開く — ポートアクセスを参照

サーバーの編集と削除

サーバーリストでは：

  • 左にスワイプ すると編集ボタンが表示されます。サーバー名、ホスト、ポート、認証情報、環境変数を変更できます
  • 右にスワイプ すると削除ボタンが表示されます。サーバーとそのすべてのワークスペースが完全に削除されます
注意

サーバーを削除すると、ServerCC 上の関連するすべてのワークスペースも削除されます。サーバー上のファイル自体は削除されません。

接続管理

ServerCC は SSH 接続を自動的に管理します：

  • コネクションプーリング — 接続は各機能間で共有・再利用されます
  • ハートビート — 30秒間隔のハートビートで接続を維持します
  • 自動再接続 — 切断された接続は自動的に再確立されます
  • アイドルクリーンアップ — 60秒間使用されていない接続は自動的に切断されます