Teil 4. Umgebung einrichten

SDD ist nicht IDE-abhängig: Der Prozess kann in jeder Umgebung durchgeführt werden, die mit Dateien und Shell-Befehlen umgehen kann. Das Hauptwerkzeug in diesem Tutorial ist Qwen Code CLI. Es wird im Terminal innerhalb des Repositories gestartet und arbeitet mit Dateien, Shell-Befehlen, Projekteinstellungen, Skills und MCP.

Terminalfenster

Am besten hält man mindestens zwei Fenster (oder zwei Tabs/Tmux-Panels) offen:

1. Qwen Code-Fenster. Hier läuft qwen im interaktiven Modus; Sie kommunizieren mit dem Agenten und lesen seine Berichte.
2. Kontrollfenster. Hier führen Sie manuell git status, git diff, npm run typecheck, npm test, curl aus. Dieses Fenster dient dazu, die Schlussfolgerungen des Agenten zu überprüfen, anstatt ihnen blind zu vertrauen.

Befehle über ! innerhalb von Qwen Code starten die Shell in derselben Sitzung, was für schnelle Kontrollen praktisch ist. Entscheidungen über Merge und Commit sollten Sie jedoch im separaten Kontrollfenster treffen, wo keine Nebeneffekte des Agenten auftreten können.

Qwen Code installieren

Prüfen Sie die aktuelle Dokumentation vor der Installation. Zum Zeitpunkt der Erstellung dieser Materialien gibt das offizielle Repository Node.js 22+ für die manuelle Installation an.

Variante über npm:

npm install -g @qwen-code/qwen-code@latest
qwen --version

Variante über Homebrew:

brew install qwen-code
qwen --version

Qwen Cloud veröffentlicht auch ein Installationsskript für Benutzer der Region Alibaba Cloud / DashScope. Verwenden Sie es nur, wenn dieser Vertriebskanal für Sie passt, und prüfen Sie aktuelle Flags mit der README des Qwen Code-Repositorys – der untenstehende Aufruf kann veraltet sein:

bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"

Authentifizierung

Stand Mai 2026 ist der kostenlose Tarif von Qwen OAuth keine zuverlässige Option mehr: Offizielle Materialien von Qwen Code geben an, dass der kostenlose Tarif am 15. April 2026 eingestellt wurde. Der praktikable Weg ist ein API-Schlüssel oder der Alibaba Cloud Coding Plan.

Interaktive Einrichtung:

qwen
/auth

Oder über einen separaten Befehl:

qwen auth
qwen auth status

Speichern Sie Schlüssel nicht in QWEN.md, AGENTS.md, Spezifikationen oder Git. Verwenden Sie Umgebungsvariablen oder .qwen/settings.json mit Verweisen auf diese.

Minimale .qwen/settings.json

Erstellen Sie die Projektkonfiguration:

mkdir -p .qwen

Beispiel ohne Geheimnisse:

{
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  },
  "$version": 3
}

Wenn Sie einen OpenAI-kompatiblen Endpunkt verwenden, speichern Sie den Schlüssel in einer Umgebungsvariablen:

export BAILIAN_API_KEY="..."

Und verweisen Sie in den Einstellungen auf die Variable:

{
  "env": {
    "BAILIAN_API_KEY": "$BAILIAN_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  },
  "$version": 3
}

QWEN.md als dauerhafter Projektspeicher

Qwen Code liest QWEN.md beim Start einer Sitzung. Wenn im Projekt bereits ein AGENTS.md existiert, kann Qwen dies ebenfalls nutzen, duplizieren Sie also nicht denselben Inhalt. Für SDD ist es praktisch, QWEN.md kurz zu halten und auf Spezifikationen zu verweisen.

Beispiel:

# QWEN.md

In diesem Projekt wird SDD verwendet.

Regeln:
- Implementiere keine Produktfeatures, solange es keine Spezifikation dafür gibt.
- Quelle der Wahrheit über das Produkt: @specs/mission.md, @specs/tech-stack.md und @specs/roadmap.md.
- Für jeden Feature-Zweig wird ein Ordner @specs/YYYY-MM-DD-feature-name/ mit requirements.md, plan.md und validation.md benötigt.
- Frage vor dem Schreiben neuer Spezifikationsdateien den Menschen nach Grenzen, Entscheidungen und Kontext.
- Nimm nur punktuelle Änderungen vor. Refaktoriere keinen unzusammenhängenden Code.
- Gib immer an, welche Dateien du geändert hast und welche Prüfbefehle du ausgeführt hast.

Hauptbefehle:
- npm run typecheck
- npm test
- npm run dev

Qwen Code-Befehle, die für SDD benötigt werden

Innerhalb einer interaktiven Sitzung:

/help
/auth
/model
/clear
/context
/compress
/summary
/resume
/stats
/skills
/memory
/init
/remember
/forget
/dream
/review

/remember, /forget und /dream gehören zum eingebauten Gedächtnis von Qwen Code und werden in Teil 19 ausführlich behandelt. /review ist die eingebaute Änderungsübersicht (sofern von Ihrer Version unterstützt). Die vollständige Liste und exakte Semantik prüfen Sie in der Dokumentation: https://qwenlm.github.io/qwen-code-docs/en/users/features/commands/.

Dateiarbeit:

@README.md Beschreibe kurz die Absicht des Projekts.
@specs/roadmap.md Welche ist die nächste unvollendete Phase?

Shell-Befehle:

!git status
!npm test
!rg "TODO|FIXME" .

Modus ohne Benutzeroberfläche für Automatisierung:

qwen -p "Lies @specs/roadmap.md und nenne die nächste unvollendete Phase. Ändere keine Dateien."

Praxis

1. Installieren Sie Qwen Code.
2. Richten Sie die Authentifizierung ein.
3. Erstellen Sie im Übungsprojekt .qwen/settings.json.
4. Erstellen Sie QWEN.md.
5. Starten Sie:

qwen

Geben Sie dann ein:

Lies @QWEN.md und @README.md.
Sag, ob dieses Repository bereit zur Erstellung einer SDD-Konstitution ist.
Schreibe keine Dateien.

Kontrollfragen

1. Worin unterscheidet sich QWEN.md von specs/mission.md?
2. Warum dürfen API-Schlüssel nicht in Spezifikationen gespeichert werden?
3. Wann sollte man qwen -p und wann interaktives qwen verwenden?