FORCE_HYPERLINK

環境変数

ターミナルが OSC 8 ハイパーリンクに対応しているのに自動検出されない場合、1 を設定するとクリック可能なハイパーリンクを有効にできる。未設定の場合、Claude Code はターミナルの対応を検出したときにのみ、ほとんどのハイパーリンクを有効にする。フッターの PR またはマージリクエストのバッジや長いサインイン URL は、いずれの場合もリンクとして表示される。0、false、no、off を設定すると、これらすべてをプレーンテキストとして表示する。v2.1.314 より前は、false、no、off は逆にハイパーリンクを有効にしていた。

使い方・用途

  • OSC 8 ハイパーリンクに対応したターミナルを使っているのに Claude Code に自動検出されず、リンクがクリックできないときに検出結果を上書きしてリンクを有効化する。
  • SSH や tmux 経由でエスケープシーケンスが正しく扱われずリンクが機能しない環境で、起動前に FORCE_HYPERLINK を設定してクリック可能なリンクを使えるようにする。
  • ターミナルでリンクがクリックできる状態になってしまい、owner/repo#123 形式の Issue 参照やフッターの PR バッジをプレーンテキストとして表示させたいときに 0 を設定して無効化する。
英語原文

Set to 1 to enable clickable OSC 8 hyperlinks when your terminal supports them but isn't auto-detected. When unset, Claude Code enables most hyperlinks only when it detects terminal support. The footer PR or merge request badge and long sign-in URLs are links either way. Set 0, false, no, or off to render all of them as plain text. Before v2.1.314, false, no, and off enabled hyperlinks instead

関連ドキュメント

関連する変更履歴

v2.1.314(1件)

FORCE_HYPERLINK=false (no や off も同様) を指定したときに、ハイパーリンクを有効にするのではなく無効にするように変更した
英語原文を表示
Changed FORCE_HYPERLINK=false (also no and off) to turn hyperlinks off instead of on

v2.1.217(1件)

ターミナルのハイパーリンク対応が検出できない環境（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件)

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

変更後

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

関連ドキュメント