ターミナル · SSH · SFTP
Blyckのターミナルは xterm.js ベースで、ローカルシェル·SSHリモートセッション·ファイルツリー·SFTPリモートツリーを同じ方式のパネルで扱います。パネルを分割して複数のサーバーを同時に管理し、SFTPでリモートファイルをローカルのように編集してください。
リモート側インストールゼロ（zero-install remote）
Section titled “リモート側インストールゼロ（zero-install remote）”Blyckでリモートサーバーを扱うとき、サーバーには何もインストールしません。 リモート側の要件は sshd 1つだけです。
VS Code Remote-SSH でAIを使うには、リモートマシンごとに Claude Code·Codex のようなAI CLI と拡張·ランタイム（Node）をインストールし、サーバーを変えるたびにインストール·ログインを繰り返す必要があります。閉域網やインストール権限のないサーバーでは詰まることもあります。Blyckは Claude Code·Codex をローカル（自分のPC）で実行し、ファイル操作はSFTP·コマンドはSSHで転送します。
- AI CLI インストール不要 — Claude Code·Codex が自分のPCで動きます。リモートサーバーにはインストールされません。
- 閉域網·権限のないサーバーOK — sshd さえ開いていれば動作します。
- キー·認証はローカル一か所 — サーバーごとにAPIキーやログインセッションを置く必要がありません。
- サーバーに痕跡なし — エージェントプロセスやキャッシュがリモートに生成されません。接続を切れば終わり。
ローカルターミナル
Section titled “ローカルターミナル”シェル自動検出
Section titled “シェル自動検出”設定なしでも、OSに合ったシェルを自動的に選択します。
| 環境 | 自動選択順序 |
|---|---|
| Windows | PowerShell 7+ → PowerShell 5.1 → cmd.exe |
| macOS / WSL | bash · zsh（LANG=en_US.UTF-8 自動適用） |
スクロールバック検索 · フォント
Section titled “スクロールバック検索 · フォント”- スクロールバックバッファ 10,000行 —
Ctrl+Fで検索します（正規表現対応）。 Ctrl+=/Ctrl+-/Ctrl+0— フォントサイズ調整。ターミナル·ファイルツリー·エディタ·チャットの領域ごとに別々に保存されます。
スマート出力 — クリックすると動作します
Section titled “スマート出力 — クリックすると動作します”- URL — クリックするとデフォルトブラウザで開きます。
- ファイル名のダブルクリック —
ls出力などでファイルをダブルクリックするとエディタで開き、フォルダならcd後に一覧を表示します。 - 現在のディレクトリ追跡 — シェルが知らせる位置（OSC 7）をパネルヘッダーに常に表示します。
edit <ファイル>— ターミナルで入力すると、該当パネルがそのファイルのエディタに切り替わります。
日本語が文字化けしない理由
Section titled “日本語が文字化けしない理由”- D2Coding フォントバンドル — OSにフォントがなくても日本語·CJKが正しく表示されます。
- Windows UTF-8 初期化 — PowerShell の出力エンコードを自動的に UTF-8（65001）に合わせます。
- 非ASCIIコマンドの安全な転送 —
-EncodedCommand（Base64 UTF-16LE）で転送し、CP949 の会社PCでも文字化けしません。
リモートサーバーで日本語が文字化けする場合は、サーバーの LANG 環境変数が *.UTF-8 か locale コマンドで確認してください。
ターミナルから直接AI — /claude
Section titled “ターミナルから直接AI — /claude”シェルプロンプトからスラッシュコマンドでAIを即座に呼び出します。
| コマンド | 動作 |
|---|---|
/claude <質問> | テキスト回答のみ（ファイル·コマンド権限なし） |
/claude? <質問> | 直近のターミナル出力をコンテキストとして含めて質問 — たった今出たエラーをそのまま尋ねるとき |
/claude! <質問> | ファイル · コマンド実行権限を付与 |
/claude!? <質問> | 出力コンテキスト + 実行権限 — 「このエラーを直して」の一行で完結 |
パネル · タブ · サブタブ
Section titled “パネル · タブ · サブタブ”| ショートカット | 動作 |
|---|---|
Ctrl+Shift+T | 新規タブ |
Alt+1 ~ Alt+8 | タブ切替 |
Ctrl+\ | 左右分割 |
Ctrl+Shift+- | 上下分割 |
Ctrl+Tab | パネル循環 |
Ctrl+` | サブタブ循環 |
Alt+Enter | パネルズーム |
区切り線をドラッグすると比率を自由に調整できます。バックグラウンドのサブタブのセッションも生き続けるため、複数のサーバーを1つのパネルに重ねて、切り替えながら作業できます。
Ctrl+Shift+Sまたは+メニュー → SSH接続… を選択- ユーザー名·ホスト·ポート（デフォルト22）を入力し、必要ならパスワードを入力します。
- 「このパネルに」または「新しいタブで」を選択して接続します。
パスワードを空にしておくと、次の順序で自動的に試みます。
- ssh-agent —
SSH_AUTH_SOCK環境変数または Windows OpenSSH エージェントパイプ - デフォルトキーファイル —
~/.ssh/id_ed25519→id_rsa→id_ecdsaの順序 - シェルパスワードプロンプト — 上記すべて失敗時にサーバーが直接要求
パスワードを入力すると、プロンプト検出時に自動的に1回入力します。また、同じホストの SFTP がバックグラウンドで自動接続されます。
Keepalive
Section titled “Keepalive”接続中は 30秒間隔 で keepalive パケットを送信し、アイドル状態での切断を防止します。
SSHセッションが異常終了すると、漸進的な待機間隔で自動再接続を試みます。
1秒 → 2秒 → 4秒 → 8秒 → 16秒 → 30秒 → 30秒 … (最大10回)- 待機中にいずれかのキーを押すと再接続をキャンセルします。
- 再接続成功時にセッションが自動復旧されます。
ファイルツリー
Section titled “ファイルツリー”Ctrl+Shift+E または + メニュー → ファイルツリー
キーボードショートカット
Section titled “キーボードショートカット”| キー | 動作 |
|---|---|
↑ / ↓ | 項目移動 |
→ / ← | 展開 / 折りたたみ |
Enter | 進入 / 開く |
Backspace | 上位フォルダへ |
: | 任意のパスへ移動 |
Space | 選択（複数選択可能） |
y / x / p | コピー / 切り取り / 貼り付け |
d | 削除 |
r または F2 | 名前変更 |
n / N | 新規ファイル / 新規フォルダ |
R | 更新 |
c | ターミナルシェルにパスを送信 |
a | AIチャットに @添付 |
ファイルを開くサイズポリシー
Section titled “ファイルを開くサイズポリシー”| ファイルサイズ | 動作 |
|---|---|
| ≤ 2 MB | Monacoエディタで開く |
| 2 MB ~ 32 MB | 読み取り専用で開く（タブに [読み取り専用] 表示） |
| > 32 MB | OS標準アプリ案内 |
| 画像 / PDF | 内蔵ビューア |
| Office / 圧縮ファイル | OS標準アプリで開く |
Gitバッジ（ローカルツリー）
Section titled “Gitバッジ（ローカルツリー）”ローカルファイルツリーでは、Git状態をファイルの横にバッジで表示します。
| バッジ | 意味 |
|---|---|
? | Untracked（追跡されていない） |
+ | Staged（ステージング済み） |
- | Deleted（削除済み） |
! | Conflict（競合） |
リモートSFTPツリーでは Git バッジは表示されません。
SFTPリモートツリー
Section titled “SFTPリモートツリー”Ctrl+Shift+F または + メニュー → SFTPリモートツリー…
ユーザー·ホスト（必須）·ポート（22）·パスワード（キー認証なら空欄）·キーパス·キーパスワード·保存名を入力します。
認証順序: 明示されたキー → ssh-agent → ~/.ssh のデフォルトキー → パスワード
リモートファイル編集
Section titled “リモートファイル編集”SFTPツリーでテキストファイルをダブルクリックすると Monaco エディタで開きます。Ctrl+S で保存すると即座にリモートにアップロードされ、変更は ChangeSet に自動記録されて取り消せます。
シンボリックリンクはツリーで別の色で区別表示されます。
ファイルアップロード · ダウンロード
Section titled “ファイルアップロード · ダウンロード”同じタブにローカルファイルツリーとSFTPリモートツリーを並べて開いておくと、u/g キーで素早く転送できます。
| 方向 | 方法 |
|---|---|
| アップロード（ローカル → リモート） | ローカルツリーで Space で選択 → u |
| ダウンロード（リモート → ローカル） | SFTPツリーで Space で選択 → g |
- フォルダは再帰転送されます。
- 進行状況はステータスバーに「N個 → user@host」と表示されます。
- 同じタブに反対種類のツリーがないと案内メッセージが表示されます。
右クリックメニューからもアップロード·ダウンロード·新規フォルダ·名前変更·削除を使用でき、サーバー間の直接転送（ローカルを経由しない）も対応します。
保存された接続
Section titled “保存された接続”SSHまたはSFTPダイアログで「保存名」を入力して接続すると、接続が保存されます。次回からは一覧からクリック1回ですぐに接続できます。
パスワードのセキュア保存
Section titled “パスワードのセキュア保存”パスワードとキーパスワードは OS キーチェーン で暗号化されて保存されます。
- Windows: DPAPI（ユーザーアカウントバインディング）
- macOS: Keychain
connections.json には暗号化された値のみが保存され、平文はメモリにのみ存在します。
保存された接続はフォルダを作ってチーム·環境別にグループ化できます。
リモートプロジェクトフォルダ（AIチャット連携）
Section titled “リモートプロジェクトフォルダ（AIチャット連携）”AIチャット の作業フォルダとして SSH/SFTP リモートフォルダを指定できます。
- AIチャットパネル上部の 📁 フォルダチップをクリック
- リモート（SSH/SFTP）接続… を選択
- サーバー選択 → フォルダ選択
設定後、チップは user@host:/path · リモート SFTP と表示されます。
指定すると、AIのファイルツール（file_read / file_write / file_list_dir）が自動的に SFTP パスへルーティングされます。リモートファイルの変更も ChangeSet に記録されて取り消せます。
リモートデスクトップが必要なときは内蔵VNCビューアを使用します。
- ホスト:ポート入力で接続、VNCパスワード認証に対応
- 画面自動フィット — パネルサイズに合わせてリモート画面が自動スケールされます。
- クリップボード双方向 — リモート → ローカルは自動同期、ローカル → リモートは
Ctrl+Vまたはクリップボード送信ボタン - SSHトンネルオプション — ジャンプサーバーを経由して内部網VNCにアクセス（ローカルポート自動マッピング）
- ファイル転送タブ — TightVNC プロトコルベースのアップ/ダウンロード。ファイル名のエンコード（UTF-8·Windows-949·Shift-JIS など）をオプションで選択できます。
WinRM — リモートWindows管理
Section titled “WinRM — リモートWindows管理”SSHを開けないWindowsサーバーは WinRM パネル で管理します。
- PowerShellコマンドがリモートで実行されます。
- 日本語コマンドも
-EncodedCommand処理で安全です。 - AIに委任すると、照会コマンド（
Get-*）は自動実行され、変更コマンド（Set-/Remove-/Restart-など）は確認を経ます。
AIと一緒に
Section titled “AIと一緒に”AIチャットはアクティブなSSHパネルを認識します。自然言語でコマンドを委任すると、AIが ssh_exec ツールで実行し、出力を収集して回答します。
▸ このサーバーの nginx 設定ファイルを見せて▸ /var/log で最も大きいファイルを5個見つけてAIはコマンドを作る前に ssh_probe_env でサーバー環境（OS·initシステム·パッケージマネージャー·コンテナ有無·メモリ·ディスク·インストール済みツールのバージョン）を把握します。apt/yum、systemd/sysvinit の違いで誤ったコマンドを作りません。
読み取りコマンドは自動実行されますが、書き込み·危険なコマンド（rm、chmod など）は実行前に確認ダイアログを経ます。詳細は AIチャット › ツール承認 を参照してください。
Q. SSH接続ができません。
ホスト·ポート（デフォルト22）·ファイアウォール·ユーザー名を確認してください。キー認証なら、~/.ssh のキーファイルが存在し、サーバーの authorized_keys に登録されているか確認してください。
Q. 自動再接続が失敗し続けます。
自動再接続時にパスワードを再利用しません。キーまたは ssh-agent 認証が動作してこそ自動復旧されます。パスワードのみをサポートするサーバーは Ctrl+Shift+S で手動再接続してください。
Q. リモートサーバーで日本語が文字化けします。
サーバーの LANG 環境変数が *.UTF-8 か locale コマンドで確認してください。ローカルのWindowsターミナルはBlyckが自動的にUTF-8を適用します。
Q. ファイル転送（u/g）が動作しません。
同じタブにローカルファイルツリーとSFTPリモートツリーを両方開く必要があります。アップロードはローカルツリーで、ダウンロードはSFTPツリーで選択します。
Q. 保存された接続を別のPCに移したらパスワードを再び聞かれます。
パスワードはOSアカウントにバインドされた暗号化キーで保護されます。別のPC/アカウントにコピーすると復号されないため、再入力が必要です。これはセキュリティ上意図された動作です。
Q. リモートプロジェクトフォルダで RAG 検索ができません。
リモートSFTPフォルダは現在 RAG インデックスの対象ではありません。AIが file_list_dir と file_read ツールでリモートコードを直接探索します。ローカルフォルダなら 統合検索 を使ってみてください。