コンテンツにスキップ
Claudex

ターミナルハイパーリンク

Claudex はターミナル出力で OSC 8 ハイパーリンクをサポートしており、Claude Code の出力に含まれるファイルパス、URL、参照を対応ターミナルでクリック可能にします。

概要

Section titled “概要”

OSC 8 はターミナル出力にハイパーリンクを直接埋め込むターミナルエスケープシーケンス標準です。対応している場合、リンクをクリックするとデフォルトハンドラー（URL はブラウザ、ファイルパスはエディタ）で開きます。

エスケープシーケンスの形式:

\x1b]8;;URL\x07DISPLAY_TEXT\x1b]8;;\x07

設定

Section titled “設定”
# config.toml（グローバル設定）
hyperlinks = "auto"    # "auto" | true | false
値動作
"auto"ターミナルのサポートを自動検出（デフォルト）
trueハイパーリンクを強制有効化
falseハイパーリンクを強制無効化

CLI フラグでセッション単位でもハイパーリンクを有効化できます:

Terminal window
claudex run grok --hyperlinks

ターミナル検出

Section titled “ターミナル検出”

hyperlinks = "auto" の場合、Claudex は以下の順序で確認します:

優先度確認内容結果
1FORCE_HYPERLINKS=1 環境変数有効
2TTY でない無効
3DOMTERM 環境変数が設定済み有効
4TERM_PROGRAM = iTerm.app有効
5TERM_PROGRAM = WezTerm有効
6TERM_PROGRAM = vscode有効
7TERM_PROGRAM = Tabby有効
8TERM_PROGRAM = Hyper有効
9TERM_PROGRAM = mintty有効
10TERM_PROGRAM = WarpTerminal有効
11TERM = xterm-kitty有効
12TERM = xterm-ghostty有効
13VTE_VERSION >= 5000有効
14WT_SESSION 環境変数が設定済み（Windows Terminal）有効
15上記いずれにも該当しない無効（安全なデフォルト）

対応ターミナル

Section titled “対応ターミナル”
ターミナルプラットフォーム検出方法
iTerm2macOSTERM_PROGRAM
WezTermクロスプラットフォームTERM_PROGRAM
KittyクロスプラットフォームTERM (xterm-kitty)
GhosttyクロスプラットフォームTERM (xterm-ghostty)
VS Code TerminalクロスプラットフォームTERM_PROGRAM
Windows TerminalWindowsWT_SESSION
GNOME TerminalLinuxVTE_VERSION
TabbyクロスプラットフォームTERM_PROGRAM
HyperクロスプラットフォームTERM_PROGRAM
mintty (Git Bash)WindowsTERM_PROGRAM
WarpTerminalmacOSTERM_PROGRAM
DomTermクロスプラットフォームDOMTERM

PTY プロキシモード

Section titled “PTY プロキシモード”

Unix システムでハイパーリンクが有効な場合、Claudex は PTY（擬似端末）プロキシの下で Claude Code プロセスを起動します。これにより、Claudex はターミナル出力をインターセプトしてハイパーリンクで強化しつつ、完全なターミナル体験（カラー、カーソル移動など）を維持できます。

PTY プロキシはユーザーに対して透過的です。対話セッションでのみ有効化されます（--print を使用した非対話モードでは PTY はスキップされます）。

強制有効/無効

Section titled “強制有効/無効”

自動検出リストにないターミナルでハイパーリンクを強制的に有効にするには:

Terminal window
# 環境変数経由
FORCE_HYPERLINKS=1 claudex run grok


# 設定経由
hyperlinks = true


# CLI フラグ経由
claudex run grok --hyperlinks

強制的に無効にする場合（例: 出力のパイプ時）:

hyperlinks = false