Menü schliessen
Created: November 17th 2026
Last updated: November 17th 2026
Categories: Artificial intelligence (AI)
Author: Marcus Fleuti

Claude Code und OpenAI Codex CLI in Docker installieren: Anleitung für Ubuntu und Linux Mint

This guide is also available in English: Complete Guide: Install OpenAI Codex CLI and Claude Code in Docker on Ubuntu/Linux Mint

Claude Code und OpenAI Codex CLI in einem Docker-Container: Schritt-für-Schritt-Anleitung für Ubuntu und Linux Mint

Claude Code und die OpenAI Codex CLI sind KI-Assistenten, die im Terminal arbeiten: Sie beschreiben eine Aufgabe in normalen Worten, und die Assistenten lesen Dateien, schreiben Code und führen Befehle selbständig aus. Das ist leistungsfähig - und genau der Grund, sie nicht auf den ganzen Rechner loszulassen. Diese Anleitung setzt beide in einen Docker-Container: ein abgeschottetes Mini-Linux, das nur einen einzigen Ordner von Ihnen erreicht.

Docker-Erfahrung brauchen Sie nicht. Jeder Schritt sagt in einem Satz, was passiert, zeigt den Befehl zum Kopieren und danach, was Sie sehen sollten - so merken Sie sofort, ob es geklappt hat. Rechnen Sie für den ersten Durchgang mit rund einer Stunde. Die Anleitung gilt nur für Linux (Ubuntu und Linux Mint); Windows und macOS behandelt sie nicht.

Aktualisiert im November 2026. Die Schritte im Container wurden auf Ubuntu 26.04 mit Claude Code 2.1 und Codex CLI 0.169 geprüft.

Was Sie am Ende haben

Ihr Rechner
Ihre Dateien, Ihr Browser, Ihre Passwörter.
Ein Ordner wird geteilt:
~/ai-agent
↔
Der Container «ai-agent»
Ein kleines Ubuntu mit Claude Code und Codex CLI.
Er sieht den geteilten Ordner als:
/ai-agent
  • Sie tippen claude oder codex in einem beliebigen Projektordner unterhalb von ~/ai-agent, und der Assistent startet im Container, in genau diesem Ordner.
  • Die Assistenten können alles in ~/ai-agent lesen und ändern. Den Rest Ihres Rechners sehen sie nicht: weder Ihre Dokumente noch Ihr Browser-Profil noch Ihre SSH-Schlüssel.
  • Programme, Anmeldungen und Einstellungen beider Assistenten liegen in ~/ai-agent. Wenn Sie den Container löschen und neu aufbauen, sind sie noch da.
  • Der Container hat vollen Internetzugang. Er schirmt Ihren Rechner ab, nicht den Inhalt des Arbeitsbereichs. Was das bedeutet, erklärt der Abschnitt zur Sicherheit.

Ein paar Begriffe, kurz erklärt

Begriff Was er hier bedeutet
Terminal Das Fenster, in dem Sie Befehle eingeben. Unter Ubuntu und Linux Mint: Ctrl+Alt+T. Auf deutschen Tastaturen heisst die Taste Strg.
Host Ihr eigener Rechner, im Unterschied zum Container.
Image Eine fertige Vorlage eines Linux-Systems. Hier: ubuntu:26.04.
Container Eine laufende Kopie eines Images. Er verhält sich wie ein zweiter, kleiner Rechner in Ihrem Rechner und sieht nur, was Sie ihm übergeben.
Geteilter Ordner (Mount) Ein Ordner Ihres Rechners, der auch im Container erscheint. Eine Änderung auf der einen Seite ist sofort auf der anderen sichtbar.
Benutzer-ID Die Nummer, unter der Linux einen Benutzer führt. Dateien gehören einer Nummer, nicht einem Namen. Deshalb bekommt der Benutzer im Container dieselbe Nummer wie Sie.
Shell-Funktion, Alias Ein kurzer Befehlsname, der für einen langen Befehl steht. So richten Sie claude und codex ein.
Bypass-Modus Der Assistent arbeitet, ohne vor jeder Aktion um Erlaubnis zu fragen. Schnell - und nur in einem Container sinnvoll.
Sandbox Ein Zaun um ein Programm. In diesem Aufbau ist der Container der Zaun.

Was Sie brauchen

  • Einen Rechner mit Ubuntu 22.04 oder neuer oder Linux Mint 21 oder neuer und einen Benutzer, der sudo verwenden darf.
  • Rund 6 GB freien Speicherplatz: etwa 900 MB für die Basis-Werkzeuge und anfangs 800 MB für beide Assistenten. Claude Code behält nach Aktualisierungen mehrere frühere Versionen, rechnen Sie für die Assistenten deshalb mit der Zeit mit bis zu 4 GB. Der Rest ist für optionale Pakete und Ihre Projekte.
  • Für Claude Code: ein Claude-Abo (Pro, Max, Ultra, Team oder Enterprise). Das kostenlose Konto enthält Claude Code nicht.
  • Für die Codex CLI: ein ChatGPT-Abo (Plus, Pro, Business, Edu oder Enterprise).

Sie brauchen nicht beide. Wenn Sie nur eines der zwei Abos haben, richten Sie nur diesen Assistenten ein. Die Schritte, die allein zu Codex gehören, sind mit Nur Codex markiert, jene für Claude Code mit Nur Claude Code; überspringen Sie, was Sie nicht brauchen.

So lesen Sie die Befehle: Graue Kästen enthalten Befehle. Kopieren Sie einen Kasten vollständig, fügen Sie ihn im Terminal ein (dort heisst Einfügen Ctrl+Shift+V) und drücken Sie Enter. Wo yourUserName steht, setzen Sie Ihren eigenen Linux-Benutzernamen ein. Wenn Sie ihn nicht kennen, zeigt ihn dieser Befehl:

whoami

Schritt 1: Docker installieren

Docker ist das Programm, das Container ausführt. Dieser Befehl installiert es aus den normalen Ubuntu-Paketquellen und startet es.

sudo apt update
sudo apt install docker.io -y
sudo systemctl enable --now docker

Standardmässig darf nur der Administrator Docker verwenden. Dieser Befehl nimmt Ihren Benutzer in die Gruppe auf, die es ebenfalls darf:

sudo usermod -aG docker "$USER"

Melden Sie sich jetzt von Ihrer Desktop-Sitzung ab und wieder an (oder starten Sie den Rechner neu). Die neue Gruppe zählt erst nach einer frischen Anmeldung. Danach testen Sie Docker:

docker run --rm hello-world

Das sehen Sie jetzt: mehrere Zeilen Text, darunter diese:

Hello from Docker!

Erscheint stattdessen permission denied, haben Sie sich noch nicht ab- und wieder angemeldet.

Schritt 2: Die gemeinsamen Ordner anlegen

Zwei Ordner Ihres Rechners werden dem Container übergeben. ~/ai-agent ist der Arbeitsbereich: Hier liegen Ihre Projekte, und hier bewahren die Assistenten ihre Programme und Einstellungen auf. /ai-agent-tmp nimmt die temporären Dateien auf, damit sie sich nicht im Container ansammeln. Dieser Ordner wird nicht automatisch geleert; wird er gross, leeren Sie ihn, während kein Assistent läuft.

mkdir -p ~/ai-agent
sudo mkdir -p /ai-agent-tmp
sudo chown "$(id -u):$(id -g)" /ai-agent-tmp
sudo chmod 1777 /ai-agent-tmp

Diese Befehle geben nichts aus, wenn sie gelingen. Schlagen Sie jetzt Ihre Benutzer-ID und Ihre Gruppen-ID nach, Sie brauchen sie in Schritt 6:

id -u
id -g

Das sehen Sie auf den meisten Rechnern:

1000
1000

Sehen Sie andere Zahlen, notieren Sie sie. In Schritt 6 ersetzen Sie dann 1000 durch Ihre Zahlen.

Schritt 3: Den Container starten

Dieser eine Befehl lädt das Image von Ubuntu 26.04 herunter und startet daraus einen Container mit dem Namen ai-agent. Der Container läuft im Hintergrund weiter und startet nach einem Neustart des Rechners von selbst wieder.

docker run -d \
  --init \
  --pids-limit=4096 \
  --restart=unless-stopped \
  --name ai-agent \
  --hostname ai-agent \
  -e TZ=Europe/Zurich \
  -e LANG=C.UTF-8 \
  -v "$HOME/ai-agent:/ai-agent" \
  -v "/ai-agent-tmp:/tmp" \
  ubuntu:26.04 \
  sleep infinity

Ersetzen Sie Europe/Zurich durch Ihre eigene Zeitzone, wenn Sie anderswo wohnen, zum Beispiel Europe/Berlin oder America/New_York. Prüfen Sie, ob der Container läuft:

docker ps --filter name=ai-agent

Das sehen Sie jetzt: eine Zeile, die mit ai-agent endet und das Wort Up enthält.

CONTAINER ID   IMAGE          COMMAND            CREATED          STATUS          PORTS     NAMES
3f1c9a7d2b10   ubuntu:26.04   "sleep infinity"   10 seconds ago   Up 9 seconds              ai-agent

Für Neugierige, was die einzelnen Optionen bewirken:

  • -d: im Hintergrund ausführen.
  • --init: ein winziger Hilfsprozess, der beendete Programme im Container aufräumt.
  • --pids-limit=4096: eine Obergrenze für die Zahl der Programme, damit ein ausser Kontrolle geratenes Skript Ihren Rechner nicht einfriert.
  • --restart=unless-stopped: nach einem Absturz oder Neustart wieder starten, ausser Sie haben den Container selbst gestoppt.
  • --name, --hostname: der Name des Containers und der Name in seinem Prompt.
  • Keine Netzwerk-Option: Der Container bekommt ein eigenes Netzwerk. Er erreicht das Internet, aber weder Ihre Arbeitsoberfläche noch die Dienste, die nur auf Ihrem Rechner selbst lauschen. Muss ein Assistent einen solchen Dienst erreichen, lesen Sie den Abschnitt «Variante: Wenn der Assistent Dienste auf Ihrem Rechner erreichen muss», bevor Sie den Container starten.
  • -e TZ, -e LANG: Zeitzone und Zeichensatz (UTF-8, damit Umlaute und Emojis richtig erscheinen).
  • -v "$HOME/ai-agent:/ai-agent": der gemeinsame Arbeitsbereich. -v "/ai-agent-tmp:/tmp": der Ordner für temporäre Dateien.
  • ubuntu:26.04: das Image, festgelegt auf die aktuelle Langzeitversion, damit eine künftige Ubuntu-Version Ihren Aufbau nicht unbemerkt verändert.
  • sleep infinity: ein Befehl, der für immer nichts tut. Er hält den Container am Leben.

Schritt 4: Die Basis-Pakete installieren

Ein frischer Container ist fast leer. Damit die Assistenten nützlich sind, brauchen sie die üblichen Werkzeuge: etwas zum Herunterladen von Dateien, Versionsverwaltung, Suchwerkzeuge, einen Compiler, Python. Öffnen Sie eine Administrator-Shell im Container:

docker exec -it ai-agent bash -l

Das sehen Sie jetzt: Der Prompt ändert sich. Solange er mit root@ai-agent beginnt, läuft alles, was Sie eingeben, im Container und nicht auf Ihrem Rechner.

root@ai-agent:/#

Bringen Sie das System zuerst auf den neuesten Stand. Die erste Zeile verhindert, dass Pakete während der Installation Fragen stellen.

export DEBIAN_FRONTEND=noninteractive
apt update && apt upgrade -y

Installieren Sie dann die Basis. Das dauert ein paar Minuten und belegt rund 900 MB.

apt install -y \
  ca-certificates curl wget git gnupg sudo locales tzdata lsb-release software-properties-common \
  ripgrep fd-find jq tree less file \
  nano vim tmux screen htop procps \
  zip unzip tar gzip bzip2 xz-utils zstd \
  iputils-ping iproute2 bind9-dnsutils net-tools whois openssh-client \
  build-essential pkg-config python3 python3-pip python3-venv python3-dev pipx shellcheck parallel sqlite3

Prüfen Sie, ob es geklappt hat:

git --version && rg --version | head -1 && python3 --version

Das sehen Sie jetzt (die Zahlen können höher sein):

git version 2.53.0
ripgrep 15.1.0
Python 3.14.4

Wozu die Gruppen dienen, Zeile für Zeile: Grundlagen für Downloads, Versionsverwaltung und den Administrator-Befehl; Werkzeuge zum Suchen und Lesen von Dateien; Editoren und Helfer fürs Terminal; Archivformate; Netzwerk-Diagnose; und zuletzt Compiler, Python und Skript-Prüfer. Bleiben Sie für die nächsten zwei Schritte in dieser Shell.

Schritt 5: Pakete ergänzen, die Ihre Projekte brauchen (optional)

Die Basis reicht für den Anfang. Installieren Sie die folgenden Gruppen nur, wenn Ihre Projekte sie brauchen - Sie können jederzeit mit dem Befehl ai-agent-root aus Schritt 11 zu diesem Schritt zurückkehren. Jeder Kasten ist unabhängig von den anderen.

Bibliotheken zum Kompilieren (nötig, wenn Python- oder Ruby-Pakete eigene Teile übersetzen), rund 50 MB:

apt install -y libssl-dev libffi-dev zlib1g-dev libyaml-dev libreadline-dev libxml2-dev libxslt1-dev libcurl4-openssl-dev libsqlite3-dev libpq-dev

Datenbank-Clients für PostgreSQL, MariaDB/MySQL und Redis, rund 50 MB:

apt install -y postgresql-client mariadb-client redis-tools

PHP 8.5 mit den üblichen Erweiterungen und Composer, rund 80 MB:

apt install -y php-cli php-mbstring php-xml php-curl php-zip php-intl php-gd php-mysql php-sqlite3 php-bcmath composer

PDF-Werkzeuge, rund 30 MB:

apt install -y poppler-utils qpdf

Bilder, Audio und Video, rund 650 MB, das meiste davon für ffmpeg:

apt install -y imagemagick ffmpeg libimage-exiftool-perl

GitHub-Kommandozeilenwerkzeug gh, mit dem die Assistenten Pull Requests eröffnen können. Ubuntu liefert eine alte Version, deshalb kommt zuerst die Paketquelle von GitHub dazu:

mkdir -p -m 755 /etc/apt/keyrings
wget -nv -O /etc/apt/keyrings/githubcli-archive-keyring.gpg https://cli.github.com/packages/githubcli-archive-keyring.gpg
chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" > /etc/apt/sources.list.d/github-cli.list
apt update && apt install -y gh

Node.js fehlt in dieser Liste mit Absicht. Es wird für Ihren Benutzer installiert, nicht für den Administrator, und folgt am Ende von Schritt 6.

Schritt 6: Ihren Benutzer im Container anlegen

Dieser Schritt macht alles Weitere reibungslos. Die Assistenten dürfen nicht als Administrator laufen: Claude Code verweigert den Bypass-Modus als root, und Dateien, die root anlegt, würden nicht Ihnen gehören. Der Container bekommt deshalb einen Benutzer mit demselben Namen und derselben Nummer wie Ihr Benutzer auf dem Host, und der gemeinsame Ordner wird sein Home-Verzeichnis.

Sie sind noch in der Shell mit dem Prompt root@ai-agent. Sehen Sie zuerst nach, ob die Nummer 1000 schon vergeben ist. Das Ubuntu-Image bringt meist einen Benutzer namens ubuntu mit dieser Nummer mit:

id 1000

Das sehen Sie jetzt: entweder eine Zeile, die mit uid=1000(ubuntu) beginnt, oder id: '1000': no such user. Beides ist in Ordnung.

Legen Sie nun Ihren Benutzer an. Ersetzen Sie yourUserName an allen vier Stellen. Hat Schritt 2 andere Zahlen als 1000 gezeigt, ersetzen Sie auch 1000: Ihre Gruppen-ID hinter groupadd -g und useradd -g, Ihre Benutzer-ID hinter useradd -u.

userdel -r ubuntu 2>/dev/null || true
groupdel ubuntu 2>/dev/null || true
groupadd -g 1000 yourUserName
useradd -u 1000 -g 1000 -d /ai-agent -M -s /bin/bash yourUserName
cp --update=none /etc/skel/.bashrc /etc/skel/.profile /ai-agent/
chown -R yourUserName:yourUserName /ai-agent

Diese Befehle geben nichts aus, wenn sie gelingen. Prüfen Sie:

id yourUserName
uid=1000(yourUserName) gid=1000(yourUserName) groups=1000(yourUserName)

Was die Zeilen tun: Die ersten zwei entfernen den Platzhalter-Benutzer. Die nächsten zwei legen Ihre Gruppe und Ihren Benutzer mit den angegebenen Nummern an, mit /ai-agent als Home-Verzeichnis und bash als Shell. Die cp-Zeile kopiert zwei Startdateien ins Home-Verzeichnis; eine davon sorgt dafür, dass Programme, die für Ihren Benutzer installiert werden, später gefunden werden. Die letzte Zeile übergibt den Ordner Ihrem Benutzer.

Erlauben Sie Ihrem Benutzer als Nächstes, im Container ohne Passwort Administrator zu werden. So kann ein Assistent ein fehlendes Paket selbst installieren. Der Preis: Ein Assistent mit Administratorrechten im Container kann in ~/ai-agent auch Dateien hinterlassen, die dem Administrator gehören. Ersetzen Sie yourUserName auch hier. Lassen Sie diese zwei Zeilen weg, wenn die Assistenten weniger Rechte haben sollen; Pakete installieren Sie dann selbst mit ai-agent-root aus Schritt 11.

echo 'yourUserName ALL=(ALL) NOPASSWD:ALL' > /etc/sudoers.d/ai-agent
chmod 0440 /etc/sudoers.d/ai-agent

Verlassen Sie die Administrator-Shell. Der Prompt Ihres eigenen Rechners kehrt zurück.

exit

Optional: Node.js für Ihren Benutzer

Keiner der beiden Assistenten braucht Node.js. Viele Erweiterungen für sie aber schon: Sogenannte MCP-Server werden oft mit dem Node.js-Werkzeug npx gestartet. Wenn Sie solche Erweiterungen verwenden wollen, installieren Sie Node.js jetzt; sonst gehen Sie weiter zu Schritt 7. Öffnen Sie eine Shell als Ihr Benutzer:

docker exec -it -u yourUserName -w /ai-agent ai-agent bash -l

Der Prompt beginnt jetzt mit yourUserName@ai-agent. Installieren Sie die Versionsverwaltung nvm und damit die aktuelle Langzeitversion von Node.js:

curl -fsSL -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash
export NVM_DIR="$HOME/.nvm" && . "$NVM_DIR/nvm.sh"
nvm install --lts

Das sehen Sie am Ende (die Zahlen können höher sein):

Now using node v26.13.1 (npm v11.20.0)

Noch ein Block, und er ist wichtig: nvm trägt sich nur für Shells ein, in die Sie selbst tippen. Die Assistenten starten in einer anderen Art von Shell und würden Node.js nicht finden. Diese Zeilen beheben das:

cat >> ~/.profile <<'EOF'

# Node.js from nvm, also for the claude and codex commands
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
EOF
exit

Schritt 7: Claude Code installieren

Nur Claude Code - überspringen Sie diesen Schritt, wenn Sie nur Codex verwenden.

Anthropic stellt einen Installer bereit, der Claude Code ins Home-Verzeichnis Ihres Benutzers legt. Führen Sie ihn von Ihrem Rechner aus; der Befehl schickt ihn als Ihr Benutzer in den Container:

docker exec -it -u yourUserName -w /ai-agent ai-agent bash -lc 'curl -fsSL https://claude.ai/install.sh | bash'

Das sehen Sie am Ende:

✔ Claude Code successfully installed!
  Version: 2.1.326
  Location: ~/.local/bin/claude

⚠ Setup notes:
  ● Native installation exists but ~/.local/bin is not in your PATH.

✅ Installation complete!

Den Hinweis zu PATH können Sie ignorieren. Er erscheint, weil der Ordner ~/.local/bin beim Start des Installers noch nicht existierte. Jede neue Shell findet ihn, wie diese Prüfung zeigt:

docker exec -it -u yourUserName -w /ai-agent ai-agent bash -lc 'claude --version'
2.1.326 (Claude Code)

Von jetzt an hält sich Claude Code selbst aktuell: Es lädt neue Versionen im Hintergrund herunter und verwendet sie beim nächsten Start. Sie müssen dafür nichts tun.

Schritt 8: Codex CLI installieren

Nur Codex - überspringen Sie diesen Schritt, wenn Sie nur Claude Code verwenden.

OpenAI stellt einen Installer derselben Art bereit. Der Zusatz CODEX_NON_INTERACTIVE=1 sagt ihm, dass er keine Fragen stellen soll.

docker exec -it -u yourUserName -w /ai-agent ai-agent bash -lc 'curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh'

Das sehen Sie am Ende (die Versionsnummer wird höher sein):

==> Installing Codex CLI
==> Detected platform: Linux (x64)
==> Resolved version: 0.169.0
==> Downloading Codex CLI
Codex CLI 0.169.0 installed successfully.

Prüfen Sie aus einer neuen Shell:

docker exec -it -u yourUserName -w /ai-agent ai-agent bash -lc 'codex --version'
codex-cli 0.169.0

Schritt 9: Einstellungen für Claude Code

Nur Claude Code.

Weil der gemeinsame Ordner das Home-Verzeichnis Ihres Container-Benutzers ist, können Sie die Einstellungen bequem auf Ihrem eigenen Rechner bearbeiten. Legen Sie die Einstellungsdatei an:

mkdir -p ~/ai-agent/.claude
nano ~/ai-agent/.claude/settings.json

Fügen Sie den folgenden Text ein, speichern Sie mit Ctrl+O, Enter, und verlassen Sie den Editor mit Ctrl+X. Die Datei ist strenges JSON: keine Kommentare, und kein Komma nach dem letzten Eintrag einer Liste.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "skipDangerousModePermissionPrompt": true,
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./*.key)",
      "Read(./*.pem)",
      "Read(~/.ssh/**)",
      "Read(~/.aws/**)",
      "Read(~/.kube/config)",
      "Read(~/.docker/config.json)",
      "Read(~/.netrc)",
      "Read(~/.npmrc)",
      "Read(~/.bash_history)",
      "Read(~/.claude/.credentials.json)",
      "Read(~/.codex/auth.json)"
    ]
  },
  "env": {
    "BASH_DEFAULT_TIMEOUT_MS": "600000",
    "BASH_MAX_TIMEOUT_MS": "1800000",
    "BASH_MAX_OUTPUT_LENGTH": "150000",
    "CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR": "1"
  }
}

Was die Teile bewirken:

  • $schema: Editoren wie VS Code können die Datei damit prüfen und beim Tippen Einträge vorschlagen.
  • skipDangerousModePermissionPrompt: überspringt den einmaligen Warnhinweis, den der Bypass-Modus beim ersten Start zeigt.
  • permissions.deny: Dateien, die der Assistent nicht lesen soll: Passwortdateien, Schlüsseldateien und die Anmeldedaten beider Assistenten. Die Regeln gelten auch im Bypass-Modus und verhindern, dass der Assistent diese Dateien versehentlich öffnet. Eine harte Sperre sind sie nicht: Ein Skript, das der Assistent schreibt und ausführt, kann sie trotzdem lesen. Was sonst geheim bleiben muss, gehört gar nicht erst nach ~/ai-agent.
  • env: Befehle dürfen standardmässig 10 Minuten laufen und bis zu 30 Minuten, wenn der Assistent darum bittet; die Ausgabe eines Befehls ist auf 150'000 Zeichen begrenzt (das Maximum); und nach jedem Befehl kehrt der Assistent in den Projektordner zurück.

Die Datei enthält mit Absicht keinen Modellnamen. Welches Modell antwortet, wählen Sie in Claude Code mit dem Befehl /model, und Claude Code merkt sich die Wahl. Auch der Bypass-Modus steht nicht in der Datei: Er wird sichtbar im Startbefehl von Schritt 11 eingeschaltet.

Schritt 10: Einstellungen für Codex

Nur Codex.

Auch Codex liest seine Einstellungen aus einer Datei. Legen Sie sie an:

mkdir -p ~/ai-agent/.codex
nano ~/ai-agent/.codex/config.toml

Fügen Sie Folgendes ein, speichern Sie mit Ctrl+O, Enter, und verlassen Sie den Editor mit Ctrl+X:

web_search = "live"
check_for_update_on_startup = true

[projects."/ai-agent"]
trust_level = "trusted"
  • web_search = "live": Codex darf im Web nachschlagen und ruft aktuelle Seiten ab. Die anderen Werte sind cached und indexed (Antworten aus einem Index, den OpenAI pflegt) sowie disabled.
  • check_for_update_on_startup: Codex meldet beim Start, wenn eine neue Version existiert.
  • [projects."/ai-agent"]: kennzeichnet den Arbeitsbereich als vertrauenswürdig, damit Codex beim Start nicht fragt, ob es die Einstellungen dort lesen darf. Fragt Codex in einem Projektordner trotzdem, bestätigen Sie einmal.

Auch hier steht kein Modellname: Das Modell wählen Sie in Codex mit /model.

Warum Codex hier ohne eigene Sandbox läuft. Normalerweise packt Codex jeden Befehl in eine eigene Sandbox. In einem Docker-Container kann diese Sandbox nicht starten; der Versuch endet mit bwrap: No permissions to create a new namespace. In diesem Aufbau läuft Codex deshalb mit ausgeschalteter Sandbox, genau wie Claude Code im Bypass-Modus, und der Container ist der Zaun. Der Schalter dafür steht im Startbefehl des nächsten Schritts, wo Sie ihn sehen.

Schritt 11: Die Befehle auf Ihrem Rechner einrichten

Bisher war jeder Aufruf eine lange docker exec-Zeile. Dieser Schritt gibt Ihnen kurze Befehle: claude und codex starten die Assistenten in dem Ordner, in dem Sie gerade sind, und drei Helfer öffnen eine Shell im Container oder aktualisieren ihn. Öffnen Sie die Startdatei Ihres Terminals:

nano ~/.bashrc

Gehen Sie ganz ans Ende der Datei, fügen Sie den folgenden Block ein und ersetzen Sie yourUserName in der zweiten Zeile. Speichern Sie mit Ctrl+O, Enter, und verlassen Sie den Editor mit Ctrl+X. Wenn Sie nur einen der zwei Assistenten verwenden, dürfen Sie die Funktion des anderen löschen. Wenn Sie einer früheren Fassung dieser Anleitung gefolgt sind, löschen Sie zuerst deren Block aus der Datei (die alten Definitionen von ai, claude, codex, ai-agent und ai-agent-update).

# --- AI agent container ------------------------------------------------------
AI_AGENT_USER="yourUserName"      # your user name, the same inside the container
AI_AGENT_DIR="$HOME/ai-agent"     # the shared folder on this computer
AI_AGENT_CONTAINER="ai-agent"     # the name of the Docker container

# Translate the folder you are in to its path inside the container.
_ai_agent_workdir() {
  local root real
  root="$(cd "$AI_AGENT_DIR" && pwd -P)" || { printf '/ai-agent\n'; return; }
  real="$(pwd -P)"
  case "$real" in
    "$root"|"$root"/*) printf '/ai-agent%s\n' "${real#"$root"}" ;;
    *) printf '/ai-agent\n' ;;
  esac
}

claude() {
  docker exec -it -u "$AI_AGENT_USER" -w "$(_ai_agent_workdir)" "$AI_AGENT_CONTAINER" \
    bash -lc 'exec claude --dangerously-skip-permissions "$@"' _ "$@"
}

codex() {
  docker exec -it -u "$AI_AGENT_USER" -w "$(_ai_agent_workdir)" "$AI_AGENT_CONTAINER" \
    bash -lc 'exec codex --dangerously-bypass-approvals-and-sandbox "$@"' _ "$@"
}

alias ai-agent-root='docker exec -it -w /ai-agent "$AI_AGENT_CONTAINER" bash -l'
alias ai-agent-user='docker exec -it -u "$AI_AGENT_USER" -w /ai-agent "$AI_AGENT_CONTAINER" bash -l'
alias ai-agent-update='docker exec -it -w /ai-agent "$AI_AGENT_CONTAINER" bash -lc "apt update && apt upgrade -y"'

Laden Sie die neuen Befehle in das Terminal, das Sie gerade offen haben. Jedes Terminal, das Sie später öffnen, hat sie von selbst.

source ~/.bashrc

Prüfen Sie mit dem Helfer, der eine Shell als Ihr Benutzer öffnet:

ai-agent-user

Das sehen Sie jetzt: einen Prompt, der mit yourUserName@ai-agent beginnt. Mit exit kommen Sie zurück.

Befehl Was er tut
claude Startet Claude Code im aktuellen Ordner, im Bypass-Modus.
codex Startet Codex im aktuellen Ordner, ohne Rückfragen und ohne eigene Sandbox.
ai-agent-user Öffnet eine Shell im Container als Ihr Benutzer.
ai-agent-root Öffnet eine Shell im Container als Administrator, zum Installieren von Paketen.
ai-agent-update Aktualisiert die Ubuntu-Pakete im Container.

Zwei Details für Neugierige. Rufen Sie claude oder codex ausserhalb von ~/ai-agent auf, startet der Assistent in der obersten Ebene des Arbeitsbereichs, weil der Container keinen anderen Ordner sieht. Und alles, was Sie hinter den Befehl schreiben, wird unverändert weitergegeben: claude "fix the login bug" kommt als ein Satz an, nicht als vier einzelne Wörter.

Schritt 12: Zum ersten Mal anmelden

Beide Assistenten werden mit dem Konto Ihres Abos angemeldet, in Ihrem normalen Browser. Das ist der empfohlene Weg: Über das Abo hinaus zahlen Sie nichts.

Claude Code:

cd ~/ai-agent
claude

Beim ersten Start stellt Claude Code ein paar Fragen zur Einrichtung und zeigt dann einen Anmelde-Link. Öffnen Sie den Link im Browser und melden Sie sich mit Ihrem Claude-Konto an. Die Seite zeigt danach einen Code; kopieren Sie ihn und fügen Sie ihn im Terminal ein. Danach begrüsst Sie Claude Code und wartet auf eine Aufgabe. Mit /exit verlassen Sie es.

Codex:

codex login --device-auth

Codex zeigt einen Link und einen kurzen Code. Öffnen Sie den Link, melden Sie sich mit Ihrem ChatGPT-Konto an und geben Sie dort den Code ein. Das Terminal meldet danach den Erfolg. Prüfen Sie:

codex login status
Logged in using ChatGPT

Der Zusatz --device-auth ist nötig, weil Ihr Browser nicht in den Container hineinreicht. OpenAI führt diese Art der Anmeldung noch als Beta; bei einem Organisationskonto muss sie unter Umständen zuerst ein Administrator freischalten.

Beide Anmeldungen werden im gemeinsamen Ordner gespeichert (~/ai-agent/.claude und ~/ai-agent/.codex). Sie bleiben angemeldet, wenn Sie den Container neu aufbauen. Behandeln Sie diese zwei Ordner wie ein Passwort.

Die Alternative: ein API-Schlüssel. Beide Assistenten lassen sich statt über ein Abo auch nach Verbrauch über die Entwicklerplattformen von Anthropic und OpenAI bezahlen. Dann wird jede Anfrage einzeln abgerechnet, und Sie brauchen auf diesem Konto vorausbezahltes API-Guthaben; ohne Guthaben brechen die Assistenten mit einem Fehler ab. Claude Code lässt sich statt mit einem Abo mit einem Claude-Console-Konto anmelden. Für Codex öffnen Sie ai-agent-user und führen die folgende Zeile aus. Sie fragt nach dem Schlüssel, ohne ihn anzuzeigen, und hinterlässt ihn nicht im Befehlsverlauf:

read -rsp 'API key: ' OPENAI_API_KEY && printf '%s' "$OPENAI_API_KEY" | codex login --with-api-key; unset OPENAI_API_KEY

Geben Sie danach exit ein. Für die regelmässige Arbeit ist das Abo-Konto der einfachere und besser kalkulierbare Weg - und der, den wir empfehlen.

Die erste Aufgabe

Zeit für einen kleinen Test, der zeigt, wie die Teile zusammenspielen. Legen Sie ein Testprojekt an und starten Sie darin einen Assistenten:

mkdir -p ~/ai-agent/hello-test
cd ~/ai-agent/hello-test
claude

Verwenden Sie in der letzten Zeile codex, wenn Sie diesen Assistenten eingerichtet haben. Tippen Sie jetzt eine Aufgabe in normalen Worten und drücken Sie Enter:

Erstelle eine Datei hello.html mit einer kurzen Begrüssung und dem heutigen Datum.

Das sehen Sie jetzt: Der Assistent beschreibt, was er tut, und meldet, dass er die Datei angelegt hat. Öffnen Sie den Ordner ai-agent/hello-test in Ihrem Dateimanager: hello.html liegt dort, und ein Doppelklick öffnet sie im Browser. Die Datei wurde im Container geschrieben und gehört trotzdem Ihnen, weil der Benutzer im Container Ihre Nummer hat.

Drei Dinge, die für die tägliche Arbeit nützlich sind:

  • Starten Sie den Assistenten immer im Ordner des Projekts, an dem er arbeiten soll. Dieser Ordner ist sein Arbeitsplatz.
  • /model wählt das Modell, in beiden Assistenten. /exit verlässt Claude Code, /quit verlässt Codex.
  • Anweisungen, die für jede Aufgabe in einem Projekt gelten sollen, gehören in eine Datei namens CLAUDE.md (Claude Code) oder AGENTS.md (Codex) im Projektordner. Beide Assistenten lesen ihre Datei automatisch.

Ein Sicherheitsnetz: Stellen Sie Ihr Projekt unter Git

Ein Assistent im Bypass-Modus ändert Dateien, ohne zu fragen. Meist ist das gewollt; manchmal ist das Ergebnis es nicht. Git hält den Zustand eines Ordners fest, damit Sie zu ihm zurückkehren können. Richten Sie es einmal pro Projekt ein, vor der ersten richtigen Aufgabe.

Öffnen Sie eine Shell als Ihr Benutzer und sagen Sie Git, wer Sie sind (einmalig):

ai-agent-user
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

Halten Sie dann den Ausgangszustand des Projekts fest:

cd /ai-agent/hello-test
git init
git add -A
git commit -m "Starting point"

Das sehen Sie in den letzten Zeilen (Buchstaben und Zahlen weichen ab):

[master (root-commit) d66dce4] Starting point
 1 file changed, 1 insertion(+)
 create mode 100644 hello.html

Nachdem ein Assistent gearbeitet hat, zeigt dieser Befehl, was er geändert hat:

git status --short
 M hello.html
?? extra.txt

M kennzeichnet eine geänderte Datei, ?? eine neue. Gefällt Ihnen das Ergebnis, halten Sie es mit git add -A und git commit -m "..." als neuen Zustand fest. Gefällt es Ihnen nicht, verwirft dieser Befehl alles seit dem letzten festgehaltenen Zustand:

git restore . && git clean -fd

Vorsicht mit diesem letzten Befehl: Er löscht auch neue Dateien, die Sie selbst seit dem letzten Commit angelegt haben. Sie können den Assistenten auch einfach bitten, nach jeder erledigten Aufgabe einen Commit zu machen.

Wenn Sie in Schritt 5 gh installiert haben und die Assistenten zu GitHub pushen sollen, führen Sie in dieser Shell gh auth login aus. Bedenken Sie, dass ein Assistent im Bypass-Modus diesen Zugang dann ohne Rückfrage verwenden kann - nehmen Sie deshalb ein Token, das auf die nötigen Repositories beschränkt ist.

Mit exit verlassen Sie die Shell im Container.

Alles aktuell halten

  • Claude Code aktualisiert sich selbst. Es holt neue Versionen im Hintergrund und verwendet sie ab dem nächsten Start.
  • Codex meldet beim Start, wenn eine neue Version verfügbar ist. codex update installiert sie.
  • Die Ubuntu-Pakete im Container aktualisieren Sie mit dem Helfer aus Schritt 11. Führen Sie ihn alle paar Wochen auf Ihrem Rechner aus (nicht in der Shell im Container):
ai-agent-update

Wenn etwas nicht klappt

Was Sie sehen Warum Was Sie tun
permission denied mit docker.sock in der Meldung Ihre Sitzung kennt die Gruppe docker noch nicht. Vom Desktop ab- und wieder anmelden oder neu starten.
The container name "/ai-agent" is already in use Sie haben den Befehl aus Schritt 3 ein zweites Mal ausgeführt. Nichts, wenn der Container läuft. Für einen Neuanfang: docker rm -f ai-agent, dann Schritt 3 erneut.
container ... is not running Der Container wurde von Hand gestoppt. docker start ai-agent
claude: command not found oder codex: command not found im Container Die Startdatei .profile fehlt in /ai-agent, deshalb wird ~/.local/bin nicht durchsucht. Die Zeilen cp und chown aus Schritt 6 in ai-agent-root erneut ausführen.
--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons Claude Code wurde als Administrator gestartet. Mit dem Befehl claude aus Schritt 11 starten; er führt es als Ihr Benutzer aus.
bwrap: No permissions to create a new namespace Codex wurde ohne den Schalter gestartet, der seine eigene Sandbox abschaltet; diese kann in einem Container nicht laufen. Mit dem Befehl codex aus Schritt 11 starten.
sudo: unable to resolve host ai-agent Der Container läuft mit --network host und ohne die Zeile --add-host, zum Beispiel nach einer älteren Fassung dieser Anleitung. Harmlos. Um sie loszuwerden, den Container mit dem Befehl aus Schritt 3 oder aus dem Abschnitt zur Variante neu aufbauen.
error: externally-managed-environment nach pip install Ubuntu schützt sein eigenes Python vor fremden Paketen. Für ein Werkzeug: pipx install name. Für ein Projekt: python3 -m venv .venv, danach .venv/bin/pip install name.
npx: command not found, oder ein MCP-Server startet nicht Node.js fehlt, oder die Zeilen für ~/.profile am Ende von Schritt 6 fehlen. Den optionalen Node.js-Teil von Schritt 6 ausführen, einschliesslich seines letzten Blocks.
Dateien in ~/ai-agent gehören root und lassen sich nicht ändern Etwas wurde in der Administrator-Shell angelegt. Auf Ihrem Rechner: sudo chown -R "$(id -u):$(id -g)" ~/ai-agent
Nach der Codex-Anmeldung endet der Browser auf einer Seite, die sich nicht laden lässt, und das Terminal wartet weiter Codex wurde ohne --device-auth angemeldet. Der Browser will dann einem Programm auf Ihrem Rechner antworten, Codex läuft aber im Container. Im Terminal Ctrl+C drücken und codex login --device-auth verwenden.
command not found bei claude, codex oder ai-agent-update Die Befehle aus Schritt 11 sind in diesem Terminal nicht geladen, oder Sie sind noch in der Shell im Container, wo es sie nicht gibt. Enthält der Prompt @ai-agent, geben Sie zuerst exit ein. Sonst öffnen Sie ein neues Terminal oder führen source ~/.bashrc aus.

Für Claude Code gibt claude doctor einen kurzen Zustandsbericht der Installation aus. Codex hat dasselbe mit codex doctor.

Den Container neu aufbauen oder alles entfernen

Neu aufbauen. Weil Programme, Anmeldungen und Einstellungen der Assistenten im gemeinsamen Ordner liegen, kostet ein neuer Container Sie nur die Pakete aus den Schritten 4 und 5:

docker rm -f ai-agent

Wiederholen Sie danach Schritt 3, Schritt 4, die Gruppen aus Schritt 5, die Sie verwenden, und den ersten Teil von Schritt 6 (Benutzer anlegen, sudo erlauben). Die Schritte 7 bis 12 sind nicht noch einmal nötig: Beide Assistenten, Ihre Anmeldungen und Ihre Projekte sind noch da.

Alles entfernen. Wenn Sie den ganzen Aufbau loswerden wollen, löschen diese Befehle den Container, die heruntergeladenen Images und beide Ordner. Die dritte Zeile löscht alle Ihre Projekte in ~/ai-agent. Kopieren Sie vorher, was Sie behalten wollen.

docker rm -f ai-agent
docker rmi ubuntu:26.04 hello-world
sudo rm -rf ~/ai-agent
sudo rm -rf /ai-agent-tmp

Löschen Sie zum Schluss den Block aus Schritt 11 am Ende von ~/.bashrc.

Variante: Wenn der Assistent Dienste auf Ihrem Rechner erreichen muss

Im Standardaufbau hat der Container ein eigenes Netzwerk. Ein Assistent kann deshalb http://localhost:8080 Ihres Rechners nicht öffnen, zum Beispiel die Weboberfläche einer Anwendung, die in einem anderen Container läuft. Brauchen Sie das, kann der Container stattdessen das Netzwerk Ihres Rechners verwenden. Lesen Sie diesen Abschnitt zu Ende, bevor Sie sich entscheiden: Die Variante öffnet mehr als die eine Adresse, an die Sie denken.

1. Den Container mit dem Netzwerk Ihres Rechners starten. Gibt es den Container schon, entfernen Sie ihn mit docker rm -f ai-agent (Ihre Dateien bleiben) und wiederholen Sie danach die Schritte, die oben unter «Neu aufbauen» stehen, mit dem folgenden Befehl anstelle jenes aus Schritt 3. Er hat zwei zusätzliche Zeilen, --add-host und --network host:

docker run -d \
  --init \
  --pids-limit=4096 \
  --restart=unless-stopped \
  --name ai-agent \
  --hostname ai-agent \
  --add-host ai-agent:127.0.0.1 \
  --network host \
  -e TZ=Europe/Zurich \
  -e LANG=C.UTF-8 \
  -v "$HOME/ai-agent:/ai-agent" \
  -v "/ai-agent-tmp:/tmp" \
  ubuntu:26.04 \
  sleep infinity

Die Zeile --add-host sorgt dafür, dass der Container sich weiterhin unter seinem Namen findet. Ab jetzt ist localhost im Container Ihr Rechner, und codex login funktioniert ohne --device-auth.

2. Die Tür zu Ihrer Arbeitsoberfläche schliessen. Mit dem geteilten Netzwerk kann sich ein Programm im Container mit dem Dienst verbinden, der die Fenster Ihrer Arbeitsoberfläche zeichnet (X11). Ubuntu und Linux Mint lassen jedes Programm, das unter Ihrer Benutzernummer läuft, ohne Schlüssel herein, und der Benutzer im Container hat Ihre Nummer. Ein solches Programm könnte Ihren Bildschirm mitlesen und in Ihre Fenster tippen. Dieser Befehl, auf Ihrem Rechner ausgeführt, entzieht diese Erlaubnis. Ihre eigenen Programme laufen weiter, weil sie einen Schlüssel besitzen:

xhost -SI:localuser:"$USER"

Prüfen Sie es gleich: Öffnen Sie ein neues Terminal und ein beliebiges Programm aus dem Menü. Öffnen sich beide, ist alles in Ordnung. Verweigert ein Programm den Start mit cannot open display oder Authorization required, stellt dieser Befehl den alten Zustand sofort wieder her:

xhost +SI:localuser:"$USER"

Die Erlaubnis kommt bei jeder Anmeldung zurück. Dieser Befehl legt einen Starteintrag an, der sie bei jeder Anmeldung wieder entzieht:

mkdir -p ~/.config/autostart
cat > ~/.config/autostart/ai-agent-xhost.desktop <<EOF
[Desktop Entry]
Type=Application
Name=Close the desktop for the AI agent container
Exec=xhost -SI:localuser:$USER
EOF

3. Aus dem Container heraus kontrollieren. Dieser Befehl bittet die Arbeitsoberfläche um eine Verbindung, so wie es ein unerwünschtes Programm täte, als Ihr Benutzer:

docker exec -i -u "$USER" ai-agent python3 - <<'EOF'
import re, socket, struct
names = sorted(set(re.findall(r"@(/tmp/\.X11-unix/X\d+)", open("/proc/net/unix").read())))
result = "closed"
for name in names:
    s = socket.socket(socket.AF_UNIX)
    s.settimeout(5)
    try:
        s.connect("\0" + name)
        s.sendall(b"l\0" + struct.pack("<HHHH", 11, 0, 0, 0) + b"\0\0")
        if s.recv(8)[:1] == b"\x01":
            result = "OPEN"
    except OSError:
        pass
    finally:
        s.close()
print(result)
EOF

Das sehen Sie jetzt:

closed

Steht dort OPEN, erreicht der Container Ihre Arbeitsoberfläche. Wiederholen Sie Teil 2, melden Sie sich ab und wieder an und kontrollieren Sie erneut. Verwenden Sie die Variante nicht, solange das Ergebnis OPEN lautet.

Was offen bleibt. In dieser Variante erreichen die Assistenten alles, was auf Ihrem Rechner lauscht: Weboberflächen anderer Container, Datenbanken, Entwicklungsserver - auch jene, an die Sie nicht gedacht haben. Ein Assistent mit Administratorrechten im Container (die zwei sudo-Zeilen aus Schritt 6) kann zudem den Netzwerkverkehr Ihres Rechners mitlesen; lassen Sie diese zwei Zeilen in dieser Variante weg, wenn Sie sie nicht brauchen. Das ist der Zweck der Variante und ihr Preis.

Sicherheit: Was der Container schützt und was nicht

  • Geschützt: Ihre Dateien ausserhalb von ~/ai-agent und /ai-agent-tmp, Ihre Arbeitsoberfläche und die Dienste, die nur auf Ihrem Rechner selbst lauschen. Ein Assistent kann Dateien, die er nicht sieht, weder lesen noch löschen.
  • Nicht geschützt: der Arbeitsbereich selbst. Im Bypass-Modus darf ein Assistent in ~/ai-agent alles ändern oder löschen. Verwenden Sie Git wie oben beschrieben, und sichern Sie Projekte, die Ihnen wichtig sind. Behandeln Sie Programme in ~/ai-agent wie Downloads aus dem Internet: Starten Sie sie nicht auf Ihrem eigenen Rechner, wenn Sie nicht wissen, was sie tun.
  • Nicht geschützt: das Netzwerk. Der Container erreicht das Internet und alles, was Ihr Rechner anderen Geräten in Ihrem Netzwerk anbietet, zum Beispiel einen freigegebenen Ordner. Anthropic empfiehlt den Bypass-Modus für abgeschottete Umgebungen, am besten ohne Internetzugang. Mit Internetzugang bleibt ein Risiko: Eine Webseite oder eine Datei kann Text enthalten, der einen Assistenten zu etwas verleitet, das Sie nicht verlangt haben - zum Beispiel dazu, Daten aus dem Arbeitsbereich irgendwohin zu senden. Legen Sie deshalb nichts in ~/ai-agent ab, das Ihren Rechner nie verlassen darf.
  • Teilen Sie nie mehr als den Arbeitsbereich. Übergeben Sie dem Container weder Ihr Home-Verzeichnis noch ~/.ssh noch die Docker-Steuerdatei /var/run/docker.sock. Und starten Sie ihn nicht mit --network host ohne die Vorkehrungen aus dem Abschnitt zur Variante. Die Verbotsliste aus Schritt 9 (nur Claude Code) verhindert versehentliches Lesen; sie ersetzt diese Regel nicht.
  • Die Anmeldedateien sind Passwörter. ~/ai-agent/.claude/.credentials.json und ~/ai-agent/.codex/auth.json sind lesbarer Text. Synchronisieren Sie ~/ai-agent nicht mit einem Cloud-Speicher und veröffentlichen Sie den Ordner nicht.
  • Ein vorsichtigerer Modus für Claude Code. Claude Code kennt auch einen Modus namens auto: Ein zweites Modell prüft jede riskante Aktion, bevor sie läuft, und blockiert die gefährlichen, während alles andere ohne Rückfragen läuft. Um ihn für eine Sitzung zu verwenden, öffnen Sie ai-agent-user, wechseln in Ihren Projektordner und starten claude --permission-mode auto.

Häufige Fragen

Sehen die Assistenten meine anderen Dateien?
Nein. Sie sehen nur den Ordner ~/ai-agent und den Ordner für temporäre Dateien. Ihre übrigen Dateien existieren für sie nicht.

Kann ein Assistent eine Website öffnen, die auf meinem Rechner läuft?
Im Standardaufbau nicht: localhost ist im Container der Container selbst. Der Abschnitt zur Variante zeigt, wie Sie es erlauben und was das sonst noch öffnet.

Brauche ich sowohl Claude Code als auch Codex?
Nein. Jeder funktioniert für sich. Überspringen Sie die Schritte, die für den anderen markiert sind.

Was kostet das?
Docker, Ubuntu und beide Programme sind kostenlos. Sie bezahlen das Abo des Assistenten, den Sie verwenden - oder nach Verbrauch, wenn Sie einen API-Schlüssel wählen.

Funktioniert das unter Windows oder macOS?
Diese Anleitung gilt nur für Linux. Die Befehle sind für Ubuntu und Linux Mint geschrieben.

Kann ich an mehreren Projekten arbeiten?
Ja. Jedes Projekt ist ein eigener Ordner unterhalb von ~/ai-agent. Wechseln Sie in den Ordner und starten Sie den Assistenten dort.

Was passiert, wenn ich meinen Rechner neu starte?
Der Container startet von selbst wieder. Sie öffnen ein Terminal und tippen claude oder codex wie zuvor.

Warum installiere ich die Assistenten nicht einfach auf meinem Rechner?
Das können Sie. Dann fragen sie vor jeder Aktion - oder dürfen im Bypass-Modus alles anfassen, was Ihr Benutzer anfassen darf. Der Container gibt Ihnen das Tempo des Bypass-Modus mit einer Grenze für den Schaden.

Wo ändere ich das Modell?
Im Assistenten, mit /model. Keine der Einstellungsdateien dieser Anleitung nennt ein Modell.

Was sich seit der letzten Fassung geändert hat

Für Leser, die einer früheren Fassung der englischen Anleitung gefolgt sind:

  • Bevor Sie den neuen Block aus Schritt 11 in ~/.bashrc einfügen, löschen Sie den Block der früheren Fassung. Alte und neue Definitionen mit demselben Namen kommen sich in die Quere.
  • Die Paketliste ist in eine Basis und optionale Gruppen aufgeteilt und gegen Ubuntu 26.04 geprüft. Node.js kommt jetzt von nvm und gh aus der Paketquelle von GitHub, weil die Versionen in Ubuntu alt sind.
  • Modellnamen stehen in keiner der zwei Einstellungsdateien mehr. Das Modell wählen Sie mit /model.
  • Die Codex-Einstellungen enthalten kein Sandbox-Profil mehr: Die Sandbox von Codex kann in einem Docker-Container nicht starten. Codex wird mit ausgeschalteter Sandbox gestartet, wie Claude Code im Bypass-Modus.
  • Die Befehle für ~/.bashrc heissen jetzt ai-agent-root, ai-agent-user und ai-agent-update. Der Bypass-Modus wird in den Startbefehlen eingeschaltet statt in der Einstellungsdatei, wo er leicht zu übersehen war.
  • Der Container teilt das Netzwerk Ihres Rechners nicht mehr. Mit dem geteilten Netzwerk konnte ein Programm im Container die Arbeitsoberfläche des Rechners erreichen. Die Anmeldung läuft neu über einen Code, und ein neuer Abschnitt zeigt die Variante für Assistenten, die lokale Dienste erreichen müssen.
  • Der Aktualisierungs-Helfer installiert die Assistenten nicht mehr neu: Claude Code aktualisiert sich selbst, und Codex hat codex update.
  • Neue Abschnitte: Begriffe, eine erste Aufgabe, Git als Sicherheitsnetz, eine Tabelle für typische Fehlermeldungen, alles entfernen und häufige Fragen.