環境変数

FORCE_HYPERLINK

1を設定すると、ターミナルが対応しているのに自動検出されない場合にクリック可能な OSC 8 ハイパーリンクを有効にし、0で無効にする。未設定のとき、Claude Code はターミナルの対応を検出した場合にのみハイパーリンクを有効にする。Claude Code はこの値をブール値ではなく数値として解析するため、false、no、off などの値はハイパーリンクを無効にするのではなく有効にする。SSH 接続時など、ターミナルの対応を検出できない場合でも、フッターの PR またはマージリクエストバッジはハイパーリンクとして描画される。バッジをプレーンテキストとして描画するには 0 を設定する。

使い方・用途

  • 端末が OSC 8 ハイパーリンクに対応しているのに Claude Code が自動検出できず、リンクをクリックできない場合に強制的に有効化する。
  • SSH や tmux 経由で接続していて端末対応の検出ができない環境でも、フッターの PR バッジや issue への参照リンクをクリック可能なハイパーリンクとして表示する。
  • クリック可能なリンクが不要な環境で 0 を設定し、issue 参照やフッターの PR バッジをプレーンテキストとして表示する。
英語原文(公式ドキュメントより)

Set to 1 to enable clickable OSC 8 hyperlinks when your terminal supports them but isn't auto-detected, or 0 to disable them. When unset, Claude Code enables hyperlinks only when it detects terminal support. Claude Code parses this value as a number, not a Boolean, so a value such as false, no, or off enables hyperlinks rather than disabling them. The footer PR or merge request badge renders as a hyperlink even when Claude Code can't detect terminal support, such as over SSH. Set 0 to render the badge as plain text

関連ドキュメント

関連する変更履歴

v2.1.217(1件)

Improved
ターミナルのハイパーリンク対応が検出できない環境(SSHやtmuxなど)でも、フッターのPRバッジをリンクとしてクリック可能にしました(FORCE_HYPERLINK=0で無効化可能)。
英語原文を表示
Improved footer PR badge links to be clickable hyperlinks even when terminal support can't be detected (e.g. over ssh/tmux); set FORCE_HYPERLINK=0 to opt out

変更後

バッジをクリックするだけでいつでもブラウザでプルリクエストを開けるようになります。

関連ドキュメント

v2.1.94(1件)

Fixed
settings.json の env 項目で設定された FORCE_HYPERLINK 環境変数が無視される問題を修正
英語原文を表示
Fixed FORCE_HYPERLINK environment variable being ignored when set via settings.json env

変更後

各ユーザーのターミナル環境に合わせて、URLやファイルパスのクリッカブル化を確実に制御できるようになります。

関連ドキュメント