Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

claude agents --cwd <path>を追加しました。セッション一覧を特定のディレクトリにスコープできます。

原文（英語） ​

Added claude agents --cwd <path> to scope the session list to a directory

概要 ​

claude agentsコマンドはバックグラウンドで動作するエージェントセッションを管理するダッシュボードです。複数のプロジェクトを並行して扱う場合、全プロジェクトのセッションが混在して把握しづらくなります。--cwd <path>フラグを追加することで、特定のディレクトリに関連するセッションのみを表示し、プロジェクトごとのエージェント管理が容易になります。

基本的な使い方 ​

bash
# 現在のディレクトリのセッションのみ表示
claude agents --cwd .

# 特定のプロジェクトディレクトリのセッションを表示
claude agents --cwd /path/to/my-project

# 絶対パスで指定
claude agents --cwd ~/work/frontend-app

実践例 ​

複数プロジェクトを並行管理する ​

bash
# ターミナル1: バックエンドのエージェントを確認
claude agents --cwd ~/projects/backend-api

# ターミナル2: フロントエンドのエージェントを確認
claude agents --cwd ~/projects/frontend-app

# ターミナル3: インフラのエージェントを確認
claude agents --cwd ~/projects/infra

エイリアスで素早く切り替える ​

bash
# ~/.bashrc または ~/.zshrc
alias ca-backend='claude agents --cwd ~/projects/backend-api'
alias ca-frontend='claude agents --cwd ~/projects/frontend-app'
alias ca-here='claude agents --cwd .'

tmuxレイアウトでの活用 ​

bash
#!/bin/bash
# dev-agents-view.sh
# 複数プロジェクトのエージェントを分割画面で監視

tmux new-session -d -s agents -x 220 -y 50

# 左ペイン: バックエンド
tmux send-keys -t agents "claude agents --cwd ~/projects/backend" Enter

# 右ペイン: フロントエンド
tmux split-window -h -t agents
tmux send-keys -t agents "claude agents --cwd ~/projects/frontend" Enter

# 下ペイン: インフラ
tmux split-window -v -t agents
tmux send-keys -t agents "claude agents --cwd ~/projects/infra" Enter

tmux attach -t agents

スクリプトからの状態確認（非インタラクティブモード） ​

bash
# 特定プロジェクトで動いているエージェントがあるか確認
# （将来的な --json オプションとの組み合わせを想定）
claude agents --cwd ~/projects/my-app

注意点 ​

  • --cwdに指定するパスは絶対パスでも相対パスでも使用できます。
  • 指定したディレクトリで起動されたエージェントのみが表示されます。サブディレクトリのセッションが含まれるかはバージョンにより異なります。
  • --cwdなしでclaude agentsを実行すると、全セッションが表示されます（従来の動作）。
  • バックグラウンドエージェントは/bgコマンドまたは←←キー操作で起動できます。

関連情報 ​