Wir erstellen eine Schritt-für-Schritt-Anleitung für die Einrichtung einer Developer-Workstation auf Debian Linux 12/13 mit Aider, Claude Code (optional, da Aider bereits ein CLI-Tool ist), tmux und DeepSeek über OpenRouter.

Hinweis: Claude Code ist nicht direkt als separates Tool erforderlich, da Aider die LLM-Integration bereits bereitstellt. Wir konzentrieren uns auf Aider mit DeepSeek über OpenRouter.

1. Systemaktualisierung und Installation von Grundlagen
2. Installation von tmux und Konfiguration
3. Installation von Aider
4. Einrichtung von OpenRouter für DeepSeek
5. Konfiguration von Aider für OpenRouter und DeepSeek
6. Beispiel-Workflow

Los geht's!

🚀 DeepSeek + Aider + tmux Workflow Setup für Debian 12/13

📋 Voraussetzungen

• Debian Linux 12 oder 13
• Root-Zugriff oder sudo-Berechtigungen
• Internet-Verbindung

🔧 Schritt 1: Systemaktualisierung und Grundinstallation

# Basis-Tools installieren
sudo apt update && sudo apt upgrade
sudo apt install git curl python3 python3-pip python3-venv \
wget vim nano nodejs npm build-essential tmux tree htop jq

🐍 Schritt 2: Python-Umgebung einrichten

bash # Python Virtual Environment erstellen
python3 -m venv ~/aider-env
source ~/aider-env/bin/activate

# Pip aktualisieren
pip install --upgrade pip

🤖 Schritt 3: Aider installieren

bash # Aider im Virtual Environment installieren
pip install aider-chat

# Oder die neueste Version von GitHub
# pip install git+https://github.com/paul-gauthier/aider.git

🌐 Schritt 4: OpenRouter API Zugriff einrichten

OpenRouter Account vorbereiten:

1. Account erstellen auf https://openrouter.ai/
2. API Key generieren im Dashboard
3. DeepSeek Modelle freischalten (kostenlos verfügbar)

Environment Variables setzen:

bash # In ~/.bashrc oder ~/.profile eintragen
echo 'export OPENROUTER_API_KEY="sk-or-your-key-here"' >> ~/.bashrc
echo 'export AIDER_MODEL="deepseek/deepseek-chat"' >> ~/.bashrc
echo 'export AIDER_PROVIDER="openrouter"' >> ~/.bashrc

# Environment laden
source ~/.bashrc

⚙️ Schritt 5: Aider Konfiguration

bash # Konfigurationsverzeichnis erstellen
mkdir -p ~/.config/aider

# Konfigurationsdatei erstellen
cat > ~/.config/aider/config.yml << 'EOF'
model: deepseek/deepseek-chat
provider: openrouter
openrouter:
api_base: https://openrouter.ai/api/v1
models:
- deepseek/deepseek-chat
- deepseek/deepseek-coder
auto-commits: true
pretty: true
encoding: utf-8
EOF

🖥️ Schritt 6: tmux Konfiguration optimieren

bash # tmux Konfiguration erstellen
cat > ~/.tmux.conf << 'EOF'
# Basis Einstellungen
set -g default-terminal "screen-256color"
set -g base-index 1
set -g pane-base-index 1
set -g renumber-windows on

# Mouse Support
set -g mouse on

# Pane Borders
set -g pane-border-status top
set -g pane-border-format "#{pane_index} #{pane_current_command}"

# Key Bindings
bind | split-window -h
bind - split-window -v
unbind '"'
unbind %

# Quick Window Creation
bind c new-window -c "#{pane_current_path}"
bind % split-window -h -c "#{pane_current_path}"
bind '"' split-window -v -c "#{pane_current_path}"

# Status Bar
set -g status-interval 1
set -g status-right "#(date '+%H:%M') | %a %d-%b-%y"
EOF

# tmux Konfiguration laden
tmux source-file ~/.tmux.conf

🔄 Schritt 7: Shell Aliases für Workflow

bash# Nützliche Aliases in ~/.bashrc
cat >> ~/.bashrc << 'EOF'

# Developer Aliases
alias dev-session='tmux new-session -s dev'
alias attach-dev='tmux attach -t dev'
alias ls-sessions='tmux list-sessions'

# Aider mit DeepSeek
alias ai='aider --model deepseek/deepseek-chat'
alias ai-coder='aider --model deepseek/deepseek-coder'

# Git Shortcuts
alias gs='git status'
alias gc='git commit'
alias gp='git push'

# Navigation
alias ..='cd ..'
alias ...='cd ../..'
alias ll='ls -la'
EOF

# Shell neu laden
source ~/.bashrc

🧪 Schritt 8: Test-Setup

OpenRouter Verbindung testen:

bash# API Test mit curl
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-d '{
"model": "deepseek/deepseek-chat",
"messages": [
{"role": "user", "content": "Hello, please respond with '✅ Connected' if you can read this."}
]
}' \
https://openrouter.ai/api/v1/chat/completions | jq '.choices[0].message.content'

Aider Test:

bash# Test-Projekt erstellen
mkdir -p ~/dev-test && cd ~/dev-test
git init
echo "# Test Project" > README.md

# Aider starten
aider --model deepseek/deepseek-chat

🎯 Schritt 9: Optimierter tmux Workflow Setup

Session Template erstellen:

bash#!/bin/bash
# ~/bin/dev-setup.sh

tmux new-session -d -s dev -n 'workspace'
tmux split-window -h -t dev
tmux split-window -v -t dev:1.1
tmux split-window -v -t dev:1.2

# Pane 1: Aider mit DeepSeek
tmux send-keys -t dev:1.1 'cd ~/projects && source ~/aider-env/bin/activate' C-m
tmux send-keys -t dev:1.1 'echo "Ready for Aider + DeepSeek"' C-m

# Pane 2: Code Editor
tmux send-keys -t dev:1.2 'cd ~/projects && nvim .' C-m

# Pane 3: Git/Shell
tmux send-keys -t dev:1.3 'cd ~/projects' C-m

# Pane 4: Tests/Logs
tmux send-keys -t dev:1.4 'cd ~/projects && echo "Tests/Logs pane"' C-m

# Zur Session wechseln
tmux attach -t dev

Script ausführbar machen:

bashmkdir -p ~/bin
chmod +x ~/bin/dev-setup.sh
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

📊 Schritt 10: Workflow Validierung

Test-Session starten:

bashdev-setup.sh

# Erwartetes Layout:
+--------------+-------------+
│    Aider     │   Editor    │
│  (DeepSeek)  │   (vim)     │
+--------------+-------------+
│    Git       │   Tests     │
│   (shell)    │   (logs)    │
+--------------+-------------+

🔍 Troubleshooting

Häufige Probleme:

1. OpenRouter Connection Failed:

bash# API Key überprüfen
echo $OPENROUTER_API_KEY

# Network test
curl -I https://openrouter.ai/api/v1

2. Aider Model Not Found:

bash# Verfügbare Modelle auflisten
aider --list-models

3. Python Path Issues:

bash# Virtual Environment sicherstellen
which python3
which pip
source ~/aider-env/bin/activate

📝 Quick Reference Cheat Sheet

bash# 🚀 Session Management
dev-session # Neue Dev Session
attach-dev # Session rejoinen
tmux kill-session -t dev # Session beenden

# 🤖 Aider Commands
ai # Aider mit DeepSeek starten
ai --help # Hilfe anzeigen

# 🔧 Tmux Shortcuts
Ctrl+b % # Horizontal teilen
Ctrl+b " # Vertikal teilen
Ctrl+b c # Neues Fenster
Ctrl+b d # Session detachen

✅ Erfolgskriterien

• Aider startet ohne Fehler
• DeepSeek antwortet über OpenRouter
• tmux Session mit 4 Panes startet
• Git Integration funktioniert
• Code-Änderungen können committet werden

Dieses Setup bietet einen professionellen AI-gestützten Development Workflow auf Debian