トラブルシューティング
インストール時に発行元の警告が出ます
Section titled “インストール時に発行元の警告が出ます”ベータビルドはコード署名前のため、SmartScreen/Defender の警告が正常に表示されます。ダウンロードページの「初回実行案内」に従って一度だけ許可すれば、以降は表示されません。インストールファイルが大きく、初回検査に時間がかかることがあります — ウィンドウがすぐに出ない場合は少し待ってから再実行してみてください。
VNCリモート画面
Section titled “VNCリモート画面”新規タブメニュー → VNC接続… または保存された接続。入力項目:
| 項目 | デフォルト値 | 説明 |
|---|---|---|
| ホスト | — | VNCサーバーのIPまたはドメイン |
| ポート | 5900 | VNCのデフォルトポート |
| パスワード | — | VNC認証パスワード |
| 保存名 | — | 入力時に保存された接続に登録 |
SSHトンネルで内部網VNCへアクセス
Section titled “SSHトンネルで内部網VNCへアクセス”接続ダイアログの SSHトンネル オプションを有効にすると、bastion サーバーを経由して内部網VNCにアクセスできます。ファイアウォール外部から直接5900ポートを開く必要がありません。
ヘッダーボタン
Section titled “ヘッダーボタン”| ボタン | 動作 |
|---|---|
| クリップボード送信 | ローカルクリップボードをリモートへ送る |
Ctrl+Alt+Del | リモートPCに Ctrl+Alt+Del を送信 |
| 📁 FT | ファイル転送パネルのトグル |
クリップボードショートカット
Section titled “クリップボードショートカット”Ctrl+Shift+V— ローカルクリップボードをリモートへ送信のみ（貼り付けキーの送信なし）Ctrl+V— 送信 + リモートに貼り付けキーまで送信
ファイル転送（TightVNC 2.x FT）
Section titled “ファイル転送（TightVNC 2.x FT）”ファイル転送パネルの機能:
| 機能 | 方法 |
|---|---|
| フォルダ探索 | 一覧クリック、↑ 上位フォルダ |
| 更新 | ↻ ボタン |
| 新規フォルダ | ➕ ボタン |
| アップロード | ⬆ ボタン（複数ファイル選択可能） |
| ダウンロード | ダブルクリック / 右クリック / チェックボックス選択後にダウンロード |
| 名前変更 / 削除 | 右クリックメニュー |
同名ファイルのアップロード時に上書き確認メッセージが表示されます。
ファイル名が文字化けする場合は、パネル上部のエンコードドロップダウンを変更してください（デフォルトUTF-8）。変更時に自動再接続されます。
VNCトラブルシューティング
Section titled “VNCトラブルシューティング”| 症状 | 原因 | 対処 |
|---|---|---|
| 接続失敗 | ホスト·ポート·パスワードの誤り | 接続情報の再確認、サーバーのVNC稼働有無を確認 |
| 内部網アクセス不可 | ファイアウォール遮断 | SSHトンネルオプションを有効化 |
| ファイル転送パネルがない/エラー | TightVNC 2.x ではないサーバー | TightVNC 2.x サーバーに交換 |
| ファイル名の文字化け | サーバーエンコードの不一致 | エンコードドロップダウンでサーバーのエンコードを選択（例: EUC-KR） |
| 画面は見えるがクリップボードが効かない | サーバークリップボード無効 | VNCサーバー設定でクリップボード共有を有効化 |
WinRM — リモートWindows PowerShell
Section titled “WinRM — リモートWindows PowerShell”新規タブメニュー → WinRM（リモートWindows）…。入力項目:
| 項目 | デフォルト値 | 説明 |
|---|---|---|
| ホスト | — | リモートWindows PCのIPまたはドメイン |
| ユーザー | — | Windowsローカルまたはドメインアカウント |
| パスワード | — | アカウントパスワード |
| ポート | 5985 (HTTP) / 5986 (HTTPS) | HTTPS使用トグルで選択 |
| HTTPS使用 | オフ | オンで5986、オフで5985 |
| 保存名 | — | 入力時に保存された接続に登録 |
リモートPCの前提条件
Section titled “リモートPCの前提条件”リモートPCでPowerShellを管理者として開き、下記のコマンドを実行してください:
Enable-PSRemoting -Forceドメイン環境ではないワークグループまたはIP直接接続の場合、クライアントPCで TrustedHosts を設定する必要があります。接続ダイアログの**「このホストを信頼に追加」**ボタンをクリックすると自動的に処理されます。
手動で設定するには:
# 管理者 PowerShell で実行Set-Item WSMan:\localhost\Client\TrustedHosts -Value "対象IPまたはホスト名" -Force動作方式および制限
Section titled “動作方式および制限”- コンソールにPowerShellコマンドを入力し、Enterで実行します。
- ↑ / ↓ キーでコマンド履歴を探索できます。
- コマンドごとに新しい接続を結ぶ命令型方式です（セッション状態は維持されません）。
Read-Hostのようなインタラクティブプロンプトには対応していません。
WinRMトラブルシューティング
Section titled “WinRMトラブルシューティング”| 症状 | 原因 | 対処 |
|---|---|---|
| 「アクセス拒否」エラー | アカウント権限不足 | 管理者アカウントを使用、またはリモート管理許可グループに追加 |
| 接続できない（ワークグループ） | TrustedHosts 未設定 | ダイアログの「このホストを信頼に追加」をクリック |
| 接続できない（ファイアウォール） | 5985/5986 ポート遮断 | リモートPCのファイアウォールでWinRMポートを許可 |
| WinRMサービスがない | PSRemoting 未有効化 | リモートPCで Enable-PSRemoting -Force を実行 |
| HTTPS証明書エラー | 自己署名証明書 | HTTP(5985)で接続するか、証明書信頼を設定 |
| メニューにWinRMがない | macOSで実行中 | Windows専用機能、Windows PCで使用 |
デスクトップキャプチャ
Section titled “デスクトップキャプチャ”画面領域キャプチャ（📷）
Section titled “画面領域キャプチャ（📷）”タブバーの 📷 ボタン をクリックすると、画面上に透明なオーバーレイが被さります。
- マウスでドラッグしてキャプチャする領域を選択します（外部モニター含む）。
- キャプチャされた画像がマークアップエディタで開きます — 矢印·テキスト·蛍光ペンで注釈を付けられます。
- **「AIに送信」**ボタンをクリックすると、開いているAIチャットに画像が添付されます。
デスクトップミラー（ライブストリーミング）
Section titled “デスクトップミラー（ライブストリーミング）”新規タブメニュー → 🖥️ デスクトップキャプチャ… → ウィンドウ一覧からアプリを選択すると、該当ウィンドウがパネルにライブストリーミングされます（表示専用）。
- AIは
panel_screenshotツールでミラー画面を見られます。 - Webプレビューパネルは ✏️ ボタンでキャプチャしてAIに送信できます。
全体トラブルシューティング
Section titled “全体トラブルシューティング”アプリのクラッシュ·画面が白くなる場合
Section titled “アプリのクラッシュ·画面が白くなる場合”| 症状 | 原因 | 対処 |
|---|---|---|
| 画面が白くなり自動リロード | レンダラープロセスのクラッシュ | 自動復旧される — 正常動作 |
| 30秒以内に3回以上の繰り返しクラッシュ | GPUドライバーまたはメモリの問題 | GPUドライバー更新後に再実行 |
| リロードしても白い画面が続く | 深刻なレンダラーエラー | crash.log 確認後に問い合わせ |
クラッシュログの場所: %APPDATA%\Blyck\crash.log
クラッシュ発生時:
crash.logを開いて最後のエラー内容を確認します。F12で開発者ツールを開き、コンソールタブでエラーを確認します。- 解決しない場合は、
crash.logとlogs\blyck.logを 問い合わせページ に添付してください。
フリーズ·キー入力の遅延
Section titled “フリーズ·キー入力の遅延”| 症状 | 原因 | 対処 |
|---|---|---|
| 5～10秒のフリーズ後に自動復旧 | RAG再インデックスまたはLSP初期化中のメインスレッドブロック | 少し待機 |
| 繰り返しフリーズ | リソース競合 | blyck.log 添付後に問い合わせ |
| AI作業中の長いフリーズ | ターンバックストップ（60分）または2分無応答の処理 | ■ 停止ボタンで強制中断 |
アップデート関連
Section titled “アップデート関連”Blyckはアプリ起動時と4時間間隔で update.blyck.dev からアップデートを確認します。新しいバージョンはバックグラウンドダウンロード後、アプリ終了時に自動インストールされます。
| 症状 | 原因 | 対処 |
|---|---|---|
| アップデートが適用されない | アプリが完全に終了していない | トレイアイコンまで完全終了後に再実行 |
| ダウンロード失敗 | 会社ネットワークのCDN遮断 | IT部門に update.blyck.dev の許可を要請、または手動インストール |
| アップデート確認ができない | オフライン環境 | インターネット接続後に再起動 |
ライセンス関連
Section titled “ライセンス関連”| 症状 | 原因 | 対処 |
|---|---|---|
| 全画面ロック表示 | 14日体験の終了 | ライセンスキーを貼り付けて認証 |
| 「サブスクリプションが期限切れです」 | サブスクリプションの期限切れまたはキャンセル | Lemon Squeezy ポータルでサブスクリプション状態を確認 |
| 認証失敗 | オフライン状態 | ネットワーク接続後に再試行 |
| 「別のデバイスに登録済み」 | デバイス登録超過 | Lemon Squeezy ポータルでデバイス管理 |
| 認証後7日経過してロック | オフライン grace period 超過 | インターネット接続後にアプリ再起動で再検証 |
DB接続関連
Section titled “DB接続関連”| 症状 | 原因 | 対処 |
|---|---|---|
| 接続タイムアウト | ネットワーク·ファイアウォール遮断 | ホスト·ポート·ファイアウォールルールを確認。PG/MySQL 10秒、MSSQL 15秒 |
Oracle ORA-xxxxx | サーバー側のエラー（サービス名·アカウントロックなど） | サーバー接続情報を再確認 |
Oracle NJS-116 | Thinモード非対応環境 | Thick強制チェック + 64ビット Instant Client パス設定 |
Oracle NJS-118 | Thick初期化エラー | アプリ再起動後に再試行 |
| MySQL BIGINT の文字列表示 | 2^53 超過の精度保護 | 正常動作 — バグではない |
| 接続プールセッションの急増 | — | プール（最大4個）で自動管理される、問題なし |
詳細なDB関連の問題は DBクライアント ページを参照してください。
Webプレビュー関連
Section titled “Webプレビュー関連”| 症状 | 原因 | 対処 |
|---|---|---|
| ページがロードされない | 開発サーバー未実行 | ローカル開発サーバーを先に実行後にURLを入力 |
preview_eval が即座に失敗 | ページがまだロード中 | preview_wait ツール後に再試行 |
| 画面が空のまま停止 | URLエラーまたはサーバーエラー | URLとサーバー状態を確認 |
詳細は 実行 · プレビュー ページを参照してください。
RAG検索関連
Section titled “RAG検索関連”| 症状 | 原因 | 対処 |
|---|---|---|
| 結果がない/古いファイルが表示 | インデックス未更新 | チャット設定 → RAGインデックス状態を確認 |
| 削除したファイルが検索される | Orphan項目 | Orphan Scan 清掃ツールを実行 |
| 結果がノイズすぎる | 不要ファイルのインデックス | .termeditignore で除外パターンを追加 |
| 埋め込みモデル変更後に結果が異常 | 再インデックス進行中 | 再インデックス完了まで待機 |
RAGインデックス管理は RAG検索 ページを参照してください。
SSH接続関連
Section titled “SSH接続関連”| 症状 | 原因 | 対処 |
|---|---|---|
| パスワード入力で止まる | 非標準プロンプト（検出待ち最大30秒） | 直接入力するか、パスワード保存を使用 |
| 自動再接続失敗 | パスワード専用サーバー（再接続時にパスワード未再利用） | キー/agent認証を設定、または手動再接続 |
| SFTPのみ失敗 | SFTPサブシステム無効 | ファイルパネルから手動で再接続 |
| 日本語の文字化け | サーバーのロケール | サーバー locale で *.UTF-8 を確認 |
詳細は ターミナル · SSH · SFTP ページを参照してください。
AI機能関連
Section titled “AI機能関連”| 症状 | 原因 | 対処 |
|---|---|---|
| AIチャットが無効 | CLI未インストールまたは未ログイン | 準備ウィザードでCLIのインストール·ログイン |
| 401/403 エラー | APIキーの期限切れまたは不正 | キー再登録または claude login を再実行 |
| 応答が来ない / 止まる | ネットワークまたは認証の期限切れ | 自動リトライ3回後に再ログイン、新しいチャットを開始 |
| 承認カードなしでファイルが変更される | 🚀 自動モード有効 | Ctrl+3 で ⚡ 実行+レビューモードに切り替え |
詳細は AIチャット ページを参照してください。
LSP自動入力関連
Section titled “LSP自動入力関連”| 症状 | 原因 | 対処 |
|---|---|---|
| Python自動入力ができない | Pyright 未インストール | 最初のPythonファイルを開くときの「ダウンロード?」モーダルを承認 |
| Go自動入力ができない | Goツールチェーンなし | Goインストール後に go install golang.org/x/tools/gopls@latest |
| Rust自動入力ができない | rust-analyzer のダウンロード失敗 | GitHubにアクセスできる環境でアプリ再起動、または手動インストール後にPATH登録 |
| 会社ネットワークでダウンロード失敗 | GitHub遮断 | 該当サーバーを直接インストールしてPATHに登録 |
ターミナル表示関連
Section titled “ターミナル表示関連”| 症状 | 原因 | 対処 |
|---|---|---|
| 文字がぼやける | WebGLフォールバック（Canvas/DOM） | 設定でCanvasレンダラーを明示指定 |
| 全角文字の整列崩れ | DOMレンダラー使用中 | 設定でCanvasレンダラーを指定 |
| 日本語の文字化け（ローカル） | — | WindowsはUTF-8を自動適用、ipconfig などのネイティブexeはPowerShell cmdletで代替 |
誤った変更を取り消したいです
Section titled “誤った変更を取り消したいです”Ctrl+Shift+H で変更履歴を開くと、ファイル·DB·SSHの変更がすべて記録されています。項目を選択して取り消ししてください。DMLは実行直前のデータが自動バックアップされるため、WHERE なしの UPDATE も復旧できます。
詳細な動作は Git · ChangeSet ページを参照してください。
ログ·データの場所（Windows）
Section titled “ログ·データの場所（Windows）”| 項目 | 場所 |
|---|---|
| アプリログ | %APPDATA%\Blyck\logs\blyck.log（2MBローテーション） |
| クラッシュログ | %APPDATA%\Blyck\crash.log |
| 接続情報（パスワード除く） | %APPDATA%\Blyck\connections.json |
| レイアウト（タブ·分割） | %APPDATA%\Blyck\layout.json |
| AIチャット記録 | %APPDATA%\Blyck\chats\ |
| 変更履歴（ChangeSet） | %APPDATA%\Blyck\blyck-history.db |
| RAGインデックス | ワークスペースごとのSQLiteファイル |
パスワードとトークンはファイルではなく、OS の資格情報ストアに暗号化保管されます。ログにはパスワード·トークン·APIキー·ユーザーパスが自動マスキングされ、ローカルにのみ保存され、外部に送信されません。
その他の問題
Section titled “その他の問題”解決しない問題は 問い合わせページ へ送ってください。環境情報（OS·バージョン）と再現手順を一緒に書いていただくと、迅速にサポートできます。Blyckが内部的に開く補助サーバー（MCP·VNCプロキシなど）は、すべて localhost 動的ポート + トークン認証 でのみ開かれるため、ファイアウォールの例外やポート開放は不要です。