diff --git a/README-scaleway.md b/README-scaleway.md
new file mode 100644
index 0000000..48d522c
--- /dev/null
+++ b/README-scaleway.md
@@ -0,0 +1,97 @@
+# Copilot CLI mit Scaleway verwenden
+
+## 1) `.envrc` anlegen
+
+Lege in deinem Projekt eine Datei `.envrc` an:
+
+```bash name=.envrc
+export STRIX_LLM="qwen3.5-397b-a17b"
+export SCW_SECRET_KEY="REPLACE_WITH_YOURS"
+
+export COPILOT_PROVIDER_TYPE="openai"
+export COPILOT_PROVIDER_API_KEY="${SCW_SECRET_KEY}"
+export COPILOT_PROVIDER_BASE_URL="https://api.scaleway.ai/v1"
+export COPILOT_MODEL="${STRIX_LLM}"
+
+export COPILOT_PROVIDER_MAX_PROMPT_TOKENS="32768"
+export COPILOT_PROVIDER_MAX_OUTPUT_TOKENS="8192"
+```
+
+## 2) `direnv` erlauben
+
+Falls `direnv` schon installiert ist:
+
+```bash name=direnv-allow.sh
+direnv allow
+```
+
+Wenn noch nicht in der Shell aktiviert, ergänze deine Shell-Config.
+
+### Bash
+```bash name=bash-direnv-hook.sh
+eval "$(direnv hook bash)"
+```
+
+### Zsh
+```bash name=zsh-direnv-hook.sh
+eval "$(direnv hook zsh)"
+```
+
+Danach Shell neu laden:
+
+```bash name=reload-shell-config.sh
+source ~/.bashrc
+# oder
+source ~/.zshrc
+```
+
+## 3) Startskript anlegen
+
+```bash name=use-scaleway-copilot.sh
+#!/usr/bin/env bash
+set -euo pipefail
+
+if ! command -v copilot >/dev/null 2>&1; then
+  echo "copilot CLI nicht gefunden."
+  exit 1
+fi
+
+: "${COPILOT_PROVIDER_TYPE:?COPILOT_PROVIDER_TYPE fehlt}"
+: "${COPILOT_PROVIDER_API_KEY:?COPILOT_PROVIDER_API_KEY fehlt}"
+: "${COPILOT_PROVIDER_BASE_URL:?COPILOT_PROVIDER_BASE_URL fehlt}"
+: "${COPILOT_MODEL:?COPILOT_MODEL fehlt}"
+
+echo "Starte Copilot CLI mit:"
+echo "  Provider: ${COPILOT_PROVIDER_TYPE}"
+echo "  Base URL: ${COPILOT_PROVIDER_BASE_URL}"
+echo "  Modell:   ${COPILOT_MODEL}"
+
+exec copilot "$@"
+```
+
+Dann ausführbar machen:
+
+```bash name=chmod-script.sh
+chmod +x use-scaleway-copilot.sh
+```
+
+Start:
+
+```bash name=start-script.sh
+./use-scaleway-copilot.sh
+```
+
+Oder mit Argumenten:
+
+```bash name=start-script-with-args.sh
+./use-scaleway-copilot.sh --model="qwen3.5-397b-a17b"
+```
+
+## 4) `.gitignore` ergänzen
+
+Falls noch nicht vorhanden:
+
+```gitignore name=.gitignore
+.env
+.envrc
+```