跳到內容
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 環境變數啟用
2非 TTY停用
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