> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 環境の問題

> システム環境と設定の問題をトラブルシューティング

システム環境、シェル、依存関係に関連する一般的な問題を修正します。

## PowerShellが認識されない

**問題：** 「PowerShellは内部または外部コマンドとして認識されていません」というエラーメッセージが表示される。

**解決策：**

* **Windowsユーザー：**
  * PowerShellをシステムPATHに追加
  * 設定 → システム → 詳細情報 → システムの詳細設定 → 環境変数を開く
  * PowerShellのパスを追加：`C:\Windows\System32\WindowsPowerShell\v1.0\`
  * PATHを変更した後SoloEntを再起動

* **代替案：**
  * 代わりにコマンドプロンプト（cmd）を使用
  * 設定でデフォルトのターミナルを変更
  * PowerShellがない場合は再インストール

## コマンドが見つからない

**問題：** ターミナルに「コマンドが見つかりません」などのエラーが表示される。

**解決策：**

* コマンド/ツールがシステムにインストールされているか確認
* コマンドがシステムPATHにあるか確認
* 新しいツールをインストールした後ターミナルを再起動
* 必要に応じて実行ファイルへのフルパスを使用
* 欠けている依存関係をインストール

## Python/Nodeが見つからない

**問題：** PythonまたはNode.jsのコマンドが動作しない。

**解決策：**

* python.orgからPython、またはnodejs.orgからNode.jsをインストール
* インストールを確認：`python --version`または`node --version`
* インストールされているが認識されない場合はPATHに追加
* インストール後SoloEntを再起動
* バージョンの競合を確認（複数のPython/Nodeバージョン）

## アクセス拒否エラー

**問題：** 「アクセスが拒否されました」または「Permission denied」エラーが表示される。

**解決策：**

* **macOS/Linux：**
  * 必要に応じて`sudo`を使用
  * `ls -la`でファイル権限を確認
  * システム設定でフルディスクアクセスを許可

* **Windows：**
  * 必要に応じてSoloEntを管理者として実行
  * フォルダのセキュリティ設定を確認
  * ユーザーアカウント制御を一時的に無効化

## スペースを含むパスでエラーが発生

**問題：** ファイルパスにスペースが含まれるとコマンドが失敗する。

**解決策：**

* パスを引用符で囲む：`"C:\My Documents\project"`
* ターミナルでエスケープ文字を使用
* プロジェクトフォルダ名にスペースを使用しない
* 代わりにハイフンまたはアンダースコアを使用：`my-project`（`my project`ではなく）

## Gitが利用できない

**問題：** Gitコマンドが動作しない、またはGitが見つからない。

**解決策：**

* git-scm.comからGitをインストール
* インストールを確認：`git --version`
* GitをシステムPATHに追加
* インストール後ターミナル/SoloEntを再起動
* 代替としてGitHub Desktopを使用

## 環境変数が設定されていない

**問題：** アプリケーションが必要な環境変数を見つけられない。

**解決策：**

* システム設定で変数を設定（ターミナルセッションだけでなく）
* **Windows：** システムのプロパティ → 環境変数
* **macOS/Linux：** `~/.zshrc`または`~/.bashrc`に追加
* 変数を設定した後SoloEntを再起動
* `echo $VARIABLE_NAME`（Unix）または`echo %VARIABLE_NAME%`（Windows）で確認

## シェルの互換性の問題

**問題：** コマンドがあるシェルでは動作するが、別のシェルでは動作しない。

**解決策：**

* 使用しているシェルを確認：`echo $SHELL`
* 互換性のあるシェルに切り替え（bash、zsh、PowerShell）
* SoloEnt設定でデフォルトシェルを構成
* 可能な場合はクロスプラットフォームコマンドを使用

## システムアーキテクチャの不一致

**問題：** ツールやバイナリがシステムと互換性がない。

**解決策：**

* システムアーキテクチャを確認：`uname -m`（Unix）または`systeminfo`（Windows）
* 正しいバージョンをダウンロード（x64、ARM64など）
* 互換性のある代替手段を使用
* 必要に応じてApple Silicon MacでRosetta 2を有効化

## アンチウイルスが操作をブロック

**問題：** アンチウイルスソフトウェアがSoloEntの操作に干渉する。

**解決策：**

* SoloEntをアンチウイルスのホワイトリスト/例外に追加
* テストのために一時的にアンチウイルスを無効化
* ブロックされたアクションについてアンチウイルスのログを確認
* 適切な設定についてアンチウイルスのサポートに連絡

## ディスク容量の問題

**問題：** ディスク容量不足により操作が失敗する。

**解決策：**

* 利用可能なディスク容量を確認
* 一時ファイルとキャッシュをクリア
* より多くのスペースがあるドライブにプロジェクトを移動
* 不要なファイルを削除

## ネットワーク/ファイアウォールの問題

**問題：** APIサービスに接続できない、またはアップデートをダウンロードできない。

**解決策：**

* ファイアウォール設定を確認
* ファイアウォールでSoloEntを許可
* 企業ファイアウォールの背後にいる場合はプロキシ設定を構成
* 別のネットワークで接続をテスト
* 企業環境ではIT部門に連絡

<Tip>
  PATHの更新や新しいツールのインストールなど、システム変更を行った後、SoloEntを再起動することで多くの環境問題が解決します。
</Tip>

## まだ問題がありますか？

<CardGroup cols={2}>
  <Card title="メールサポート" icon="envelope" href="mailto:team@soloent.ai">
    環境の詳細を添えてサポートチームにお問い合わせください
  </Card>

  <Card title="Discordに参加" icon="discord" href="https://discord.com/invite/NUh3skEFuY">
    コミュニティからヘルプを得る
  </Card>

  <Card title="クイックスタート" icon="rocket" href="../quickstart/quickstart">
    セットアップガイドに戻る
  </Card>
</CardGroup>

## 環境問題の報告

環境問題を報告する際は、以下を含めてください：

* **オペレーティングシステム**：Windows 10/11、macOSバージョン、Linuxディストリビューション
* **システムアーキテクチャ**：x64、ARM64、Apple Silicon
* **シェルタイプ**：PowerShell、CMD、bash、zsh
* **エラーメッセージ**：エラーの完全なテキスト
* **試した手順**：報告前に試したこと

この情報は、問題をより迅速に診断して解決するのに役立ちます。
