# SiYuan (思源笔记) an QCode anbinden: Windows 11 Schritt für Schritt mit Bildern

Arbeiten Sie die folgenden 13 Schritte durch: Danach ist SiYuan unter Windows 11 installiert und in der integrierten „KI“ mit QCode verbunden, sodass Sie direkt im Notiztext mit KI schreiben und in der Seitenleiste mit mehreren Modellen im „Agent“ chatten können.


**Kurz gesagt**: Klicken Sie in SiYuan v3.8.11 oben links auf das Hauptmenü → 「设置」（„Einstellungen“）→ 「人工智能」（„KI“）→ 「+ 添加提供商」（„+ Anbieter hinzufügen“）, wählen Sie die Voreinstellung 「OpenAI」, tragen Sie als 「API 基础地址」（„API-Basisadresse“）`https://api.qcode.cc/openai/v1` ein, ändern Sie den 「API 类型」（„API-Typ“）von der Voreinstellung `Responses` auf `Chat Completions`, fügen Sie den mit `cr_` beginnenden QCode-Key ein und konfigurieren Sie `gpt-6.2-sol` — dann stehen „KI-Schreiben“ und „Agent“ bereit.

| Punkt | Eintrag |
|---|---|
| Konfigurationsort | `Einstellungen → KI → API-Anbieter → OpenAI` |
| API-Basisadresse | `https://api.qcode.cc/openai/v1` |
| API-Typ | `Chat Completions` |
| API-Key | `cr_xxxxxxxx` |
| Empfohlenes Standardmodell | `gpt-6.2-sol` |

Geprüft am 2026-11-22 · SiYuan v3.8.11 · Windows 11


SiYuan (思源笔记) ist eine local-first arbeitende Software für persönliches Wissensmanagement mit Blockreferenzen, bidirektionalen Links und Gliederungsbearbeitung. In der aktuellen Version sind „KI“ und der „Agent“ in der Seitenleiste bereits nativ integriert; für die lokale Nutzung brauchen Sie weder Drittanbieter-Plugins noch eine Anmeldung bei einem SiYuan- oder OpenAI-Konto.


- **Gilt für**: Windows 10 / 11 (64-Bit)
- **Softwareversion**: SiYuan (思源笔记) v3.8.11
- **Screenshots aktualisiert**: 2026-11
- **Zeitbedarf**: etwa 10 Minuten
- **Sie brauchen**: einen QCode-API-Key, der mit `cr_` beginnt



- Ein PC mit Windows 10 / 11 (64-Bit; auf ARM64-Rechnern wählen Sie stattdessen das Paket `win-arm64.exe`)
- Sie haben sich bereits bei QCode.cc registriert und den mit `cr_` beginnenden API-Key im [Dashboard](https://qcode.cc/de/dashboard) kopiert. Noch kein Konto? [Registrieren](https://qcode.cc/de/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-siyuan-before) Sie sich zuerst bei QCode, wählen Sie auf der [Preisseite](https://qcode.cc/de/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-siyuan-before) einen Tarif und erstellen Sie den Key anschließend im [Dashboard](https://qcode.cc/de/dashboard).
- Der PC erreicht `b3log.org` (oder `github.com` / Microsoft Store) sowie `api.qcode.cc` normal
- Auf der lokalen Festplatte ist ein normaler Ordner als Arbeitsbereich vorbereitet (zum Beispiel `C:\SiYuanWorkspace`); wählen Sie keinen synchronisierten Ordner wie OneDrive, iCloud oder Nutstore
- Lokale Notizen und die integrierte KI brauchen keine Anmeldung bei einem SiYuan-Konto; reservieren Sie rund 10 Minuten für die Schritte


## Download und Installation

SiYuan bietet unter Windows ein offizielles eigenständiges Installationspaket und den Microsoft Store als zwei Installationswege. Die offiziellen Kanäle sind:

- **Offizielle Downloadseite**: [b3log.org/siyuan/download.html](https://b3log.org/siyuan/download.html) (zwei direkte Einstiege: „x86_64-Installationspaket“ und „Microsoft Store“)
- **Microsoft Store**: [SiYuan-Seite im Microsoft Store](https://apps.microsoft.com/detail/9p7hpmxp73k4) (offiziell für die Desktop-Nutzung empfohlen, unterstützt Ein-Klick-Updates)
- **GitHub Releases**: [siyuan-note/siyuan Releases](https://github.com/siyuan-note/siyuan/releases) (64-Bit-Rechner: `siyuan-3.8.11-win.exe`, ARM64-Rechner: `siyuan-3.8.11-win-arm64.exe`; die Versionsnummer im Dateinamen ändert sich mit den Updates; laden Sie keine `.apk`-, `.dmg`- oder `linux`-Pakete herunter)

Die Download-Geschwindigkeit unterscheidet sich je nach Region leicht; wählen Sie zuerst Ihre Region:

**Übersee / andere Regionen**

- Installieren Sie bevorzugt über den [Microsoft Store](https://apps.microsoft.com/detail/9p7hpmxp73k4); spätere Updates sind damit am einfachsten.
- Wenn Sie ein Offline-Installationsprogramm brauchen, laden Sie `siyuan-3.8.11-win.exe` von [GitHub Releases](https://github.com/siyuan-note/siyuan/releases) oder von der [offiziellen Downloadseite](https://b3log.org/siyuan/download.html) herunter (ARM64-Rechner: `siyuan-3.8.11-win-arm64.exe`).


**Festlandchina**

- Öffnen Sie bevorzugt die offizielle Downloadseite [b3log.org/siyuan/download.html](https://b3log.org/siyuan/download.html) und klicken Sie direkt auf „x86_64-Installationspaket“, um `siyuan-3.8.11-win.exe` herunterzuladen (rund 230 MB, direkte Verbindung ist schnell).
- Alternativ können Sie SiYuan über die in Windows enthaltene Suche im Microsoft Store installieren und später mit einem Klick aktualisieren.
- Das Installationspaket ist gültig digital signiert und steht standardmäßig auf „Nur für mich installieren“; normalerweise erscheint keine Administratorabfrage.


## Mit Screenshots arbeiten: Windows Schritt für Schritt

In den folgenden 13 Schritten erledigt jeder Schritt genau eine Sache; die orangen Nummern in den Screenshots entsprechen den Nummern ①②③ im Text.



### Das SiYuan-Installationspaket herunterladen

Öffnen Sie die offizielle Downloadseite [b3log.org/siyuan/download.html](https://b3log.org/siyuan/download.html) im Browser. Klicken Sie auf die blaue Schaltfläche „x86_64-Installationspaket (für ein Upgrade erneut herunterladen)“, auf die ① zeigt, und laden Sie das Windows-64-Bit-Installationsprogramm herunter (für automatische Updates können Sie rechts auch auf „Microsoft Store (unterstützt Ein-Klick-Upgrade)“ klicken).

![Offizielle SiYuan-Downloadseite geöffnet; Klick auf „x86_64-Installationspaket“ lädt das Windows-x64-Installationsprogramm herunter (v3.8.11)](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/01-download-page.webp)


Richtig gemacht sehen Sie: Der Browser beginnt mit dem Download von `siyuan-3.8.11-win.exe` (rund 230 MB); nach Abschluss finden Sie die Datei im Ordner „Downloads“.




### Installationsassistent ausführen und Installation abschließen

Doppelklicken Sie auf die eben heruntergeladene `siyuan-3.8.11-win.exe`, um den Installationsassistenten zu starten. Klicken Sie auf der Lizenzseite zuerst auf „Ich stimme zu(I)“, behalten Sie auf der Seite mit den Installationsoptionen die Voreinstellung „Nur für mich installieren“ (keine Administratorrechte nötig) und klicken Sie auf „Weiter(N) >“. Prüfen Sie auf der Seite „Installationsort auswählen“, ob der Zielordner bei ① korrekt ist, und klicken Sie auf „Installieren(I)“, worauf ② rechts unten zeigt; nach Abschluss lassen Sie „SiYuan(R) ausführen“ angehakt und klicken auf „Fertig stellen(F)“.

![Seite „Installationsort auswählen“ im SiYuan-Installationsassistenten: den voreingestellten Benutzer-Installationspfad bestätigen und auf „Installieren(I)“ klicken](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/02-install-wizard.webp)


Richtig gemacht sehen Sie: Der Installationsfortschritt läuft durch und „SiYuan-Installationsassistent wird abgeschlossen“ erscheint; nach einem Klick auf „Fertig stellen(F)“ startet SiYuan automatisch.


**Hängt es? Eine Sicherheitswarnung erscheint, oder Sie möchten den Installationsort ändern**

Das offizielle SiYuan-Paket ist gültig digital signiert und löst normalerweise keine Sperre aus. Meldet Windows „Der Computer wurde durch Windows geschützt“, klicken Sie auf „Weitere Informationen“ und dann auf „Trotzdem ausführen“. Für den Installationspfad empfiehlt sich der voreingestellte lokale Ordner; installieren Sie nicht in ein synchronisiertes Laufwerk wie OneDrive.




### Erster Start und lokalen Arbeitsbereich wählen

Beim ersten Start zeigt SiYuan eine ganzseitige Anleitung zur Wahl des Arbeitsbereichs. Klicken Sie auf die Schaltfläche „Auswählen“ rechts neben „Arbeitsbereich“, auf die ① zeigt, wählen Sie im Windows-Dialog „Ordner auswählen“ ein rein lokales Verzeichnis (zum Beispiel neu anlegen und `C:\SiYuanWorkspace` auswählen) und bestätigen Sie im Hinweisfenster zum synchronisierten Laufwerk mit „OK“, um die Hauptoberfläche zu initialisieren.

![Erster Start von SiYuan auf der Seite zur Wahl des Arbeitsbereichs: rechts neben „Arbeitsbereich“ auf „Auswählen“ klicken und einen lokalen Ordner angeben](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/03-workspace-select.webp)


Richtig gemacht sehen Sie: Nach der Initialisierung erscheint die SiYuan-Hauptoberfläche, links der Dokumentbaum und oben links in der Titelleiste der Name des eben gewählten Arbeitsbereichs. Erscheinen beim ersten Start eine Firewall-Abfrage, oben rechts ein Hinweis zum Defender-Ausschluss oder unten rechts das Fenster „Willkommen bei SiYuan“, schließen Sie sie einfach oder klicken Sie auf „Ignorieren“.


**Hängt es? Warum darf der Arbeitsbereich nicht in OneDrive oder Nutstore liegen?**

SiYuan liest und schreibt die lokale Datenbank und die Indizes im Arbeitsbereich sehr häufig. In synchronisierten Laufwerken wie OneDrive, iCloud oder Nutstore führt das leicht zu Dateisperrkonflikten und Datenbeschädigung. Wählen Sie deshalb unbedingt einen normalen lokalen Ordner. Die Oberflächensprache können Sie auf dieser Seite unter „Erscheinungsbild und Sprache“ ändern oder später unter „Einstellungen → Erscheinungsbild → Oberfläche → Sprache“.




### Das Fenster „Einstellungen“ öffnen

Klicken Sie in der Hauptoberfläche oben links auf das Hauptmenü, auf das ① zeigt (es zeigt den Namen des aktuellen Arbeitsbereichs), und im aufgeklappten Menü auf 「设置」（„Einstellungen“）, worauf ② zeigt (Tastenkürzel `Alt+P`; Sie können auch direkt `Alt+P` drücken). SiYuan bringt die KI-Konfiguration bereits nativ mit; Sie müssen im Plugin-Markt kein Drittanbieter-OpenAI-Plugin installieren.

![In der SiYuan-Hauptoberfläche oben links auf das Hauptmenü klicken und im aufgeklappten Menü „Einstellungen“ (Alt+P) wählen](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/04-open-settings.webp)


Richtig gemacht sehen Sie: In der Bildschirmmitte öffnet sich das Fenster „Einstellungen“, links mit einer ganzen Spalte von Einstellungskategorien.




### Die Einstellungsseite „KI“ öffnen

Suchen Sie in der Kategorienliste links im Fenster „Einstellungen“ den Eintrag 「人工智能」（„KI“）, auf den ① zeigt, und klicken Sie darauf.

![In der Kategorienliste links im Einstellungsfenster auf „KI“ klicken](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/05-settings-ai-tab.webp)


Richtig gemacht sehen Sie: Rechts erscheint die Einstellungsseite „KI“ mit dem Bereich „API-Anbieter“ am oberen Rand.




### Auf „+ Anbieter hinzufügen“ klicken

Prüfen Sie, dass links die Kategorie 「人工智能」（„KI“）bei ① ausgewählt ist, und klicken Sie rechts im Bereich „API-Anbieter“ oben rechts auf die Schaltfläche 「+ 添加提供商」（„+ Anbieter hinzufügen“）, auf die ② zeigt.

![Im Bereich „KI → API-Anbieter“ oben rechts auf „+ Anbieter hinzufügen“ klicken](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/06-ai-add-provider.webp)


Richtig gemacht sehen Sie: Rechts erscheint eine Kartenliste mit Voreinstellungen für „API-Anbieter“, darüber die Überschrift „Offizielle Anbieter“.




### Die Voreinstellungskarte „OpenAI“ wählen

Klicken Sie in der zweispaltigen Kartenliste unter „Offizielle Anbieter“ auf die Karte 「OpenAI」 oben links, auf die ① zeigt. Achten Sie darauf, links die Karte „OpenAI“ mit der Adresse `https://api.openai.com/v1` zu wählen und nicht versehentlich rechts auf „ChatGPT (ChatGPT-Konto)“, das eine Kontoanmeldung verlangt.

![In der Kartenliste der „API-Anbieter“-Voreinstellungen die Karte „OpenAI“ oben links wählen](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/07-select-openai-preset.webp)


Richtig gemacht sehen Sie: Die Oberfläche wechselt in das Formular „Anbieter hinzufügen“ mit den Feldern „Benutzerdefinierter Anzeigename“, „API-Basisadresse“, „API-Typ“, „Zeitlimit“ und „API-Key“.




### QCode-Adresse, API-Typ und Key eintragen

Ändern Sie zuerst ganz oben den „Benutzerdefinierten Anzeigename“ von `OpenAI` in `QCode` (damit Sie den Anbieter wiedererkennen) und tragen Sie dann die drei entscheidenden Parameter in der Reihenfolge der Nummern im Bild ein:

- ① „API-Basisadresse“: den voreingestellten Inhalt löschen und `https://api.qcode.cc/openai/v1` eintragen (hängen Sie am Ende weder `/chat/completions` noch einen Schrägstrich an);
- ② „API-Typ“: das Dropdown öffnen und **unbedingt die Voreinstellung `Responses` auf `Chat Completions` ändern**;
- ③ „API-Key“: den im QCode-Dashboard kopierten Key einfügen, der mit `cr_` beginnt (zum Beispiel `cr_xxxxxxxx`; über das Augensymbol rechts können Sie prüfen, ob versehentlich Leerzeichen mitkopiert wurden).

Lassen Sie „Zeitlimit“ auf der Voreinstellung `120`; hier ist keine Änderung nötig.

![Benutzerdefinierten Anzeigename QCode und API-Basisadresse https://api.qcode.cc/openai/v1 eintragen, den „API-Typ“ auf Chat Completions ändern und den QCode-API-Key einfügen](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/08-fill-qcode-provider.webp)


Richtig gemacht sehen Sie: „API-Basisadresse“ zeigt `https://api.qcode.cc/openai/v1`, „API-Typ“ zeigt `Chat Completions`, und im Feld „API-Key“ stehen bereits maskierte Punkte.


**Brauchen Sie einen API-Key?**

Wenn Sie noch kein QCode-Konto haben, [Registrieren](https://qcode.cc/de/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-siyuan-key) Sie sich zuerst bei QCode. Wenn Sie lieber nach Verbrauch zahlen, kaufen Sie zunächst ein [Nutzungspaket](https://qcode.cc/de/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-siyuan-key) und erstellen Sie den Key anschließend im [Dashboard](https://qcode.cc/de/dashboard). Kopieren Sie die ganze Zeichenfolge ab `cr_` und fügen Sie sie oben in das Feld „API-Key“ ein. Bezahlen können Sie mit Kredit- oder Debitkarte (Visa / Mastercard) — siehe [Zahlungsarten](/docs/reference/payment-methods).




### Verfügbare Modelle aktualisieren, Verbindung testen und speichern

Bleiben Sie im aktuellen Fenster und scrollen Sie nach unten zum Bereich „Modelleinstellungen“:

- Klicken Sie auf 「刷新可用模型」（„Verfügbare Modelle aktualisieren“）, auf die ① zeigt; SiYuan lädt die Liste der verfügbaren Modelle von QCode und fügt automatisch eine Modellzeile hinzu;
- Tragen Sie in das Feld 「请输入或选择模型」（„Modell eingeben oder auswählen“）, auf das ② zeigt, das empfohlene `gpt-6.2-sol` ein (wenn Sie zusätzlich ein leichtes chinesisches Modell konfigurieren möchten, klicken Sie daneben auf „+ Modell hinzufügen“ und tragen in der neuen Zeile `deepseek-v4.1-flash` ein);
- Klicken Sie rechts in der Modellzeile auf „Verbindung testen“; sobald oben rechts „Verbindung erfolgreich“ erscheint, klicken Sie unten rechts auf 「确定」（„Bestätigen“）, worauf ③ zeigt, um die Konfiguration zu speichern.

![Auf „Verfügbare Modelle aktualisieren“ klicken, um die Liste zu laden; gpt-6.2-sol und deepseek-v4.1-flash konfigurieren, die Verbindung testen und mit „Bestätigen“ speichern](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/09-refresh-models-test.webp)


Richtig gemacht sehen Sie: Nach einem Klick auf „Verbindung testen“ erscheint oben rechts „Verbindung erfolgreich“; nach „Bestätigen“ kehren Sie zur Einstellungsseite „KI“ zurück.


**Hängt es? „Verfügbare Modelle aktualisieren“ schlägt fehl oder „Verbindung testen“ meldet einen Fehler**

Prüfen Sie drei Dinge der Reihe nach: 1) Steht der „API-Typ“ bereits auf `Chat Completions` (die Voreinstellung `Responses` schlägt fehl)? 2) Ist die „API-Basisadresse“ genau `https://api.qcode.cc/openai/v1`? 3) Stehen vor oder hinter dem Key zusätzliche Leerzeichen oder Anführungszeichen? Schlägt das Abrufen der Modellliste vorübergehend fehl, können Sie auch direkt auf „+ Modell hinzufügen“ klicken, `gpt-6.2-sol` von Hand eintragen und dann „Verbindung testen“ klicken.




### Anbieter-Schalter und Standardmodell prüfen

Prüfen Sie nach dem Speichern und der Rückkehr zur Einstellungsseite „KI“ drei Stellen:

- Bei ① ist der Schalter „Aktivieren“ rechts an der Karte `QCode` eingeschaltet; unter der Karte stehen `https://api.qcode.cc/openai/v1` und die Anzahl der konfigurierten Modelle;
- Bei ② ist unter „Editor → Standardmodell“ `gpt-6.2-sol` ausgewählt;
- Bei ③ ist auch unter „Agent → Standardmodell“ `gpt-6.2-sol` ausgewählt.

Ist das Standardmodell leer oder möchten Sie ein anderes hinzugefügtes Modell nutzen, klicken Sie einfach auf das Dropdown und wechseln es. Schließen Sie danach das Einstellungsfenster mit der Taste `Esc`.

![Nach dem Speichern zurück auf der Einstellungsseite „KI“: prüfen, dass der QCode-Schalter aktiv ist und unter „Editor“ und „Agent“ als Standardmodell jeweils gpt-6.2-sol gesetzt ist](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/10-provider-enabled-defaults.webp)


Richtig gemacht sehen Sie: Der Schalter der Karte `QCode` leuchtet, und unter „Editor“ und „Agent“ steht als Standardmodell jeweils `gpt-6.2-sol`.




### Im Editor mit „KI-Schreiben“ Text erzeugen

Öffnen Sie eine beliebige Notiz und tippen Sie in einer leeren Zeile `/` auf der Tastatur, um das Slash-Befehlsmenü zu öffnen; wählen Sie 「AI 编写」（„KI-Schreiben“）. Geben Sie im erscheinenden Dialog Ihren Wunsch ein (zum Beispiel einen Abschnitt in zwei Sätzen zusammenfassen) und klicken Sie auf „Bestätigen“. Nach wenigen Sekunden erscheint inline eine Vorschaukarte: ① zeigt, dass das Ergebnis gerade von `gpt-6.2-sol` erzeugt wurde; ein Klick auf 「在原位置插入」（„An der Stelle einfügen“）, worauf ② rechts unten zeigt, schreibt den Inhalt direkt ins Dokument.

![In der Notiz / eingeben und „KI-Schreiben“ wählen; nach der Erzeugung durch gpt-6.2-sol von QCode auf „An der Stelle einfügen“ klicken, um den Inhalt ins Dokument zu schreiben](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/11-editor-ai-writing.webp)


Richtig gemacht sehen Sie: Die Vorschaukarte zeigt den vollständigen Ausgabetext; nach einem Klick auf „An der Stelle einfügen“ steht der Inhalt sofort im aktuellen Absatz.


**Hängt es? Die Eingabe von / öffnet kein Menü, oder „KI-Schreiben“ ist nicht verfügbar**

Das Slash-Menü öffnet sich nur, wenn Sie `/` mit einer englischen Tastaturbelegung direkt tippen; ein kopiertes und eingefügtes `/` öffnet kein Menü. Finden Sie „KI-Schreiben“ nicht im Menü oder wird gemeldet, dass kein Modell konfiguriert ist, prüfen Sie unter „Einstellungen → KI“, ob der Schalter für `QCode` aktiv ist und „Editor → Standardmodell“ nicht leer ist.




### Im „Agent“ rechts chatten und das Modell wechseln

Klicken Sie in der Andockleiste ganz rechts oben auf das Symbol 「智能体」（„Agent“）, auf das ① zeigt, um das Chatfenster in der Seitenleiste aufzuklappen. Schreiben Sie unten ins Eingabefeld eine Testnachricht und klicken Sie auf Senden (oder drücken Sie `Ctrl+Enter`); nach kurzer Zeit sehen Sie bei ② eine normale Antwort. Wenn Sie zuvor mehrere Modelle hinzugefügt haben, klicken Sie unten rechts im Eingabefeld auf die Modellschaltfläche, auf die ③ zeigt (im Bild der Wechsel von `gpt-6.2-sol` auf `deepseek-v4.1-flash`), um das Modell jederzeit zu wechseln und weiterzufragen, ohne den Chat zu verlassen (im Bild kommt nach dem Wechsel auf einen Testbefehl sofort `PONG` zurück).

![Auf das Symbol „Agent“ in der rechten Andockleiste klicken und chatten; unten rechts im Eingabefeld das Modell auf deepseek-v4.1-flash wechseln und die Antwort PONG erhalten](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/12-agent-chat-reply.webp)


Richtig gemacht sehen Sie: Das „Agent“-Fenster rechts antwortet normal, und über die Modellschaltfläche unten rechts wechseln Sie reibungslos auf ein anderes hinzugefügtes Modell und erhalten weiter Antworten.




### Unter „Einstellungen → Info“ die Versionsnummer prüfen (optional)

Wenn Sie später bei der Fehlersuche oder beim Prüfen von Funktionspositionen die Version bestätigen möchten, öffnen Sie oben links das Hauptmenü → 「设置」（„Einstellungen“）(oder drücken `Alt+P`) und klicken Sie links ganz unten auf 「关于」（„Info“）; bei ① sehen Sie dann die aktuelle SiYuan-Versionsnummer (im Bild `当前版本 v3.8.11`, also „aktuelle Version v3.8.11“). Nach dem Schließen und erneuten Öffnen von SiYuan bleiben der eben konfigurierte Anbieter `QCode` und das Standardmodell vollständig erhalten.

![Unter „Einstellungen → Info“ die aktuell installierte SiYuan-Version ansehen (im Bild wird die aktuelle Version v3.8.11 angezeigt)](https://docs.qcode.cc/static/images/tut/siyuan/202611/zh/13-about-version.webp)


Richtig gemacht sehen Sie: Die Seite „Info“ zeigt die aktuelle Versionsnummer deutlich an; nach einem Neustart von SiYuan steht die `QCode`-Konfiguration unter „Einstellungen → KI“ weiterhin in der Liste.




## Prüfen, ob es funktioniert

Wenn diese vier Punkte stimmen, ist SiYuan vollständig mit QCode verbunden:

- Unter „Einstellungen → KI“ ist der Schalter der Karte `QCode` aktiv, und es werden `https://api.qcode.cc/openai/v1` sowie die Anzahl der hinzugefügten Modelle angezeigt;
- Unter „Editor → Standardmodell“ und „Agent → Standardmodell“ ist jeweils `gpt-6.2-sol` ausgewählt (oder ein anderes verfügbares Modell, das Sie brauchen);
- Im Notiztext erzeugt `/` → „KI-Schreiben“ Inhalt und fügt ihn ein, und der „Agent“ rechts antwortet normal und lässt sich auf ein anderes Modell umstellen;
- Nach dem Schließen und Neustarten von SiYuan bleiben der Anbieter `QCode` und die Standardmodell-Konfiguration erhalten.


### Fertig

SiYuan ist auf Ihrem Windows-11-PC installiert und mit QCode verbunden. Beim Schreiben können Sie künftig jederzeit `/` tippen und „KI-Schreiben“ aufrufen oder im „Agent“-Fenster rechts direkt chatten und das Modell wechseln. Weiter geht es mit:

- [Endpunkte und API-Formate](/docs/getting-started/endpoints-and-api-paths)
- [Chinesische Modelle anbinden](/docs/usage/cn-models)
- [Abrechnung](/docs/reference/billing)
- [Fehlerbehebung](/docs/reference/troubleshooting)
- Danach: Vergleichen Sie auf der [Preisseite](https://qcode.cc/de/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-siyuan-done) die Tarife
- Kehren Sie zum [Dashboard](https://qcode.cc/de/dashboard) zurück, um Nutzung und Guthaben zu prüfen


## Häufige Fehler

| Fehlermeldung | Ursache | Was tun |
|---|---|---|
| `Invalid API key` | Der Key ist leer, abgeschnitten, enthält führende oder folgende Leerzeichen bzw. Anführungszeichen, oder es wurde ein bereits ungültiger Key eingetragen | Kopieren Sie im QCode-Dashboard den mit `cr_` beginnenden Key erneut vollständig, leeren Sie das Feld „API-Key“ und fügen ihn neu ein; prüfen Sie es anschließend mit „Verbindung testen“ |
| `Invalid URL (POST /v1/chat/completions/chat/completions)` | In der „API-Basisadresse“ wurde `/chat/completions` eingetragen, und SiYuan hängt den Chat-Pfad automatisch an, sodass der Pfad doppelt erscheint; oder der „API-Typ“ steht noch auf der Voreinstellung `Responses` | Setzen Sie die „API-Basisadresse“ auf `https://api.qcode.cc/openai/v1` zurück (ohne `/chat/completions` und ohne abschließenden Schrägstrich) und ändern Sie den „API-Typ“ auf `Chat Completions` |
| `请确认没有将工作空间设置在第三方同步盘路径下，否则会造成数据损坏……是否继续?` | Sicherheitsabfrage beim ersten Wählen des Arbeitsbereichs, die verhindern soll, dass versehentlich ein OneDrive-, iCloud- oder Nutstore-Verzeichnis gewählt wird | Prüfen Sie, dass der gewählte Ordner ein normaler lokaler Ordner ist (etwa `C:\SiYuanWorkspace`), und klicken Sie auf „OK“; haben Sie versehentlich ein synchronisiertes Laufwerk gewählt, wechseln Sie zurück auf einen lokalen Ordner |
| `Microsoft Defender 可能会误杀内核、误删数据和严重降低运行性能，建议将思源安装路径和工作空间路径添加到排除列表` | Systemhinweis oben rechts beim ersten Betreten der Hauptoberfläche | Klicken Sie auf „Ignorieren“ und konfigurieren Sie QCode weiter; die Anbindung ist davon nicht betroffen. Wird der Kern später von einem Virenscanner blockiert, nehmen Sie Installations- und Arbeitsbereichspfad bei Bedarf in die Ausschlussliste auf |
| `是否要允许公共网络和专用网络访问此应用？` | Firewall-Abfrage der Windows-Sicherheit beim ersten Start des lokalen Kerns | Brechen Sie ab oder schließen Sie das Fenster einfach; der lokale Kern und die ausgehenden Anfragen an die QCode-API funktionieren trotzdem |

## Häufige Fragen

### Was ist nach dem Ablauf des Keys zu tun?

Das hängt von der Herkunft des Keys ab:

- Bei einem **persönlichen Tarif** lässt sich der Key nach Ablauf nicht verlängern: Schließen Sie einen neuen Tarif ab und erstellen Sie einen neuen Key.
- Bei einem **Nutzungspaket** wird derselbe Key wieder aktiv, sobald Sie nach dem Ablauf ein weiteres Paket kaufen.

Wenn Sie einen neuen Key verwenden, öffnen Sie „Einstellungen → KI“, klicken Sie auf die Karte `QCode`, tragen Sie den neuen `cr_`-Key im Feld „API-Key“ ein und speichern Sie mit „Bestätigen“.

### Muss ich ein Drittanbieter-OpenAI-Plugin installieren oder mich bei einem SiYuan-Konto anmelden?

Weder noch. SiYuan v3.8.11 bringt „Einstellungen → KI → API-Anbieter“ und den „Agent“ in der Seitenleiste bereits nativ mit; lokaler Arbeitsbereich und integrierte KI lassen sich ohne Anmeldung nutzen. Sie müssen im Markt kein altes OpenAI-Plugin installieren und brauchen auch kein offizielles OpenAI-Konto.

### Warum muss der „API-Typ“ von `Responses` auf `Chat Completions` geändert werden?

In SiYuan steht der „API-Typ“ der Voreinstellung „OpenAI“ standardmäßig auf `Responses`, der OpenAI-kompatible Endpunkt von QCode verwendet jedoch das Standardprotokoll `Chat Completions`. Ohne diese Änderung schlagen sowohl der Verbindungstest als auch Chat-Anfragen fehl; mit `Chat Completions` lassen sich Modelle normal abrufen und Chats führen.

### Wie wechsle ich in SiYuan die Oberflächensprache?

Auf der Anleitungsseite zur Wahl des Arbeitsbereichs beim ersten Start können Sie die Sprache direkt unter „Erscheinungsbild und Sprache“ wählen; in der Hauptoberfläche wechseln Sie jederzeit unter „Einstellungen → Erscheinungsbild → Oberfläche → Sprache“ zwischen Chinesisch (vereinfacht) und anderen Sprachen.

### Kann ich in SiYuan gleichzeitig Claude-Modelle verwenden?

Ja, aber tragen Sie Claude-Modelle nicht in den OpenAI-kompatiblen Endpunkt ein. Der OpenAI-kompatible Endpunkt von QCode akzeptiert keine Claude-Modelle; fügen Sie stattdessen einen eigenen Anbieter hinzu, wählen Sie als „API-Typ“ `Anthropic Messages`, tragen Sie als „API-Basisadresse“ `https://api.qcode.cc/api` ein und geben Sie denselben `cr_`-Key sowie `claude-opus-5-5` an (siehe die erweiterte Konfiguration unten).

## Anbindung auf einen Blick

| Punkt | Erläuterung |
|---|---|
| Konfigurationsort | Hauptmenü oben links → 「设置」（„Einstellungen“）(`Alt+P`) → 「人工智能」（„KI“）→ „API-Anbieter“ |
| OpenAI-kompatibler Endpunkt (GPT / chinesische Modelle) | `https://api.qcode.cc/openai/v1` (API-Typ: `Chat Completions`) |
| Anthropic-Endpunkt (Claude) | `https://api.qcode.cc/api` (API-Typ: `Anthropic Messages`) |
| Format des API-Keys | `cr_xxxxxxxx` (derselbe QCode-Key gilt an beiden Protokoll-Endpunkten) |
| Ort für das Standardmodell | Unter „Einstellungen → KI“: „Editor → Standardmodell“ und „Agent → Standardmodell“ |
| Offizielle Einstiege | [Offizielle Downloadseite](https://b3log.org/siyuan/download.html) · [GitHub-Repository](https://github.com/siyuan-note/siyuan) |

## Erweiterte Konfiguration: Claude-Modelle und andere Endpunkte

### Claude separat konfigurieren (Anthropic-Endpunkt)

Wenn Sie in SiYuan Claude-Modelle aufrufen möchten, gehen Sie zurück zu „Einstellungen → KI → API-Anbieter“ und klicken erneut auf „+ Anbieter hinzufügen“; tragen Sie folgende Parameter ein:

| Feld | Eintrag |
|---|---|
| Benutzerdefinierter Anzeigename | `QCode Claude` (frei wählbar) |
| API-Basisadresse | `https://api.qcode.cc/api` |
| API-Typ | `Anthropic Messages` |
| API-Key | `cr_xxxxxxxx` (derselbe QCode-Key) |
| Empfohlenes Modell | `claude-opus-5-5` (leichte Alternative `claude-haiku-5-5`) |

### Andere Endpunkte (optional)

Bei langsamer Verbindung oder Zeitüberschreitungen können Sie die Domain in der „API-Basisadresse“ auf einen näher gelegenen Endpunkt umstellen; alle drei Endpunkte sind funktional identisch, und derselbe Key gilt überall:

| Knoten | OpenAI-kompatibel (GPT / chinesische Modelle) | Anthropic (Claude) |
|---|---|---|
| Global (Standard) | `https://api.qcode.cc/openai/v1` | `https://api.qcode.cc/api` |
| Asien (optional für Festlandchina) | `https://asia.qcode.cc/openai/v1` | `https://asia.qcode.cc/api` |
| Nordamerika / Europa | `https://us.qcode.cc/openai/v1` | `https://us.qcode.cc/api` |

## Empfohlene Modelle

| Modellname | Passender API-Typ und Endpunkt | Geeignet für |
|---|---|---|
| `gpt-6.2-sol` | `Chat Completions` · `https://api.qcode.cc/openai/v1` | Standardempfehlung von OpenAI, ausgewogen für Schreiben, Zusammenfassen und Agent-Chat |
| `gpt-6.2-astra` | `Chat Completions` · `https://api.qcode.cc/openai/v1` | Höchste OpenAI-Alternative, geeignet für tiefe Analysen und komplexe lange Texte |
| `claude-opus-5-5` | `Anthropic Messages` · `https://api.qcode.cc/api` | Standardempfehlung von Anthropic / Claude, für lange Textüberarbeitung und strukturierte Gliederung |
| `claude-haiku-5-5` | `Anthropic Messages` · `https://api.qcode.cc/api` | Leichte Anthropic-/Claude-Alternative, schnelle Antworten |
| `deepseek-v4.1-flash` | `Chat Completions` · `https://api.qcode.cc/openai/v1` | Leichte chinesische Alternative, gut für schnelle Fragen und alltägliche Notizpflege |

Weitere IDs chinesischer Modelle finden Sie unter [Chinesische Modelle anbinden](/docs/usage/cn-models); die vollständige Zuordnung von Protokollen und Pfaden steht unter [Endpunkte und API-Formate](/docs/getting-started/endpoints-and-api-paths).

## Verwandte Dokumentation

- [Endpunkte und API-Formate](/docs/getting-started/endpoints-and-api-paths) — Referenz für beide Protokoll-Endpunkte und ihre Pfade
- [Chinesische Modelle anbinden](/docs/usage/cn-models) — Liste der chinesischen Modelle am OpenAI-kompatiblen Endpunkt
- [Abrechnung](/docs/reference/billing) — Nutzungsstatistik und Abrechnungsregeln
- [Fehlerbehebung](/docs/reference/troubleshooting) — häufige Verbindungs- und Authentifizierungsprobleme
- [Offizielle SiYuan-Downloadseite](https://b3log.org/siyuan/download.html)
- [SiYuan-Seite im Microsoft Store](https://apps.microsoft.com/detail/9p7hpmxp73k4)