Claude Code 多帳號管理:切換帳號、列出帳號、自動設定 IDE symlink 解決 VS Code 偵測問題

version
1.0.0

Install

/plugin install claude-switch@psychquant-claude-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add PsychQuant/psychquant-claude-plugins.

Contents

Discovered from source

Commands 4

Claude Switch - 目前帳號

顯示目前使用的 Claude Code 帳號資訊。

流程

Step 1: 檢查 CLAUDE_CONFIG_DIR

echo "🔍 目前 Claude Code 帳號"
echo "========================="
echo ""

if [ -z "$CLAUDE_CONFIG_DIR" ]; then
    echo "帳號: default (預設)"
    echo "路徑: $HOME/.claude"
    CONFIG_DIR="$HOME/.claude"
else
    ACCOUNT_NAME=$(basename "$CLAUDE_CONFIG_DIR" | sed 's/^\.claude-//')
    echo "帳號: $ACCOUNT_NAME"
    echo "路徑: $CLAUDE_CONFIG_DIR"
    CONFIG_DIR="$CLAUDE_CONFIG_DIR"
fi

Step 2: 檢查帳號狀態

echo ""
echo "📁 目錄狀態"
echo "-----------"

# 檢查目錄是否存在
if [ -d "$CONFIG_DIR" ]; then
    echo "目錄: ✅ 存在"
else
    echo "目錄: ❌ 不存在"
fi

# 檢查 IDE symlink
if [ -L "$CONFIG_DIR/ide" ]; then
    TARGET=$(readlink "$CONFIG_DIR/ide")
    echo "IDE:  ✅ symlink → $TARGET"
elif [ -d "$CONFIG_DIR/ide" ]; then
    echo "IDE:  ⚠️  是目錄(非 symlink)"
else
    echo "IDE:  ❌ 不存在"
fi

# 檢查 settings.json
if [ -f "$CONFIG_DIR/settings.json" ]; then
    echo "設定: ✅ settings.json 存在"
else
    echo "設定: ⚠️  settings.json 不存在"
fi

Step 3: 顯示登入狀態

echo ""
echo "🔐 登入狀態"
echo "-----------"

if [ -f "$CONFIG_DIR/.credentials.json" ]; then
    echo "憑證: ✅ 已登入"
else
    echo "憑證: ❌ 未登入(需要執行 claude login)"
fi

Claude Switch - 列出帳號

顯示所有可用的 Claude Code 帳號。

流程

Step 1: 找出所有帳號目錄

echo "📋 Claude Code 帳號列表"
echo "========================"
echo ""

# 預設帳號
if [ -d "$HOME/.claude" ]; then
    if [ "$CLAUDE_CONFIG_DIR" = "" ] || [ "$CLAUDE_CONFIG_DIR" = "$HOME/.claude" ]; then
        echo "  ✅ default (預設) ← 目前使用中"
    else
        echo "  ⬜ default (預設)"
    fi
    echo "     路徑: $HOME/.claude"
    echo ""
fi

# 其他帳號
for dir in "$HOME"/.claude-*; do
    if [ -d "$dir" ]; then
        ACCOUNT_NAME=$(basename "$dir" | sed 's/^\.claude-//')

        # 檢查是否為目前使用的帳號
        if [ "$CLAUDE_CONFIG_DIR" = "$dir" ]; then
            echo "  ✅ $ACCOUNT_NAME ← 目前使用中"
        else
            echo "  ⬜ $ACCOUNT_NAME"
        fi

        # 檢查 IDE symlink
        if [ -L "$dir/ide" ]; then
            echo "     IDE: ✅ symlink 已設定"
        else
            echo "     IDE: ⚠️  symlink 未設定(執行 /claude-switch:setup $ACCOUNT_NAME)"
        fi

        echo "     路徑: $dir"
        echo ""
    fi
done

Step 2: 顯示統計

TOTAL=$(ls -d "$HOME"/.claude-* 2>/dev/null | wc -l | tr -d ' ')
echo "------------------------"
echo "總計: $((TOTAL + 1)) 個帳號(含預設)"
echo ""
echo "💡 切換帳號: /claude-switch:switch <account-name>"
echo "💡 新增帳號: /claude-switch:setup <account-name>"

Claude Switch - 設定新帳號

建立新的 Claude Code 帳號目錄並設定 IDE symlink。

參數

  • $1 = 帳號名稱(如 work、personal、kiki830621)

流程

Step 1: 建立帳號目錄

ACCOUNT_NAME="$1"
CONFIG_DIR="$HOME/.claude-$ACCOUNT_NAME"

if [ -d "$CONFIG_DIR" ]; then
    echo "⚠️  帳號目錄已存在: $CONFIG_DIR"
else
    mkdir -p "$CONFIG_DIR"
    echo "✅ 建立帳號目錄: $CONFIG_DIR"
fi

Step 2: 建立 IDE symlink

if [ -L "$CONFIG_DIR/ide" ]; then
    echo "✅ IDE symlink 已存在"
elif [ -d "$CONFIG_DIR/ide" ]; then
    echo "⚠️  IDE 是目錄而非 symlink,正在修復..."
    rm -rf "$CONFIG_DIR/ide"
    ln -s "$HOME/.claude/ide" "$CONFIG_DIR/ide"
    echo "✅ IDE symlink 已建立"
else
    ln -s "$HOME/.claude/ide" "$CONFIG_DIR/ide"
    echo "✅ IDE symlink 已建立"
fi

Step 3: 確認預設 ide 目錄存在

if [ ! -d "$HOME/.claude/ide" ]; then
    mkdir -p "$HOME/.claude/ide"
    echo "✅ 建立預設 IDE 目錄: $HOME/.claude/ide"
fi

Step 4: 顯示結果

echo ""
echo "📋 帳號設定完成"
echo "==============="
echo ""
echo "帳號名稱: $ACCOUNT_NAME"
echo "設定目錄: $CONFIG_DIR"
echo ""
ls -la "$CONFIG_DIR/"
echo ""
echo "📌 下一步"
echo "---------"
echo ""
echo "1. 切換到此帳號:"
echo "   export CLAUDE_CONFIG_DIR=$CONFIG_DIR"
echo ""
echo "2. 登入 Claude:"
echo "   claude login"
echo ""
echo "3. 或使用 shell 函數(加入 ~/.zshrc):"
echo ""
echo "   claude-switch() {"
echo "       export CLAUDE_CONFIG_DIR=\"\$HOME/.claude-\$1\""
echo "       echo \"Switched to Claude account: \$1\""
echo "   }"
echo ""
echo "   然後執行: claude-switch $ACCOUNT_NAME"

IDE Symlink 說明

VS Code 的 Claude Code 擴充套件固定使用 ~/.claude/ide/ 目錄。 透過 symlink,所有帳號都能共用同一個 IDE 連接:

~/.claude/ide/                    ← VS Code 擴充套件寫入
~/.claude-kiki830621/ide/         → symlink
~/.claude-work/ide/               → symlink
~/.claude-personal/ide/           → symlink

這樣不管切換到哪個帳號,/ide 都能正常偵測 VS Code。

Claude Switch - 切換帳號

切換到指定的 Claude Code 帳號。

參數

  • $1 = 帳號名稱(如 kiki830621、work、personal)

流程

Step 1: 確認帳號目錄存在

ACCOUNT_NAME="$1"
CONFIG_DIR="$HOME/.claude-$ACCOUNT_NAME"

if [ ! -d "$CONFIG_DIR" ]; then
    echo "❌ 帳號目錄不存在: $CONFIG_DIR"
    echo "請先執行: /claude-switch:setup $ACCOUNT_NAME"
    exit 1
fi

Step 2: 確認 IDE symlink 存在

if [ ! -L "$CONFIG_DIR/ide" ]; then
    echo "⚠️  IDE symlink 不存在,正在建立..."
    ln -s "$HOME/.claude/ide" "$CONFIG_DIR/ide"
    echo "✅ IDE symlink 已建立"
fi

Step 3: 輸出切換指令

重要: Claude Code 無法直接修改 shell 環境變數。輸出指令讓使用者執行:

echo ""
echo "📋 請在終端機執行以下指令來切換帳號:"
echo ""
echo "    export CLAUDE_CONFIG_DIR=$CONFIG_DIR"
echo ""
echo "💡 建議加入 ~/.zshrc 或 ~/.bashrc:"
echo ""
echo "    # Claude Code 帳號切換函數"
echo "    claude-switch() {"
echo "        export CLAUDE_CONFIG_DIR=\"\$HOME/.claude-\$1\""
echo "        echo \"Switched to Claude account: \$1\""
echo "    }"
echo ""

Step 4: 顯示帳號資訊

echo "📁 帳號目錄: $CONFIG_DIR"
echo ""
ls -la "$CONFIG_DIR/" | head -10

注意事項

  1. 切換帳號後需要重新啟動 Claude Code session
  2. VS Code 的 Claude Code 擴充套件不受 CLAUDE_CONFIG_DIR 影響
  3. IDE 連接透過 symlink 共用,不受帳號切換影響

Sponsors

Details

Marketplace
PsychQuant/psychquant-claude-plugins
Source
plugins/claude-switch
Author
Che Cheng
Category
Productivity

More from PsychQuant/psychquant-claude-plugins

All 42