Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

VSCode: vscode://anthropic.claude-code/open URIハンドラを追加しました。オプションの prompt と session クエリパラメータを使って、プログラムから新しいClaude Codeタブを開けます。

原文（英語） ​

VSCode: Added vscode://anthropic.claude-code/open URI handler to open a new Claude Code tab programmatically, with optional prompt and session query parameters

概要 ​

VSCode拡張機能向けに vscode://anthropic.claude-code/open というURIハンドラが追加されました。このURIをブラウザや外部ツールから呼び出すことで、VSCode内に新しいClaude Codeタブをプログラムから開くことができます。prompt パラメータで初期メッセージを設定したり、session パラメータで既存のセッションを再開したりできます。

基本的な使い方 ​

# 新しいClaude Codeタブを開く
vscode://anthropic.claude-code/open

# 初期プロンプト付きで開く
vscode://anthropic.claude-code/open?prompt=こんにちは

# 既存セッションを再開する
vscode://anthropic.claude-code/open?session=SESSION_ID

実践例 ​

ブラウザやシェルからVSCodeのClaude Codeを起動 ​

bash
# macOS
open "vscode://anthropic.claude-code/open"

# Linux (xdg-open)
xdg-open "vscode://anthropic.claude-code/open"

# Windows (PowerShell)
Start-Process "vscode://anthropic.claude-code/open"

初期プロンプト付きで起動 ​

bash
# URLエンコードが必要な場合は適切にエンコードしてください
open "vscode://anthropic.claude-code/open?prompt=このプロジェクトのバグを修正して"

# Python スクリプトからの起動例
import subprocess
import urllib.parse

prompt = "src/api.py のエラーハンドリングを改善して"
encoded_prompt = urllib.parse.quote(prompt)
uri = f"vscode://anthropic.claude-code/open?prompt={encoded_prompt}"
subprocess.run(["open", uri])  # macOS

特定セッションの再開 ​

bash
# セッションIDを指定して再開
open "vscode://anthropic.claude-code/open?session=abc123def456"

カスタムスクリプトやランチャーとの統合 ​

bash
#!/bin/bash
# claude-open.sh: プロジェクトディレクトリからClaude Codeを開く

PROJECT=$(basename "$(pwd)")
PROMPT="$PROJECT プロジェクトを開きました。何か手伝えることはありますか？"
ENCODED_PROMPT=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$PROMPT'))")

open "vscode://anthropic.claude-code/open?prompt=$ENCODED_PROMPT"

Alfred / Raycast などのランチャーとの統合 ​

Alfred ワークフローやRaycastスクリプトからVSCodeのClaude Codeを素早く起動できます。

# Alfred カスタムURL
vscode://anthropic.claude-code/open?prompt={query}

クエリパラメータ ​

パラメータ説明例
prompt新しいタブに入力する初期メッセージ（URLエンコード必須）?prompt=Hello
session再開するセッションのID?session=abc123

注意点 ​

  • URLに日本語や特殊文字を含む場合は、URLエンコード（パーセントエンコード）が必要です
  • prompt と session は同時に使用できますが、セッション再開時のプロンプトの挙動はセッション状態によって異なる場合があります
  • このURIハンドラはVSCode拡張機能版のClaude Codeにのみ対応しています。CLIバージョンには適用されません
  • VSCodeが起動していない場合、URIの処理はOSの設定によって異なります

関連情報 ​