Skip to main content
サポート

ターミナル実行時の例外

はじめに

Qoder IDE の Agent Mode を使用する際、ターミナルでの実行はローカル環境とシェルの設定に大きく依存します。次のような問題が発生することがあります：
  • ターミナルを起動できない
  • コマンドが実行されない
  • 出力が表示されない
本トピックでは、これらの問題を解決するための一般的なトラブルシューティング手順を紹介します。

よくあるトラブルシューティング方法

方法 1: サポート対象のシェルを設定する

Qoder IDE は複数のシェルをサポートしています。対応するシェルを使用していることを確認してください。
  1. Qoder IDE を開きます。
  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 IDE をいったん完全に終了してから再度開きます。

方法 2: シェル連携を手動でインストールする

ターミナル連携が引き続きうまくいかない場合は、シェルの設定ファイルに適切な行を追加して、シェル連携を手動でインストールしてください。
  • zsh (~/.zshrc):
[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path zsh)"
  • Bash（~/.bashrc）：
[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path bash)"
  • PowerShell（$Profile）:
if ($env:TERM_PROGRAM -eq "vscode") { . "$(code --locate-shell-integration-path pwsh)" }
  • Fish（~/.config/fish/config.fish）：
string match -q "$TERM_PROGRAM" "vscode"; and . (code --locate-shell-integration-path fish)
ファイルの編集後:
  1. 変更を保存します。
  2. Qoder IDE を完全に再起動します。
他のシェルの場合は、手動シェル統合を参照してください。

問題が解消しない場合

それでもターミナル出力が表示されない場合は、次を実行してください:
  • 現在のターミナルセッションを終了するために「Terminate Terminal」ボタンをクリックします。
  • コマンドをもう一度実行します。これによりターミナル接続が更新され、一時的な問題が解決されることがよくあります。

Windows 固有のトラブルシューティング

Git Bash

  1. https://git-scm.com/downloads/win から Windows 用 Git をダウンロードしてインストールします。
  2. Qoder IDE を終了して再度開きます。
  3. 既定のターミナルとして「Git Bash」を設定します。 a. Command Palette を開きます。 b. Terminal: Select Default Profile を実行します。 c. Git Bash を選択します。

PowerShell

  1. PowerShell 7 以降を使用していることを確認してください。
    バージョンを確認:
$PSVersionTable.PSVersion
  1. 必要に応じて PowerShell を更新します。
  2. 既定では、PowerShell はセキュリティ上の理由によりスクリプトの実行を制限しています。実行ポリシーを変更する必要がある場合があります。
a. 管理者として PowerShell を開く:
  • Win + X を押す
  • Windows PowerShell (管理者) または Windows Terminal (管理者) を選択
b. 現在のポリシーを確認する: 
Get-ExecutionPolicy

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

# これにより、システム全体を変更するよりも安全に、現在のユーザーのみにRemoteSignedポリシーが設定されます。
d. プロンプトが表示されたら Y を入力して確定し、次を確認します: 
Get-ExecutionPolicy
e. Qoder IDEを再起動して、もう一度お試しください。

WSL

Windows Subsystem for Linux（WSL）を使用している場合：
  1. 次の行を ~/.bashrc に追加します：
. "$(code --locate-shell-integration-path bash)"
  1. シェルを再読み込みするか、source ~/.bashrc を実行します。
  2. Qoder IDE でターミナルコマンドを再実行します。

その他の一般的な問題

ターミナルの異常な出力

次のような表示が見られる場合:
  • 文字化け
  • 四角い記号
  • エスケープシーケンス（例: ^[[1m、^[[32m）
  • 制御コード
これは、次のようなサードパーティ製のシェルのカスタマイズが原因であることがよくあります:
  • Powerlevel10k
  • Oh My Zsh
  • カスタムの fish テーマ

解決策 1：Agent 実行時に複雑なプロンプトやテーマを無効化する（推奨）

QODER_AGENT 環境変数で Agent の実行中かを判定します。有効な場合は、シェル起動時に複雑なテーマやプロンプト設定を読み込まないようにして競合を避けます。 zsh (~/.zshrc): 
if [[ -n "$QODER_AGENT" ]]; then
  # Agent 実行時はテーマの読み込みを省略
else
  [[ -r ~/.p10k.zsh ]] && source ~/.p10k.zsh
fi
Bash (~/.bashrc): 
if [[ -n "$QODER_AGENT" ]]; then
  PS1='\u@\h \W \$ '  # Agent 実行時は簡易プロンプトを使用
fi
解決策
  1. シェルの設定ファイルでカスタマイズを一時的に無効化します。
たとえば、~/.zshrc で Powerlevel10k の行をコメントアウトします: 
# source /path/to/powerlevel10k/powerlevel10k.zsh-theme
  1. Qoder IDE を再起動してテストします。
  2. 問題が解決した場合は、どのコンポーネントが競合しているか特定するために、カスタマイズを一つずつ再度有効化します。
  3. 長期的な運用に向けて、Qoder IDE のターミナル統合と互換性のある設定を選定してください。