← Luna ホーム はじめる前の診断 テスターガイド 導入ガイド セキュリティ説明
Troubleshooting

Luna AI トラブルシューティング

Luna AI の利用中に発生しやすいトラブルと、その対処法をまとめました。解決しない場合は、最後の「サポートへの連絡方法」までご連絡ください。

目次
  1. 新しいAIセッションでフォルダを開けない
  2. 「開発元未確認」またはcommandの警告が出る
  3. AIがZIPや説明ファイルを読み取らない
  4. Claude Code／Codexを起動できない
  5. スキルが発動しない
  6. 契約コード未設定と表示される
  7. アップデートが失敗する
  8. 別のMacでも使いたい
  9. データが消えた・見つからない
  10. 動作が遅い・重い
  11. サポートへの連絡方法
  12. Windows特有のトラブル
  13. 「デベロッパツール」のインストール画面が出る（Mac）
  14. 「キッティング始めて」と言ったのに普通の会話になる

0. 新しいAIセッションでフォルダを開けない

症状

Claude CodeまたはCodexでLunaのフォルダを開こうとすると、信頼確認が出る、フォルダが添付できない、または通常の会話だけが始まる。

原因

初めて開くフォルダには、AIが読んでよいかを確認する安全確認が出ることがあります。また、ZIPのままでは入口ファイルを正しく読めません。

対処法

  1. OSに合うLuna ZIPを展開し、ZIPとは別にできた通常フォルダを確認する
  2. Claude CodeまたはCodexで新しいセッションを作り、その展開済みフォルダを開くか添付する
  3. 信頼確認が出た場合だけ、内容を確認して信頼するを選ぶ
  4. 入力欄に「AI_AGENT_START_HERE.mdを最初に読んで、Lunaを適用して」と送る
この段階では「キッティング始めて」は使いません。Lunaの適用完了後に、さらに新しいセッションでluna-workを開いてから使う合言葉です。

1. 「開発元未確認」またはcommandの警告が出る

症状

ZIPの中にあるcommand、cmd、ps1ファイルを直接開いた際に、OSの警告が出る。

対処法

警告を回避するためにcommandを直接実行しないでください。現在の正規手順では、利用者がそれらのファイルを開く必要はありません。警告を閉じ、展開済みフォルダを新しいClaude CodeまたはCodexセッションに渡し、「AI_AGENT_START_HERE.mdを最初に読んで、Lunaを適用して」と送ります。

AIが必要な正規インストーラだけを選び、状態を確認します。ターミナル操作、別サイトからの取得、ファイルの手動置換は行わないでください。

2. AIがZIPや説明ファイルを読み取らない

症状

AIが一般的な説明を返す、ZIPを読むだけで適用が進まない、またはチェック結果が返らない。

原因

ZIPをそのまま渡している、既存の会話を使っている、または入口ファイルを読む指示が不足している可能性があります。

対処法

  1. ZIPを展開し、AI_AGENT_START_HERE.mdとLUNA_SETUP_CHECKLIST.mdが同じ通常フォルダにあることを確認する
  2. Claude CodeまたはCodexの新しいセッションで、その通常フォルダを開くか添付する
  3. 「AI_AGENT_START_HERE.mdとLUNA_SETUP_CHECKLIST.mdを最初に読み、Lunaを適用して」と送る
  4. 最後に「初回／更新」「適用版」「Doctor結果」「未完了項目（なければなし）」が返ることを確認する

3. Claude Code／Codexを起動できない

症状

Claude CodeまたはCodexのアプリを起動できない、ログインできない、または新しいセッションを作れない。

対処法（順番にお試しください）

  1. アプリを完全に閉じてから開き直す
  2. ご利用サービスの公式アプリ／公式案内から、Claude CodeまたはCodexにログインする
  3. 新しい会話または新しいタスクを作成し、フォルダの添付・選択ができる状態にする
  4. それでも開始できない場合は、表示された画面とMac／Windowsの別をサポートへ送る

4. スキルが発動しない（話しかけても反応がない）

症状

Claude CodeまたはCodexに「議事録まとめて」と話しかけても、Luna スキルが起動せず、汎用的な返答しか返ってこない。

原因と対処法

原因対処
Luna の適用が未完了OS用ZIPを展開し、新しいAIセッションでAI_AGENT_START_HERE.mdを最初に読ませて適用する
スキルの状態が確認できないAIに「Doctorを実行して、未完了項目を教えて」と依頼する
適用後の新しいセッションを使っていないluna-workを開いた新しいセッションで依頼し直す
話しかけ方がスキルの発動条件と合っていない「議事録にして」等、具体的な作業内容を明示して話しかけ直す

確認方法

Claude CodeまたはCodexに、次のように伝えてください。適用版と未完了項目を含む診断結果を返します。

Doctorを実行して、Lunaの状態と未完了項目を教えて

5. Portalに「契約コード未設定」「契約登録の確認が必要」と出る

端末情報や契約コードを利用者が手入力する必要はありません。契約コードをチャット、メール本文、スクリーンショットへ貼らないでください。

  1. 利用者名と管理IDを導入担当者が台帳で照合する
  2. その管理ID専用の配布一式だけを使い、別人のファイルや共通コードで代用しない
  3. 端末側に別の管理IDが保存済みなら誤配布として停止する。管理IDが無い旧形式だけは、表示された管理IDを本人へ示し「このPCをこの管理IDとして修復しますか？」と確認する
  4. AIが変更内容を説明し、「登録しますか？」への本人の承認後だけ修復する
  5. 顧客専用ファイルを同じ配布フォルダ内でローカル読取し、既存USER_ID、記憶、案件、自作スキルを維持する
  6. Doctorで「契約と端末の設定」が正常、Portalで契約確認済みになったことを確認する
通信できず契約登録の確認だけが終わらない場合は、完了と報告せず「確認待ち」とします。顧客ファイルは削除・移動しません。

6. アップデートが失敗する

症状

「アップデート中にエラーが発生しました」と表示される、またはお知らせメールが届いたのに反映されない。

対処法

  1. ディスクの空き容量を確認（最低5GB推奨）
  2. 4.2.9への更新は、案内ページからお使いのMac／Windows用ZIPを取得します。4.2.6以前・現在版が不明な方も、この新しい更新入口を使います
  3. ZIPを展開し、新しいClaude CodeまたはCodexのセッションでそのフォルダを開きます。案内ページの「AI_AGENT_START_HERE.mdを最初に読んで…」の文章を送り、今のLunaフォルダを更新対象として確認します
  4. 更新後に「適用版」とDoctor結果、未完了項目（なければ「なし」）が返ることを確認します
  5. それでも失敗する場合は繰り返し実行せず、フォルダを削除・置換せず、止まった画面とMac／Windowsのどちらかを公式LINEへお送りください。契約コード・個人情報は隠してください
※ 旧版でも、現在のLunaフォルダを削除したり、新しいフォルダで丸ごと置き換えたりしないでください。正規の更新経路は、記憶・案件・自作スキル・個人設定を保持します。
昔の設定が原因と表示された場合：旧LunaやClaudeの設定フォルダを手作業で丸ごと削除しないでください。4.2.9はLunaの旧設定との競合を保護付きで補修します。契約情報が未設定の初期デモ環境は、個別のご案内が必要です。

7. 別のMacでも使いたい

症状

新しいMacを購入した、または別のMacでも使いたい。

対応

新しいMacでも、同じ契約で認められた台数の範囲で、Claude CodeまたはCodexへログインし、導入担当者が確認した顧客専用ZIPを使います。契約コードはチャットへ入力せず、正規インストーラがローカルで読み取ります。台数・席数が不明な場合はサポートへご確認ください。

移行手順

  1. 新しいMacでClaude CodeまたはCodexにログインする
  2. Mac用ZIPを展開し、新しいAIセッションへ展開済みフォルダを渡す
  3. 「AI_AGENT_START_HERE.mdを最初に読んで、Lunaを適用して」と送る
  4. これまでのナレッジ・記憶を引き継ぎたい場合は、元のMacの ~/luna-work/ をAirDropまたは外付けSSD等で新しいMacの同じ場所にコピーする。既存のファイルを削除・置換する前に、AIの確認結果を待つ
※ iCloud Drive等のクラウド同期フォルダ経由でのコピーは非推奨です。luna-work をクラウド同期フォルダの中に置くと、意図しない社外共有の入り口になります。移行時も、セットアップ時の既定の場所から既定の場所へ、AirDropまたは外付けディスクで直接コピーしてください。

8. データが消えた・見つからない

症状

昨日まであった議事録ファイルが見当たらない。

確認順序

  1. 検索アプリで探す：Spotlight（⌘＋Space）でファイル名の一部を入力
  2. 既定の保存先を確認：~/luna-work/ 配下（案件・ナレッジ・vault等のサブフォルダ）
  3. Time Machine で復元：macOS の Time Machine を使えば、削除前の状態に戻せます
  4. ゴミ箱を確認：誤って捨てていないか
※ Luna AI 自体が勝手にファイルを削除することはありません。「明らかにLuna側の問題」と思われる場合は、すぐにサポートまでご連絡ください。

8. 動作が遅い・重い

症状

Claude Code の応答が遅い、Mac全体が重くなる。

原因と対処法

原因対処
メモリ不足他のアプリ（Chrome等）を閉じる
大容量ファイル処理中完了まで待つ（議事録30分越えは数分かかる場合あり）
Claude API側の混雑5〜10分後に再試行
ディスクが満杯空き容量を5GB以上確保
ナレッジ蓄積が膨大定期メンテナンス（自動・毎週）を待つ

9. サポートへの連絡方法

連絡先

以下の窓口で承ります。画面のスクリーンショットを添えていただくと、解決が早くなります。

連絡先ご連絡方法
support@lunatech-inc.com症状とスクリーンショットを添付

ご連絡時にお伝えいただきたい情報

  1. お客様のお名前・会社名
  2. Lunaのバージョンと契約状態（有効・停止など）
  3. 発生している症状（できればスクリーンショット）
  4. エラーメッセージ（あれば全文コピー）
  5. 直前に何をしたか（「インストール直後」「アップデート後」など）

診断情報の取得

サポート時に診断情報を求められたら、Claude CodeまたはCodexに次のように依頼してください。お客様の業務ファイルの中身を送らず、版・Doctor結果・未完了項目だけを共有してください。

Doctorを実行して、バージョン・状態・未完了項目だけを報告して

緊急時

業務が完全に止まる重大な障害の場合は、件名に【緊急】とお書きの上、上記メールへご連絡ください。

10. Windows特有のトラブル

Windows版は正式対応しています。Windows用ZIPを右クリックして「すべて展開」し、展開後の通常フォルダをClaude CodeまたはCodexの新しいセッションへ渡してください。

症状：PowerShell、cmd、ps1の警告や赤い文字が出る

これらを直接実行する必要はありません。画面を閉じ、Windows用ZIPを展開した通常フォルダをAIに渡して、「AI_AGENT_START_HERE.mdを最初に読んで、Lunaを適用して」と送ってください。

症状：Windows版を開いてもLunaが反応しない

ZIPを右クリックして「すべて展開」し、ZIPとは別にできた通常フォルダをClaude CodeまたはCodexの新しいセッションで開くか添付してください。入力欄へ「AI_AGENT_START_HERE.mdを最初に読んで、Lunaを適用して」と送ります。cmdやps1を直接開いたり、.claudeを手動配置したりする必要はありません。

利用状況送信は説明を確認して同意した場合だけONになります。送るのは導入成否・版・OS・利用回数などの運用数値で、会話・記憶・ファイル・端末名は送りません。OFFでも設置は正常に完了します。上記で解決しない場合は症状のスクリーンショットを添えて担当者へご連絡ください。

11. 「デベロッパツール」のインストール画面が出る（Mac）

症状

旧版のcommandを直接実行した際に、開発用ツールのインストール画面が出る。

原因

旧版の経路が開発用ツールを要求しています。現在の配布物では利用者がGitや開発用ツールを入れる必要はありません。

対処法

画面で開発用ツールを追加せず、OS用ZIPの現行版を取得してください。展開済みフォルダを新しいAIセッションへ渡す正規手順であれば、この画面は不要です。

12. 「キッティング始めて」と言ったのに普通の会話になる

症状

claude に「キッティング始めて」と話しかけたのに、初期設定が始まらず、「キッティングとは一般に◯◯のことです」のような普通の説明・雑談が返ってくる。

原因

Luna がまだそのパソコンに入っていません。この合言葉は、OS用ZIPを展開し、Claude CodeまたはCodexの新しいセッションで「AI_AGENT_START_HERE.mdを最初に読んで、Lunaを適用して」が完了したあとに初めて意味を持ちます。ログインまで終わった時点で先に話しかけてしまうのが典型パターンです。

対処法

  1. いまのCode画面を閉じる
  2. 導入ガイドの Step 4へ進み、新しいAIセッションで展開後フォルダを開くか添付して「AI_AGENT_START_HERE.mdを最初に読んで、Lunaを適用して」を完了する
  3. 新しいCode画面でAIが報告した作業フォルダを開き、「キッティング始めて」と話しかける
Luna AI は「眠らない右腕」として、トラブル時もお客様を支えます。
解決しないときは遠慮なくサポートまで。
Luna AI by 株式会社LunaTech