---
title: "Node.js und ACP · Alran-Code-Doku"
url: https://alran.dev/de/docs/sdk
locale: de
updated: 2026-11-16
---

[Doku](https://alran.dev/de/docs)Automatisieren

# Node.js und ACP

Steuer Alran Code aus deinem eigenen Programm, oder schließ es an jeden Editor an, der das Agent Client Protocol spricht.

Auf dieser Seite

[Wie steuere ich Alran Code aus meinem eigenen Programm?](#entry) [Aus Node.js](#node) [ACP](#acp) [Den Prompt des Agenten ändern](#prompt) [Häufige Fragen](#faq)

## Wie steuere ich Alran Code aus meinem eigenen Programm? {#entry}

| Einstieg | Befehl | Wofür |
| Interaktive TUI | `alran [prompt]` | Selbst mit dem Agenten arbeiten |
| Headless | `alran exec [prompt]` | Skripte, CI, Stapelläufe, Evaluierungen |
| ACP | `alran acp` | Editoren und Clients, die das Agent Client Protocol sprechen |

## Aus Node.js {#node}

`alran exec --output-format stream-json` schreibt ein JSON-Ereignis pro Zeile, das jede Sprache lesen kann:

```js
import { spawn } from 'node:child_process';
import { createInterface } from 'node:readline';

const run = spawn('alran', ['exec', '--output-format', 'stream-json', 'Behebe den roten Test']);
for await (const line of createInterface({ input: run.stdout })) {
  const event = JSON.parse(line);
  console.log(event.type);
}
```

## ACP {#acp}

```bash
alran acp
```

Startet Alran Code als Agent-Client-Protocol-Server über stdio. Ein Editor startet ihn und spricht mit ihm; Werkzeuge, Berechtigungen, Skills, Plugins, MCP, Subagents, Ziele und Sitzungen verhalten sich genau wie im Terminal, weil dieselbe Runtime sie ausführt. Die [VS-Code-Erweiterung](https://alran.dev/de/docs/vscode) arbeitet so.

## Den Prompt des Agenten ändern {#prompt}

Jeder Einstieg kennt dieselben Schalter für einen Prozess:

| Option | Was sie tut |
| `--append-system-prompt <text>` | Text hinter die Identität des Agenten hängen |
| `--append-system-prompt-file <pfad>` | Dasselbe aus einer Datei |
| `--system-prompt <text>` | Den Identitätsabschnitt ersetzen |
| `--system-prompt-file <pfad>` | Dasselbe aus einer Datei |

Projektanweisungen (`AGENTS.md`), Umgebung, Gedächtnis und Skills bleiben in beiden Fällen erhalten.

## Häufige Fragen {#faq}

Wie rufe ich Alran Code aus meinem eigenen Programm auf?

Es gibt drei Wege hinein: die interaktive TUI mit alran, der Headless-Modus mit alran exec für Skripte, CI und Stapelläufe, und das Agent Client Protocol mit alran acp für Editoren und Clients, die es sprechen. In einem Skript startest du alran exec --output-format stream-json und liest die Ausgabe Zeile für Zeile: Er schreibt ein JSON-Ereignis pro Zeile, das jede Sprache lesen kann.

Was ist das Agent Client Protocol und wann nutze ich es?

alran acp startet Alran Code als Agent-Client-Protocol-Server über stdio. Ein Editor startet ihn und spricht mit ihm; Werkzeuge, Berechtigungen, Skills, Plugins, MCP, Subagents, Ziele und Sitzungen verhalten sich genau wie im Terminal, weil dieselbe Runtime sie ausführt. So arbeitet auch die VS-Code-Erweiterung.

Wie ändere ich den System-Prompt des Agenten?

Jeder Einstieg kennt dieselben Schalter für einen Prozess: --append-system-prompt und --append-system-prompt-file hängen Text hinter die Identität des Agenten, --system-prompt und --system-prompt-file ersetzen den Identitätsabschnitt. Projektanweisungen in AGENTS.md, die Umgebung, das Gedächtnis und die Skills bleiben in beiden Fällen erhalten.

[ZurückHeadless und CI](https://alran.dev/de/docs/headless) [WeiterVS-Code-Erweiterung](https://alran.dev/de/docs/vscode)
