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

# ターミナル実行時の例外

<div id="introduction">
  ## はじめに
</div>

Qoder の Agent Mode を使用する際、ターミナルでの実行はローカル環境とシェルの設定に大きく依存します。次のような問題が発生することがあります：

* ターミナルを起動できない
* コマンドが実行されない
* 出力が表示されない

本トピックでは、これらの問題を解決するための一般的なトラブルシューティング手順を紹介します。

<div id="common-troubleshooting-methods">
  ### よくあるトラブルシューティング方法
</div>

<div id="method-1-configure-a-supported-shell">
  #### 方法 1: サポート対象のシェルを設定する
</div>

Qoder は複数のシェルをサポートしています。対応するシェルを使用していることを確認してください。

1. Qoder を開きます。
2. コマンドパレットを開くには、`Cmd + Shift + P`（macOS）または `Ctrl + Shift + P`（Windows/Linux）を押します。
3. `Terminal: Select Default Profile` と入力して選択します。
4. サポート対象のシェルを選択します:
   * Linux/macOS: `bash`, `fish`, `pwsh`, `zsh`
   * Windows: `Git Bash`, `pwsh`
5. 変更を反映するために、Qoder をいったん完全に終了してから再度開きます。

<div id="method-2-manually-install-shell-integration">
  #### 方法 2: シェル連携を手動でインストールする
</div>

ターミナル連携が引き続きうまくいかない場合は、シェルの設定ファイルに適切な行を追加して、シェル連携を手動でインストールしてください。

* zsh (`~/.zshrc`):

```shellscript theme={null}
[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path zsh)"
```

* Bash（`~/.bashrc`）：

```shellscript theme={null}
[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path bash)"
```

* PowerShell（`$Profile`）:

```shellscript theme={null}
[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path bash)"
```

* Fish（`~/.config/fish/config.fish`）：

```shellscript theme={null}
string match -q "$TERM_PROGRAM" "vscode"; and . (code --locate-shell-integration-path fish)
```

ファイルの編集後:

1. 変更を保存します。
2. Qoder を完全に再起動します。

他のシェルの場合は、手動シェル統合を参照してください。

<div id="if-issues-persist">
  ### 問題が解消しない場合
</div>

それでもターミナル出力が表示されない場合は、次を実行してください:

* 現在のターミナルセッションを終了するために「Terminate Terminal」ボタンをクリックします。
* コマンドをもう一度実行します。これによりターミナル接続が更新され、一時的な問題が解決されることがよくあります。

<div id="windows-specific-troubleshooting">
  ### Windows 固有のトラブルシューティング
</div>

<div id="git-bash">
  #### Git Bash
</div>

1. [https://git-scm.com/downloads/win](https://git-scm.com/downloads/win) から Windows 用 Git をダウンロードしてインストールします。
2. Qoder を終了して再度開きます。
3. 既定のターミナルとして「Git Bash」を設定します。

   a. Command Palette を開きます。

   b. `Terminal: Select Default Profile` を実行します。

   c. Git Bash を選択します。

<div id="powershell">
  #### PowerShell
</div>

1. PowerShell 7 以降を使用していることを確認してください。\
   バージョンを確認:

```powershell theme={null}
$PSVersionTable.PSVersion
```

2. 必要に応じて PowerShell を更新します。
3. 既定では、PowerShell はセキュリティ上の理由によりスクリプトの実行を制限しています。実行ポリシーを変更する必要がある場合があります。

a. 管理者として PowerShell を開く:

* Win + X を押す
* Windows PowerShell (管理者) または Windows Terminal (管理者) を選択

b. 現在のポリシーを確認する:

```powershell theme={null}
Get-ExecutionPolicy

# 出力がRemoteSigned、Unrestricted、またはBypassの場合、実行ポリシーを変更する必要はありません。これらの設定では、シェル統合が正常に動作します。
# 出力がRestrictedまたはAllSignedの場合、シェル統合を有効にするためにポリシーを変更する必要があります。
```

c. ユーザーのポリシーを更新します：

```powershell theme={null}
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# これにより、システム全体を変更するよりも安全に、現在のユーザーのみにRemoteSignedポリシーが設定されます。
```

d. プロンプトが表示されたら `Y` を入力して確定し、次を確認します:

```powershell theme={null}
Get-ExecutionPolicy
```

e. Qoderを再起動して、もう一度お試しください。

<div id="wsl">
  #### WSL
</div>

Windows Subsystem for Linux（WSL）を使用している場合：

1. 次の行を \~/.bashrc に追加します：

```sh theme={null}
. "$(code --locate-shell-integration-path bash)"
```

2. Reload your shell or runsource \~/.bashrc.

3. Retry the terminal command in Qoder.

<div id="other-common-issues">
  ### その他の一般的な問題
</div>

<div id="unusual-terminal-output">
  #### ターミナルの異常な出力
</div>

次のような表示が見られる場合:

* 文字化け
* 四角い記号
* エスケープシーケンス（例: ^\[\[1m、^\[\[32m）
* 制御コード

これは、次のようなサードパーティ製のシェルのカスタマイズが原因であることがよくあります:

* Powerlevel10k
* Oh My Zsh
* カスタムの fish テーマ

**解決策**

1. シェルの設定ファイルでカスタマイズを一時的に無効化します。

たとえば、\~/.zshrc で Powerlevel10k の行をコメントアウトします:

```powershell theme={null}
# source /path/to/powerlevel10k/powerlevel10k.zsh-theme
```

2. Qoder を再起動してテストします。
3. 問題が解決した場合は、どのコンポーネントが競合しているか特定するために、カスタマイズを一つずつ再度有効化します。
4. 長期的な運用に向けて、Qoder のターミナル統合と互換性のある設定を選定してください。

***