Claudeのモバイルアプリをリンクから直接開く仕組み
Claudeのモバイルアプリが対応するclaude://URLスキームの使い方をまとめます。Codeタブやセッションを直接開くパラメータと、デスクトップ版との違いにも触れます。
Claudeのモバイルアプリ(iOS・Android)はclaude://から始まるURLに反応します。mailto:リンクがメールアプリを開くのと同じ仕組みで、OSに登録されたこのプレフィックスをタップすると、ブラウザーではなくClaudeアプリが直接立ち上がります。このリンクを踏むと、アプリのCodeタブが開いたり、既存のセッションにジャンプしたり、プロンプトを下書きした状態で新規セッションが立ち上がったりします。サードパーティアプリやiOSショートカット、Webページに埋め込んでおけば、タップ1つでClaude Codeの作業を始められる入口を用意できます。iOS・Androidのどちらも同じURL仕様で動くため、プラットフォームごとにリンクを作り分ける必要はありません。
claude://が開くのはCodeタブだけ
モバイル版のclaude://が対応するのは、現状Claude CodeのCodeタブに関する経路だけです。チャットの会話やプロジェクトを直接開くパラメータは用意されておらず、リンクの行き先は次の3パターンに絞られます。
claude://code— Codeタブのセッション一覧を開くclaude://code/{session-id}— 指定したIDの既存セッションを開く。IDが不明な場合はセッション一覧に着地するclaude://code/new— 新規セッションの入力欄を開く。パラメータで内容を事前に埋め込める
この機能を使うには、アカウントにClaude Codeへのアクセス権が必要です。アクセス権がないアカウントでリンクを踏んでも何も起きません。パラメータの値はすべてURLエンコードが必須で、そのまま日本語や記号を書くとリンクが壊れます。
新規セッションを組み立てるパラメータ
claude://code/newには4つのパラメータを付けられます。いずれも省略可能で、指定しなければ空の状態でセッションが開きます。
| パラメータ | 必須 | 説明 |
|---|---|---|
q | 必須任意 | 説明入力欄に事前入力するテキスト。エイリアスとしてpromptも使える |
mode | 必須任意 | 説明セッションモードを事前選択。planかcodeを受け付ける。プランで使えないモードは無視される |
repo | 必須任意 | 説明owner/name形式(大文字小文字を区別しない)でGitHubリポジトリを事前選択。接続済みGitHubアカウントに無いリポジトリは無視される |
branch | 必須任意 | 説明ブランチを事前選択。repoとセットでのみ効く |
次のリンクは、anthropics/claude-codeリポジトリのmainブランチを、失敗したテストの調査プロンプト付きで開きます。
claude://code/new?q=Fix%20the%20failing%20test&repo=anthropics%2Fclaude-code&branch=mainデスクトップ版のClaude Codeリンクにはフォルダーやファイルを指定するパラメータもありますが、これらはモバイル版のリンクに含めても無視されます。モバイル端末にはローカルの作業ディレクトリという概念がないためです。
Universal Links — アプリが無い相手にも安全なリンク
同じCodeタブの経路は、https://claude.ai/code/から始まるUniversal Linksでも開けます。動作はカスタムURLスキームと少し違い、アプリがインストールされていればOSがそのままアプリを起動し、インストールされていなければブラウザーでページが開きます。
| URL | 開く画面 |
|---|---|
https://claude.ai/code | 開く画面新規セッションの入力欄 |
https://claude.ai/code/{session-id} | 開く画面既存セッション |
https://claude.ai/code/new?q=...&repo=...&branch=... | 開く画面パラメータを反映した新規セッション |
claude://はハンドラーが登録されていない端末では反応せず、リンクを踏んだ側は何も起きなかったように見えます。相手がアプリを入れているかどうか分からない場面(社外向けのドキュメント、SNSでの共有、メールでの案内など)では、フォールバックのあるUniversal Linksの方が事故が起きにくい選択です。逆に、社内ツールやランブックのように相手が全員アプリ導入済みだと分かっている場面では、claude://をそのまま使ってもリンクの見た目や動作に差はありません。パラメータの仕様は両方式で共通なので、リンクの生成ロジックを2種類用意する必要はなく、プレフィックスだけ出し分ければ済みます。
デスクトップ版との違い — 同じclaude://でも開く先が別物
紛らわしいのは、デスクトップ版のClaudeアプリ(macOS・Windows・Linux)も同じclaude://スキームに反応する点です。ただし解決先はモバイルよりずっと広く、Codeタブに限定されません。
| 比較項目 | モバイル版claude:// | デスクトップ版claude:// |
|---|---|---|
| 対応する経路 | モバイル版claude://Codeタブのみ(code / code/{id} / code/new) | デスクトップ版claude://チャット・プロジェクト・Code・Coworkの4種 |
| 新規チャットを開く | モバイル版claude://非対応 | デスクトップ版claude://claude://claude.ai/new |
| 新規Codeセッション | モバイル版claude://claude://code/new | デスクトップ版claude://claude://code/new |
| Codeセッションのフォルダー指定 | モバイル版claude://非対応(パラメータごと無視) | デスクトップ版claude://folderパラメータで指定可(確認ダイアログあり) |
| Coworkセッション | モバイル版claude://非対応 | デスクトップ版claude://claude://cowork/new |
| Universal Linksの代替経路 | モバイル版claude://https://claude.ai/code/... | デスクトップ版claude://— |
同じプレフィックスを共有していても、実際に踏める経路はプラットフォームごとに別物です。デスクトップ版のリンクをそのままモバイルに転用すると、code/new以外の経路は解決できずアプリが起動しないか、意図しない画面で止まります。ドキュメントやツールにリンクを埋め込むときは、想定する読者がどちらの環境で開くかを先に決め、経路をその環境向けに絞り込むのが安全です。
なお、Claude Codeのターミナル(CLI)にはclaude-cli://という別系統のURLスキームがあり、こちらはClaude Code Deep Linksにまとめています。claude://(アプリを開く)とclaude-cli://(ターミナルセッションを開く)は名前が似ているだけで無関係な仕組みなので、混同しないよう注意します。
紛らわしいのは名称だけではなく、同じrepoパラメータの解決のしかたもプラットフォームごとに違う点です。モバイル版・デスクトップ版のrepoはGitHubに接続済みのアカウントからリポジトリを選びますが、ターミナル版claude-cli://のrepoは、そのマシン上で過去にclaudeコマンドを実行したことのあるローカルクローンへ解決する仕組みで、GitHub連携の有無とは無関係です。同じパラメータ名でも、裏側で参照している情報源が違います。
iOSショートカットやチャットツールから呼び出す
リンクである以上、claude://はブラウザーのアドレスバーだけでなく、iOSのショートカットアプリの「URLを開く」アクションからも呼び出せます。たとえば「選択したテキストをそのままリポジトリ調査プロンプトとして送る」ショートカットを作る場合、Share Sheetで受け取ったテキストをエンコードしてqパラメータに差し込み、固定のrepoと組み合わせるだけで、アプリを開いてから貼り付ける手間が消えます。ショートカット側の作り方自体はiOSでClaudeのショートカットとウィジェットの使い方の「Ask Claude」インテントとは別の仕組みで、こちらはあくまでURLを組み立てて渡す方式です。
同じ発想は、SlackやNotionのようなチャット・ドキュメントツールにも応用できます。CIの失敗通知やインシデントのランブックにclaude://code/new?repo=...&q=...形式のリンクを1本貼っておけば、対応者はタップするだけで正しいリポジトリの調査プロンプト付きセッションに入れます。URLスキームのリンクはMarkdownの通常のハイパーリンクと同じ形式で書けるため、既存のテンプレートに追記するだけで組み込めます。ただし前述のとおり相手のアプリ導入が保証できない配布先では、Universal Linksの形式に置き換えたほうが安全です。
リンクの安全性について
claude://のリンクは、踏んだ瞬間に何かを実行するものではなく、あくまで画面遷移とプロンプトの下書きを行うだけです。デスクトップ版のCode・Coworkリンクでは、フォルダーを指定するとClaude Desktopが確認ダイアログを出してから作業ディレクトリとして採用します。モバイル版のリンクにはローカルのフォルダーを指定するパラメータがないため、この確認ステップ自体が発生しません。とはいえ、下書きされたプロンプトの内容は送信前に画面上で確認できるため、知らないところから届いたリンクを踏んでしまっても、実際にClaudeへ送られるのは自分が送信ボタンを押した内容だけです。
よくあるつまずき
- リンクを踏んでも何も起きない: 多くの場合、アカウントにClaude Codeへのアクセス権が無いことが原因です。アクセス権を確認してから踏み直します
mode=planを指定したのに反映されない: 利用中のプランでPlanモードが使えない場合、パラメータごと無視されますrepoを指定したのに選択されない: 指定したリポジトリがGitHubアカウントに接続されていないと無視されます。接続状態を先に確認しますbranchだけ指定しても効かない:branchは単独では機能せず、必ずrepoとセットで指定します- 日本語や記号を含むプロンプトでリンクが壊れる:
qの値はURLエンコードが必須です。ブラウザーの開発者ツールやencodeURIComponentでエンコードしてから埋め込みます - デスクトップ版の
folderパラメータをそのままモバイル用リンクに付けている: モバイル版はローカルの作業ディレクトリという概念自体を持たないため、folderやfileを付けても単に無視されます。プラットフォームごとにパラメータ一覧を分けて管理します - 社外に共有したリンクだけ反応しない:
claude://はアプリ未導入の端末では何も起きません。導入状況が保証できない相手にはhttps://claude.ai/code/...のUniversal Linksに切り替えます
まとめ
モバイル版のclaude://は、Codeタブのセッション一覧・既存セッション・新規セッションの3経路だけを開く、機能を絞ったURLスキームです。相手のアプリ導入状況が分からない場面では、同じパラメータをそのまま使えるhttps://claude.ai/code/...のUniversal Linksに切り替えると、フォールバックの分だけ事故が減ります。デスクトップ版は同じclaude://でもチャットやCoworkまで開ける別物の実装なので、ドキュメントやランブックに埋め込むリンクは対象プラットフォームを決めてから経路を選びます。
リンク自体の組み立て方はシンプルですが、repoの解決ロジックや無視されるパラメータのようにプラットフォームごとの細部が積み重なっている機能でもあります。社内向けのテンプレートを作るときは、モバイル・デスクトップ・ターミナルのどれを想定した文面かをコメントで残しておくと、後から見直す人が変数の意味を取り違えずに済みます。