← Back to Kontasks
Dual-Account Setup Guide for Konsole
Step-by-step guide to set up Max 20x + Max 5x credential switching in konsole
Output
🔧 Dual-Account Setup Guide
Goal: Switch between Max 20× (primary) and Max 5× (secondary) accounts in konsole
Phase 1: Manual Setup (You Do This)
Step 1: Backup Current Credentials (Max 20×)
# SSH into the server cp -r ~/.claude ~/.claude-max20x
Step 2: Login to Max 5× Account
# Clear current auth rm -rf ~/.claude # Login fresh with your new Max 5x account claude # This will prompt OAuth login # After login completes, verify it's the 5x account cat ~/.claude/.credentials.json | grep rateLimitTier # Should show: "rateLimitTier":"default_claude_max_5x"
Step 3: Backup Max 5× Credentials
cp -r ~/.claude ~/.claude-max5x
Step 4: Restore Primary (Max 20×) as Default
rm -rf ~/.claude ln -s ~/.claude-max20x ~/.claude # Verify cat ~/.claude/.credentials.json | grep rateLimitTier # Should show: "rateLimitTier":"default_claude_max_20x"
Phase 2: Konsole Integration (I'll Implement)
Once you have both credential directories set up, I'll add:
1. Account Switcher in Konui
- Dropdown in status bar:
[20× ▼]/[5×] - Shows current account + quota status
2. Konsole Account Config
# konsole/.env CLAUDE_ACCOUNTS=max20x,max5x CLAUDE_ACCOUNT_MAX20X_DIR=/home/bb/.claude-max20x CLAUDE_ACCOUNT_MAX5X_DIR=/home/bb/.claude-max5x CLAUDE_DEFAULT_ACCOUNT=max20x CLAUDE_QUICKTURN_ACCOUNT=max5x
3. Smart Routing
- Quick Turn → Always use Max 5×
- Full turns → Use selected account (default: 20×)
- Manual override via dropdown
Final Directory Structure
/home/bb/ ├── .claude → .claude-max20x # symlink (active) ├── .claude-max20x/ # Primary account │ └── .credentials.json # OAuth tokens └── .claude-max5x/ # Secondary account └── .credentials.json # OAuth tokens
⚠️ Important Notes
- Don't run claude CLI directly while konsole is managing accounts - use the dashboard
- Tokens expire - if you get auth errors, re-login to that account
- Sessions are per-account - conversation history doesn't transfer between accounts
📋 Checklist
| Create Max 5× subscription on new account |
| Backup current ~/.claude to ~/.claude-max20x |
Login to Max 5× account via claude |
| Copy to ~/.claude-max5x |
| Symlink ~/.claude → ~/.claude-max20x |
| Tell me when ready for Phase 2 |
Quick Actions
Original Request
No layout configured
Details
Type
General
Status
Completed
Scope
vibetools
Tags
konsoleauthenticationarchitecture
Created
8 Jan 2026, 7:12 am
Updated
8 Jan 2026, 7:12 am
Created By
claude
Raw Data
{
"id": "4dc2ed3f-86a0-4aba-9912-a7269ea57648",
"type": "general",
"status": "completed",
"title": "Dual-Account Setup Guide for Konsole",
"description": "Step-by-step guide to set up Max 20x + Max 5x credential switching in konsole",
"context": {
"output": "<div style=\"background:#1e1e1e;color:#e0e0e0;padding:20px;border-radius:8px;font-family:sans-serif;\">\n<h2 style=\"color:#fff;margin:0 0 16px 0;\">🔧 Dual-Account Setup Guide</h2>\n\n<div style=\"background:#1e3a5f;padding:12px 16px;border-radius:6px;margin-bottom:16px;border:1px solid #3b82f6;\">\n<p style=\"margin:0;color:#fff;\"><strong>Goal:</strong> Switch between Max 20× (primary) and Max 5× (secondary) accounts in konsole</p>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#f59e0b;margin:0 0 12px 0;\">Phase 1: Manual Setup (You Do This)</h3>\n\n<div style=\"background:#1e1e1e;padding:12px;border-radius:4px;margin-bottom:12px;\">\n<p style=\"margin:0 0 8px 0;color:#22c55e;font-weight:bold;\">Step 1: Backup Current Credentials (Max 20×)</p>\n<pre style=\"background:#2d2d2d;padding:10px;border-radius:4px;margin:8px 0 0 0;overflow-x:auto;\"><span style=\"color:#7f848e;\"># SSH into the server</span>\n<span style=\"color:#c678dd;\">cp</span> -r ~/.claude ~/.claude-max20x</pre>\n</div>\n\n<div style=\"background:#1e1e1e;padding:12px;border-radius:4px;margin-bottom:12px;\">\n<p style=\"margin:0 0 8px 0;color:#22c55e;font-weight:bold;\">Step 2: Login to Max 5× Account</p>\n<pre style=\"background:#2d2d2d;padding:10px;border-radius:4px;margin:8px 0 0 0;overflow-x:auto;\"><span style=\"color:#7f848e;\"># Clear current auth</span>\n<span style=\"color:#c678dd;\">rm</span> -rf ~/.claude\n\n<span style=\"color:#7f848e;\"># Login fresh with your new Max 5x account</span>\n<span style=\"color:#c678dd;\">claude</span> <span style=\"color:#7f848e;\"># This will prompt OAuth login</span>\n\n<span style=\"color:#7f848e;\"># After login completes, verify it's the 5x account</span>\n<span style=\"color:#c678dd;\">cat</span> ~/.claude/.credentials.json | <span style=\"color:#c678dd;\">grep</span> rateLimitTier\n<span style=\"color:#7f848e;\"># Should show: \"rateLimitTier\":\"default_claude_max_5x\"</span></pre>\n</div>\n\n<div style=\"background:#1e1e1e;padding:12px;border-radius:4px;margin-bottom:12px;\">\n<p style=\"margin:0 0 8px 0;color:#22c55e;font-weight:bold;\">Step 3: Backup Max 5× Credentials</p>\n<pre style=\"background:#2d2d2d;padding:10px;border-radius:4px;margin:8px 0 0 0;overflow-x:auto;\"><span style=\"color:#c678dd;\">cp</span> -r ~/.claude ~/.claude-max5x</pre>\n</div>\n\n<div style=\"background:#1e1e1e;padding:12px;border-radius:4px;\">\n<p style=\"margin:0 0 8px 0;color:#22c55e;font-weight:bold;\">Step 4: Restore Primary (Max 20×) as Default</p>\n<pre style=\"background:#2d2d2d;padding:10px;border-radius:4px;margin:8px 0 0 0;overflow-x:auto;\"><span style=\"color:#c678dd;\">rm</span> -rf ~/.claude\n<span style=\"color:#c678dd;\">ln</span> -s ~/.claude-max20x ~/.claude\n\n<span style=\"color:#7f848e;\"># Verify</span>\n<span style=\"color:#c678dd;\">cat</span> ~/.claude/.credentials.json | <span style=\"color:#c678dd;\">grep</span> rateLimitTier\n<span style=\"color:#7f848e;\"># Should show: \"rateLimitTier\":\"default_claude_max_20x\"</span></pre>\n</div>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#3b82f6;margin:0 0 12px 0;\">Phase 2: Konsole Integration (I'll Implement)</h3>\n\n<p style=\"margin:0 0 12px 0;\">Once you have both credential directories set up, I'll add:</p>\n\n<div style=\"background:#1e1e1e;padding:12px;border-radius:4px;margin-bottom:12px;\">\n<p style=\"margin:0;color:#8b5cf6;font-weight:bold;\">1. Account Switcher in Konui</p>\n<ul style=\"margin:8px 0 0 0;padding-left:20px;line-height:1.6;color:#9ca3af;\">\n<li>Dropdown in status bar: <code style=\"background:#3d3d3d;padding:2px 6px;border-radius:3px;\">[20× ▼]</code> / <code style=\"background:#3d3d3d;padding:2px 6px;border-radius:3px;\">[5×]</code></li>\n<li>Shows current account + quota status</li>\n</ul>\n</div>\n\n<div style=\"background:#1e1e1e;padding:12px;border-radius:4px;margin-bottom:12px;\">\n<p style=\"margin:0;color:#8b5cf6;font-weight:bold;\">2. Konsole Account Config</p>\n<pre style=\"background:#2d2d2d;padding:10px;border-radius:4px;margin:8px 0 0 0;overflow-x:auto;\"><span style=\"color:#7f848e;\"># konsole/.env</span>\n<span style=\"color:#e5c07b;\">CLAUDE_ACCOUNTS</span>=<span style=\"color:#98c379;\">max20x,max5x</span>\n<span style=\"color:#e5c07b;\">CLAUDE_ACCOUNT_MAX20X_DIR</span>=<span style=\"color:#98c379;\">/home/bb/.claude-max20x</span>\n<span style=\"color:#e5c07b;\">CLAUDE_ACCOUNT_MAX5X_DIR</span>=<span style=\"color:#98c379;\">/home/bb/.claude-max5x</span>\n<span style=\"color:#e5c07b;\">CLAUDE_DEFAULT_ACCOUNT</span>=<span style=\"color:#98c379;\">max20x</span>\n<span style=\"color:#e5c07b;\">CLAUDE_QUICKTURN_ACCOUNT</span>=<span style=\"color:#98c379;\">max5x</span></pre>\n</div>\n\n<div style=\"background:#1e1e1e;padding:12px;border-radius:4px;\">\n<p style=\"margin:0;color:#8b5cf6;font-weight:bold;\">3. Smart Routing</p>\n<ul style=\"margin:8px 0 0 0;padding-left:20px;line-height:1.6;color:#9ca3af;\">\n<li>Quick Turn → Always use Max 5×</li>\n<li>Full turns → Use selected account (default: 20×)</li>\n<li>Manual override via dropdown</li>\n</ul>\n</div>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#22c55e;margin:0 0 12px 0;\">Final Directory Structure</h3>\n<pre style=\"background:#1e1e1e;padding:12px;border-radius:4px;margin:0;overflow-x:auto;line-height:1.8;\"><span style=\"color:#56b6c2;font-weight:bold;\">/home/bb/</span>\n├── <span style=\"color:#61afef;\">.claude</span> → <span style=\"color:#98c379;\">.claude-max20x</span> <span style=\"color:#7f848e;\"># symlink (active)</span>\n├── <span style=\"color:#98c379;font-weight:bold;\">.claude-max20x/</span> <span style=\"color:#7f848e;\"># Primary account</span>\n│ └── <span style=\"color:#e5c07b;\">.credentials.json</span> <span style=\"color:#7f848e;\"># OAuth tokens</span>\n└── <span style=\"color:#98c379;font-weight:bold;\">.claude-max5x/</span> <span style=\"color:#7f848e;\"># Secondary account</span>\n └── <span style=\"color:#e5c07b;\">.credentials.json</span> <span style=\"color:#7f848e;\"># OAuth tokens</span></pre>\n</div>\n\n<div style=\"background:#f59e0b;padding:12px 16px;border-radius:6px;margin-bottom:16px;color:#000;\">\n<h3 style=\"margin:0 0 8px 0;\">⚠️ Important Notes</h3>\n<ul style=\"margin:0;padding-left:20px;line-height:1.6;\">\n<li><strong>Don't run claude CLI directly</strong> while konsole is managing accounts - use the dashboard</li>\n<li><strong>Tokens expire</strong> - if you get auth errors, re-login to that account</li>\n<li><strong>Sessions are per-account</strong> - conversation history doesn't transfer between accounts</li>\n</ul>\n</div>\n\n<div style=\"background:#1e3a5f;padding:16px;border-radius:6px;border:1px solid #3b82f6;\">\n<h3 style=\"color:#fff;margin:0 0 12px 0;\">📋 Checklist</h3>\n<table style=\"width:100%;\">\n<tr>\n<td style=\"padding:6px 0;\"><input type=\"checkbox\" disabled> Create Max 5× subscription on new account</td>\n</tr>\n<tr>\n<td style=\"padding:6px 0;\"><input type=\"checkbox\" disabled> Backup current ~/.claude to ~/.claude-max20x</td>\n</tr>\n<tr>\n<td style=\"padding:6px 0;\"><input type=\"checkbox\" disabled> Login to Max 5× account via <code>claude</code></td>\n</tr>\n<tr>\n<td style=\"padding:6px 0;\"><input type=\"checkbox\" disabled> Copy to ~/.claude-max5x</td>\n</tr>\n<tr>\n<td style=\"padding:6px 0;\"><input type=\"checkbox\" disabled> Symlink ~/.claude → ~/.claude-max20x</td>\n</tr>\n<tr>\n<td style=\"padding:6px 0;\"><input type=\"checkbox\" disabled> Tell me when ready for Phase 2</td>\n</tr>\n</table>\n</div>\n</div>",
"choices": [
{
"label": "Start Phase 1 now",
"value": "I'm ready to do Phase 1 now - help me run the commands to backup my current credentials and prepare for the Max 5x login",
"primary": true
},
{
"label": "I've done Phase 1",
"value": "I've completed Phase 1 - both credential directories are set up. Implement Phase 2: the konsole account switching integration"
},
{
"label": "Need to create account first",
"value": "I need to create the Max 5x subscription first. I'll come back when that's ready"
},
{
"label": "Questions about setup",
"value": "I have questions about this setup before proceeding"
}
],
"requestedAt": "2026-01-08T11:05:00Z",
"requestId": "8453e0e7-f4b7-498a-b413-4cd613a22a7a"
},
"createdBy": "claude",
"createdAt": "2026-01-07T21:12:39.222Z",
"updatedAt": "2026-01-07T21:12:39.461Z",
"requestId": "8453e0e7-f4b7-498a-b413-4cd613a22a7a",
"scope": "vibetools",
"tags": [
"konsole",
"authentication",
"architecture"
],
"targetUser": "claude"
}