Claude Code の mod「ウラ取り」を GitHub から入れて、帯が出るのを確かめるまでの手順です。所要時間は5分ほど。ここではフォルダを ~/mods/uradori に置く前提で書いています。別の場所に置く場合は、以下のパスを読み替えてください。
どちらか一方でかまいません。
mkdir -p ~/mods git clone https://github.com/yui-taro/uradori ~/mods/uradori
あとで git pull だけで更新できます。
uradori-main フォルダを uradori に名前を変える~/mods/(ホームの下に mods フォルダを作る)に移す正しく置けていれば、~/mods/uradori/.claude-plugin/plugin.json があります。
まず試すなら A、ずっと使うなら B。
作業したいプロジェクトのフォルダで、mod のフォルダを指定して起動します。
# 例: 自分のプロジェクトで試す
cd ~/your-project
claude --plugin-dir ~/mods/uradori~/.claude/settings.json の env に CLAUDE_CODE_PLUGIN_DIRS を追加します。デスクトップアプリにも効きます。
{
"env": {
"CLAUDE_CODE_PLUGIN_DIRS": "~/mods/uradori"
}
}すでに settings.json に設定が書いてある場合は、ファイルを置き換えずに、既存の { } の中へ "env" を足してください。"env" がもうあるなら、その中に1行足すだけです。JSON はカンマの付け忘れ・付けすぎに注意。
書き換えたあとは Claude Code を起動し直してください(デスクトップアプリは一度終了して開き直す)。
Claude Code の入力欄で打ちます。
/plugin
1 mod active · uradori と表示されれば読み込めています。続けて /uradori を打ち、「ウラ取り: まだチェックした回答はありません。」という返事が出れば、コマンドも使える状態です。
付属のデモで、食い違いが見つかるところを見ます。
demo/ は、ドキュメント(docs/spec.md では「タイムアウト30秒」)とコード(src/config.ts では timeout: 60_000)が食い違っている小さなプロジェクトです。
cd ~/mods/uradori/demo claude --plugin-dir ~/mods/uradori
手順 2 の B で設定した人は、claude だけで起動してかまいません。起動したら、次の文をそのまま送ります。毎回確実に食い違いが出ます。
次の文をそのまま出力して:タイムアウトは30秒です(根拠:`src/config.ts`)。
src/config.ts の timeout: 60_000 の行が ▶ で強調されるここまで出れば導入は完了です。あとは普段どおり使うだけで、出典つきの回答が終わるたびに自動でチェックされます。
必要なときだけ。
| したいこと | 方法 |
|---|---|
| 自動チェックを一時的に止める | /uradori off(再開は /uradori on) |
| 直前の回答をもう一度チェック | /uradori recheck |
| チェックされなかった理由を知る | /uradori why |
| 出典がなくても毎回チェックする | /uradori strict(もう一度で元に戻す) |
| ✖ のときポップアップを自動で開かない | /uradori popup off(戻すときは on) |
| Web Archive に URL を送らない | /uradori archive off(戻すときは on) |
| 判定の精度を上げる | hooks/register.tsx の JUDGE_MODEL を 'haiku' から 'sonnet' に変えて起動し直す(利用量は増えます) |
cd ~/mods/uradori && git pull
ZIP で入れた場合は、新しい ZIP で ~/mods/uradori を置き換えます。どちらも、反映には Claude Code の起動し直しが必要です。
~/.claude/settings.json から CLAUDE_CODE_PLUGIN_DIRS の行を消す(B で設定した場合)~/mods/uradori フォルダを削除するよくある原因と確かめ方。
| 症状 | 確かめること |
|---|---|
/plugin に uradori が出ない | パスの指すフォルダに .claude-plugin/plugin.json があるか(ZIP の場合、フォルダが二重になっていないか)。settings.json が正しい JSON か。Claude Code が v2.1.287 以降か。起動し直したか。 |
| 読み込まれているのに帯が出ない | claude.ai のチャット画面やクラウドのセッションでは、mod は動いても表示する画面がありません。ターミナル版・デスクトップアプリの Code タブ・VS Code 拡張で使ってください。 |
| 回答してもチェックされない | /uradori why で理由を確かめられます。回答に出典(ファイル名や URL)が入っているか。「〜を修正しました」のような作業の報告や質問はチェックしない仕様です。/uradori off にしていないか。質問に「根拠」「出典」などを入れると、出典を付けて答えるよう Claude に伝わります。 |
| ? 🔒 📄 ⏸ が付く | ? はログインが必要なページ、JavaScript で描画されるページ、プロジェクト外や .env などの秘密情報らしいファイル、時間切れ。🔒 はボット対策で取得できず Web Archive にもないページ。📄 は PDF。⏸ は社内アドレスや認証情報らしい値を含む URL で、ポップアップの[原文を取りに行く]を押したときだけ取りに行きます。 |
| ポップアップが自動で開かない | ターミナルの幅が144桁未満だと、代わりにトーストで知らせます。/uradori popup off にしていないかも確認してください。 |
| ポップアップを開きたい | 帯の[原文を見る]か /uradori で開けます。開けない画面では、結果が文字で表示されます。 |
mod はサンドボックスの外で、あなたの権限で動きます。判定のため、主張と原文の抜粋をセッションと同じアカウントのモデルに送ります。会社の PC で使う場合は社内のルールを確認してください。