Claude Code の返答に出てくるファイルパス、クリックで開けたり開けなかったりしませんか?
自分は Orcaの上で Claude Code を使っているんですが、モデルの出力だとパスが前後の文字とつながって判定されることがあって、開けるかどうかが安定しないんですよね。そこで、Claude Code の新機能 Mod を使って、セッションが作成・編集したファイルを横に出し続けて、そこから確実に開けるペインを作りました。
この記事で分かること
- Mod で「最近触ったファイル」を横に出し続けるペインの作り方
- Bash 経由(
sedやpython)の書き込みを、git の差分で拾う方法 - 全画面表示で、ペインの文字のパスがクリックで開けなかった理由と、OSC 8 リンクで解決した話
- Mod を作るときのハマりどころ(保護パス、読み込み直しで消える状態)
作ったもの:recent-files
GitHub で公開しています。
Claude Code の入力欄で次を打てば入ります。
/plugin install recent-files --marketplace ryoupr/claude-code-recent-files
やっていることはこれだけです。
- セッションが作成・編集・削除したファイルの直近5件をペインに出す
- 1行目はファイル名だけで、裏にファイルへのリンク(
file://の絶対パス)を埋めてある - 2行目に、作業ディレクトリからの相対フォルダ・何をしたか・ツール・時刻を薄く出す
- サブエージェントが書いたファイルには
subagentと付く
report.md
docs/ · edited · edit · 15:58
a.txt
./ · created · bash · subagent · 15:57
全画面表示(CLAUDE_CODE_NO_FLICKER=1)なら会話の右に、通常表示なら入力欄の上に出ます。
Mod とは
Claude Code v2.1.287 から使える拡張で、TypeScript(JavaScript)の関数で、ツール呼び出しやプロンプト、画面の描画に割り込めます。中身はプラグインで、hooks/hooks.json が指すファイルの register 関数で、イベントごとにフックを登録する形です。
recent-files/
├── .claude-plugin/
│ └── plugin.json
└── hooks/
├── hooks.json
└── register.tsx
ビルドもいらず、claude --plugin-dir ./recent-files で読み込んで、保存すれば読み込み直してくれます。しかも、Claude Code に「こういう Mod を作って」と頼むと、組み込みのスキル(plugin-authoring)を読んで書いてくれます。今回もほぼ Claude Code に書いてもらいました。
入門は公式ドキュメントと、先に書かれている Qiita の記事が分かりやすいです(末尾の「参考」にまとめました)。この記事は「実際に作ってハマったところ」を中心に書きます。
仕組み
Write・Edit は tool.call で、成功したときだけ記録する
tool.call はツールを呼ぶたびに走るフックです。next(e) で本来の処理を走らせて、結果を見てから記録します。失敗した Edit(置き換え対象が見つからない、など)は載せたくないので、isError を見ています。
on('tool.call', { tool: 'Edit' }, async ($, e, next) => {
const ran = await next(e)
if (ran.deny === undefined && ran.isError !== true) {
await record($, e.file_path, 'edited', 'edit', e.agentId)
}
return ran
}).catch(($, e, next) => next(e))
e.agentId はサブエージェントの中で呼ばれたときだけ入るので、これで subagent の印を付けています。最後の .catch(...) は、フックが失敗してもツール呼び出しはそのまま通すためです。見るだけの Mod なので、止める側には倒しません。
Bash は前後の git status を比べて拾う
厄介なのが Bash です。echo > a.txt や sed -i、python の中での書き込みは、ツールの入力(コマンド文字列)からは書き込み先が分かりません。コマンドを解析する手もありますが、スクリプトの中での書き込みまでは追えないですよね。
そこで、Bash の実行の前後で git status を取って比べることにしました。
- これまでに編集したファイルのリポジトリと、
cd /絶対パスの移動先のリポジトリを覚えておく - Bash の前に、それぞれで
git status --porcelain=v1 -z -uallを取り、変更中のファイルの更新時刻とサイズも取る - Bash の後にもう一度取って、差分を記録する
更新時刻とサイズも見ているのは、すでに変更中のファイル(M のまま)をもう一度書き換えたときも拾いたいからです。git status の一覧だけだと、前後で同じ M なので変化が見えないんですよね。
git status は少しオプションを足して実行しています。
await $.process.run([
'git', '--no-optional-locks', '-c', 'core.fsmonitor=false',
'-C', root, 'status', '--porcelain=v1', '-z', '-uall',
])
-
--no-optional-locks:git statusが index.lock を取らないようにする。並列に動いている別の git コマンドと取り合うと、そっちが失敗するので -
-c core.fsmonitor=false: リポジトリのローカル設定で、git statusがプログラムを起動しないようにする
ただし、git の外での書き込みは拾えません。ここは割り切りました。
状態は $.state に置く。読み込み直しで消えたので $.store にも控えた
画面に出す一覧は $.state に置いています。値を書き換えると、それを読んでいる描画が自動で描き直されるので便利です。
型定義の説明には「ホットリロードしても残る」とあるんですが、試作中に読み込み直したら一覧が空になることがありました。原因までは追えていないんですが(早期アクセスの機能なので?)、記録のたびに $.store(セッションをまたいで残る保存先)にも控えて、起動時に $.state が空なら戻すようにしています。
ハマりどころ:「クリックで開く」までの試行錯誤
ここが一番時間を使いました。
1. 文字のパスを出す → 通常表示なら開けた
最初は、ペインに絶対パスをそのまま出しました。Orca はターミナルに出たパスを見つけてリンクにしてくれるので、通常表示ではクリックで開けました。
2. 全画面表示の右のペインだと開けない
ところが、ペインを会話の右に並べたくて全画面表示にすると、クリックしても開きません。パスと区切り線がくっついているのを疑って前後に空白を入れてみましたが、それでもダメでした。
原因は折り返しだと考えています。右のペインは幅が狭いので、長い絶対パスはペインの中で折り返されます。この折り返しは Claude Code が自分で描いているもので、端末から見ると、途中で切れたパスが別々の行に並んでいるだけです。しかも次の行は、左側に会話の文字があって、ペインの区切り線 │ と空白を挟んでからパスの続きが始まります。パスの途中にスペースや │ が入った形になるので、Orca からは1つのパスに見えないんですよね(会話の中でも、折り返した行の頭には字下げの空白が入るので、たぶん同じです?)。通常表示ではペインが端末の幅いっぱいに出るので、パスが1行に収まって開けた、ってことですね。
全画面表示でも、クリック自体は Orca に届いています。このあと出てくる OSC 8 リンクは、同じ右のペインで開けたので。
3. 入力欄の上に移す案も試した
全画面をやめて、入力欄の上に3件だけ出す形も作りました。パスは作業ディレクトリからの相対パスにして、短く1行に収まるようにしています。これはクリックで開けるんですが、やっぱり右に並んでいてほしい……。
4. OSC 8 リンクにしたら全画面でも開けた
最後に試したのが OSC 8 ハイパーリンクです。ターミナルで「表示する文字」と「リンク先」を別々にできる仕組みで、HTML の <a href> みたいなものですね。
Mod には Link という部品があって、端末では OSC 8 として描かれます。
- 詳細な仕様はこちら: Hyperlinks in Terminal Emulators(OSC 8 の仕様をまとめたドキュメント。2017年に GNOME Terminal と iTerm2 が実装)
- 日本語での解説はこちら: ターミナルエミュレータ内でクリッカブルなリンクを作る方法
<Link href={fileUrl(file.path)} label={baseName(file.path)} />
fileUrl は、パスの各部分をパーセントエンコードして file:///... にする小さな関数です。日本語やスペースの入ったパスでも壊れないようにしています。
なお、仕様では file:// の URI にホスト名を入れる(file://ホスト名/パス)ことになっていて、端末はホスト名が自分と違えば開かないよう求められています。今回はホスト名なしの file:///... にしていますが、Orca では問題なく開けました。
これで、全画面表示の右のペインでも、ファイル名のクリックで開けるようになりました。ファイル名にポインタを乗せると、Orca の「ファイルを開く」メニューが出ます。
リンクにした効果は2つあります。
-
表示が短くなるので、折り返されにくい: 出すのはファイル名だけで、フルパスは裏に入っています。行が切れなければ、TUI の枠線(
│)や字下げの空白がパスの途中に入り込むこともありません - 文字からパスを探してもらわなくていい: OSC 8 では、リンク先が表示の文字とは別に埋め込まれています。Orca は「どこからどこまでがパスか」を判定せず、埋め込まれた URI をそのまま開くので、前後に何がくっついていても関係ありません。147文字のファイル名でわざと折り返させてみましたが、切れた断片のどこをクリックしても開けました
文字のパスがダメになる原因は「くっつき」と「改行」の2つでしたが、リンクにすると両方とも避けられるわけですね。ファイル名だけを出せるのでペインも細くできて、結果的に一番いい形になりました。
ちなみに Orca 本体の中身を見ると、ターミナルのリンク設定で allowNonHttpProtocols: true になっていて、http 以外のリンクも自分の処理で開くようになっていました。xterm.js の既定では http:・https: 以外のリンクは無視されるので(xterm.js の ILinkHandler)、ここは Orca に助けられた形です。
もう1つ、Claude Code は端末が OSC 8 に対応していないと判断すると、Link を「文字のあとに URL を薄く並べる」形で描きます。Orca は、Claude Code に対応端末と認識されるよう工夫しているようです(claude-code の issue #69625)。
おまけ:会話の中のパスは、どう書かれていれば開ける?
せっかくなので、Claude Code の返答の中に出たパスがどんな書き方なら開けるのかも、Orca(全画面表示)で試してみました。
| 書き方 | クリックで開けたか |
|---|---|
調査結果を /Users/me/a.txt に記録しました(前後に半角スペース) |
開けた |
/Users/me/a.txt(パスだけ) |
開けた |
docs/a.md・./docs/a.md(作業ディレクトリからの相対パス) |
開けた |
~/docs/a.md |
開けた |
調査結果を/Users/me/a.txtに記録しました |
開けなかった |
(/Users/me/a.txt)・「/Users/me/a.txt」
|
開けなかった |
/Users/me/a.txt。続けて… |
開けなかった |
モデルの日本語の文章だと、パスに括弧や句読点がそのままくっつくことが多いんですよね。冒頭の「開けたり開けなかったり」の正体はこれでした。CLAUDE.md に「パスの前後には半角スペースを入れる」と書いておくのも手かもしれません?
その他のハマりどころ
Mod のフォルダは保護パスで、auto mode では編集が止まる
--plugin-dir で読み込んでいるフォルダ(や、Claude Code が Mod を書く ~/.claude/dev-mods/)は保護パスです。Claude Code が書き換えたコードがそのまま実行されるので、当然といえば当然ですね。
auto mode では、ここへの書き込みが判定器に回されます。自分の環境では判定器が「判定なし」を返して毎回止まり、permissions.allow に許可ルールを足しても通りませんでした。公式ドキュメントにも、許可ルールでは保護パスへの書き込みを事前に許可できないとあります。Mod を Claude Code に直してもらうときは、マニュアルモードに切り替えて、編集ごとに承認するのが確実です。
zsh の env VAR=~/... は ~ を展開しない
試験用に設定フォルダを分けて、env CLAUDE_CONFIG_DIR=~/.claude-test claude ... のように起動していたら、~ が文字のまま渡っていました。zsh は、コマンドの引数の中の = の後ろにある ~ を、既定では展開しません。その結果、起動したフォルダの中に ~ という名前のフォルダができて、Claude Code はまっさらな設定で動いていました。"$HOME/..." と書けば大丈夫です。
まとめ
- Claude Code の出力のパスは、前後の文字とつながってクリックで開けないことがある。Mod で「最近触ったファイル」を横に出し続けると、確実に開ける
- Write・Edit は
tool.callで成功時だけ記録し、Bash は前後のgit statusの差分で拾う - 右のペインのように幅が狭いと、長いパスは折り返されて Orca に認識されない。ファイル名だけを出して、パスは OSC 8 リンク(
Link部品)に埋めると、全画面表示でも確実に開ける - Mod のフォルダは保護パス。Claude Code に直してもらうときはマニュアルモードで
- Mod は早期アクセスの機能なので、API が変わることがある。README には動作確認したバージョン(2.1.290・2.1.291)を書いておきました
自分の困りごとを、その場で Claude Code に Mod として書いてもらえるのは、なかなか楽しいですね。
参考
- 作った Mod: https://github.com/ryoupr/claude-code-recent-files
- Create a mod(公式ドキュメント): https://code.claude.com/docs/en/plugins/mods/create
- Choose a permission mode / Protected paths(公式ドキュメント): https://code.claude.com/docs/en/permission-modes#protected-paths
- Mod の型定義(Claude Code のリポジトリ): https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts
- Claude Code の mods とは? 画面もツール呼び出しも自分好みに変えられる新しい拡張: https://qiita.com/Takuya__/items/50635331136ee6386286
- Claude Code mods 入門、TypeScript で挙動と UI を拡張する: https://qiita.com/kai_kou/items/ad16b47644f9ad0b03c7
- Claude Codeのmodで「Claudeがどこまで読んだか」を可視化した: https://qiita.com/y-hirakaw/items/eaae3fa2cb6f6d2746ea
- Hyperlinks in Terminal Emulators(OSC 8 の仕様): https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda
- ターミナルエミュレータ内でクリッカブルなリンクを作る方法: https://qiita.com/aosho235/items/335fc2f4b002a8251a2f
- xterm.js ILinkHandler(allowNonHttpProtocols): https://xtermjs.org/docs/api/terminal/interfaces/ilinkhandler/
- Recognize Orca terminals as OSC 8 hyperlink-capable(claude-code の issue #69625): https://github.com/anthropics/claude-code/issues/69625

