Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

macOSでclaude-cli://ディープリンクが開かない問題を修正しました。

原文（英語） ​

Fixed claude-cli:// deep links not opening on macOS

概要 ​

macOS環境でclaude-cli://カスタムURLスキームを使ったディープリンクが機能せず、ブラウザや他のアプリからClaude Codeを起動・操作できない問題が修正されました。ディープリンクはVS CodeなどのエディタやWebアプリからClaude Codeを連携起動するために使用されます。v2.1.89でmacOSのURL処理が修正され、正常に動作するようになりました。

基本的な使い方 ​

bash
# claude-cli:// ディープリンクの例
# ブラウザのアドレスバーに入力するか、コマンドラインから開く

# コマンドラインからディープリンクを開く
open "claude-cli://session/SESSION_ID"

# 特定のプロンプトで起動する例
open "claude-cli://prompt?text=Hello%20Claude"

実践例 ​

ブラウザからClaude Codeを起動する ​

html
<!-- WebページからClaude Codeを起動するリンク例 -->
<a href="claude-cli://open">Claude Codeで開く</a>

<!-- 特定のセッションを再開するリンク -->
<a href="claude-cli://session/abc123">セッションを再開</a>

VS CodeエクステンションやツールからのAPI連携 ​

bash
# ターミナルから直接テスト
open "claude-cli://open"

# 修正前: macOSでこのコマンドが無視されていた
# 修正後: Claude Codeが正常に起動する

スクリプトからの自動起動 ​

bash
#!/bin/bash
# 特定のタスクでClaude Codeを自動起動するスクリプト

TASK="コードレビューをしてください"
ENCODED_TASK=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$TASK'))")

# macOSでディープリンクを開く
open "claude-cli://prompt?text=$ENCODED_TASK"

注意点 ​

  • この問題はmacOS固有の問題でした（Linux/Windowsは影響なし）
  • ディープリンク機能を使用するには、Claude Codeがmacにインストールされている必要があります
  • 初回使用時はOSからClaude Codeの起動許可を求められる場合があります
  • セキュリティ上の理由から、信頼できるソースからのディープリンクのみを使用してください

関連情報 ​