Documentation 2026-10-29 23:57 UTC to 2026-10-30 23:01 UTC

77* **Python:** überprüfen Sie Nachrichtentypen mit `isinstance()` gegen Klassen, die aus `claude_agent_sdk` importiert wurden (zum Beispiel, `isinstance(message, ResultMessage)`).77* **Python:** überprüfen Sie Nachrichtentypen mit `isinstance()` gegen Klassen, die aus `claude_agent_sdk` importiert wurden (zum Beispiel, `isinstance(message, ResultMessage)`).

78* **TypeScript:** überprüfen Sie das Feld `type` string (zum Beispiel, `message.type === "result"`). `AssistantMessage` und `UserMessage` umhüllen die rohe API-Nachricht in einem `.message`-Feld, daher befinden sich Inhaltsblöcke bei `message.message.content`, nicht bei `message.content`.78* **TypeScript:** überprüfen Sie das Feld `type` string (zum Beispiel, `message.type === "result"`). `AssistantMessage` und `UserMessage` umhüllen die rohe API-Nachricht in einem `.message`-Feld, daher befinden sich Inhaltsblöcke bei `message.message.content`, nicht bei `message.content`.

79 79 

80> **Beispiel: Nachrichtentypen überprüfen und Ergebnisse verarbeiten**80> [accordion] Beispiel: Nachrichtentypen überprüfen und Ergebnisse verarbeiten

81>81>

82> ```python Python theme={null}82> ```python Python theme={null}

83> import asyncio83> import asyncio

273* **`PreCompact`-Hook:** Führen Sie benutzerdefinierte Logik vor der Komprimierung aus, zum Beispiel um das vollständige Transkript zu archivieren. Der Hook erhält ein `trigger`-Feld (`manual` oder `auto`). Siehe [Hooks](https://code.claude.com/docs/de/agent-sdk/hooks.md).273* **`PreCompact`-Hook:** Führen Sie benutzerdefinierte Logik vor der Komprimierung aus, zum Beispiel um das vollständige Transkript zu archivieren. Der Hook erhält ein `trigger`-Feld (`manual` oder `auto`). Siehe [Hooks](https://code.claude.com/docs/de/agent-sdk/hooks.md).

274* **Manuelle Komprimierung:** Senden Sie `/compact` als Prompt-String, um Komprimierung bei Bedarf auszulösen. Befehle, die auf diese Weise gesendet werden, sind SDK-Eingaben. Siehe [dispatch commands by name](https://code.claude.com/docs/de/agent-sdk/skills.md#dispatch-commands-by-name).274* **Manuelle Komprimierung:** Senden Sie `/compact` als Prompt-String, um Komprimierung bei Bedarf auszulösen. Befehle, die auf diese Weise gesendet werden, sind SDK-Eingaben. Siehe [dispatch commands by name](https://code.claude.com/docs/de/agent-sdk/skills.md#dispatch-commands-by-name).

275 275 

276> **Beispiel: Zusammenfassungsanweisungen in CLAUDE.md**276> [accordion] Beispiel: Zusammenfassungsanweisungen in CLAUDE.md

277>277>

278> Fügen Sie einen Abschnitt zu Ihrer Projekt-CLAUDE.md hinzu, der dem Kompressor sagt, was zu bewahren ist. Der Kopfname ist nicht speziell; verwenden Sie ein beliebiges klares Label.278> Fügen Sie einen Abschnitt zu Ihrer Projekt-CLAUDE.md hinzu, der dem Kompressor sagt, was zu bewahren ist. Der Kopfname ist nicht speziell; verwenden Sie ein beliebiges klares Label.

279>279>

42 42 

43Python-Beispiele auf dieser Seite, die HTTP-Anfragen senden, verwenden [httpx](https://www.python-httpx.org/). Fügen Sie es mit dem Paketmanager hinzu, den Ihr Projekt verwendet:43Python-Beispiele auf dieser Seite, die HTTP-Anfragen senden, verwenden [httpx](https://www.python-httpx.org/). Fügen Sie es mit dem Paketmanager hinzu, den Ihr Projekt verwendet:

44 44 

45**Python (uv)**45> [tab] Python (uv)

46 46>

47```bash theme={null}47> ```bash theme={null}

48uv add httpx48> uv add httpx

49```49> ```

50 

51**Python (pip)**

52 50 

53```bash theme={null}51> [tab] Python (pip)

54pip install httpx52>

55```53> ```bash theme={null}

54> pip install httpx

55> ```

56 56 

57### Beispiel für ein Wetter-Tool57### Beispiel für ein Wetter-Tool

58 58 

198 198 

199Kombinieren Sie diesen Snippet mit den Tool- und Server-Definitionen aus dem [Wetter-Tool-Beispiel](#weather-tool-example) in einer Datei, `weather.py` oder `weather.ts`, und führen Sie ihn dann in Ihrem Terminal aus:199Kombinieren Sie diesen Snippet mit den Tool- und Server-Definitionen aus dem [Wetter-Tool-Beispiel](#weather-tool-example) in einer Datei, `weather.py` oder `weather.ts`, und führen Sie ihn dann in Ihrem Terminal aus:

200 200 

201**TypeScript**201> [tab] TypeScript

202 202>

203```bash theme={null}203> ```bash theme={null}

204npx tsx weather.ts204> npx tsx weather.ts

205```205> ```

206 

207**Python (uv)**

208 

209```bash theme={null}

210uv run weather.py

211```

212 

213**Python (pip)**

214 206 

215Aktivieren Sie die virtuelle Umgebung, in der Sie das SDK installiert haben, und führen Sie dann Folgendes aus:207> [tab] Python (uv)

208>

209> ```bash theme={null}

210> uv run weather.py

211> ```

216 212 

217```bash theme={null}213> [tab] Python (pip)

218python weather.py214>

219```215> Aktivieren Sie die virtuelle Umgebung, in der Sie das SDK installiert haben, und führen Sie dann Folgendes aus:

216>

217> ```bash theme={null}

218> python weather.py

219> ```

220 220 

221Claude ruft `get_temperature` auf und das Skript gibt eine einzeilige Antwort mit der aktuellen Temperatur in San Francisco aus.221Claude ruft `get_temperature` auf und das Skript gibt eine einzeilige Antwort mit der aktuellen Temperatur in San Francisco aus.

222 222 

585>585>

586> Öffnen Sie Ihre Utility-Datei (`utils.py` oder `utils.ts`) in Ihrer IDE oder Ihrem Editor, bevor Sie das Skript ausführen. Sie sehen, wie die Datei in Echtzeit aktualisiert wird, während der Agent Dokumentationskommentare hinzufügt, und dann zum Original zurückkehrt, wenn Sie sich zum Zurückspulen entscheiden.586> Öffnen Sie Ihre Utility-Datei (`utils.py` oder `utils.ts`) in Ihrer IDE oder Ihrem Editor, bevor Sie das Skript ausführen. Sie sehen, wie die Datei in Echtzeit aktualisiert wird, während der Agent Dokumentationskommentare hinzufügt, und dann zum Original zurückkehrt, wenn Sie sich zum Zurückspulen entscheiden.

587 587 

588**Python**588> [tab] Python

589 589>

590```bash theme={null}590> ```bash theme={null}

591python try_checkpointing.py591> python try_checkpointing.py

592```592> ```

593 

594**TypeScript**

595 593 

596```bash theme={null}594> [tab] TypeScript

597npx tsx try_checkpointing.ts595>

598```596> ```bash theme={null}

597> npx tsx try_checkpointing.ts

598> ```

599 599 

600Sie sehen, dass der Agent Dokumentationskommentare hinzufügt, dann eine Eingabeaufforderung, die fragt, ob Sie zurückspulen möchten. Wenn Sie ja wählen, wird die Datei in ihren ursprünglichen Zustand zurückgesetzt.600Sie sehen, dass der Agent Dokumentationskommentare hinzufügt, dann eine Eingabeaufforderung, die fragt, ob Sie zurückspulen möchten. Wenn Sie ja wählen, wird die Datei in ihren ursprünglichen Zustand zurückgesetzt.

601 601 

386 386 

387Verwenden Sie das Feld `env`, um API-Schlüssel, Token und andere Anmeldedaten an den MCP-Server zu übergeben:387Verwenden Sie das Feld `env`, um API-Schlüssel, Token und andere Anmeldedaten an den MCP-Server zu übergeben:

388 388 

389**Im Code**389> [tab] Im Code

390 390>

391```typescript TypeScript hidelines={1,-1} theme={null}391> ```typescript TypeScript hidelines={1,-1} theme={null}

392const _ = {392> const _ = {

393 options: {393> options: {

394 mcpServers: {394> mcpServers: {

395 "api-server": {395> "api-server": {

396 command: "npx",396> command: "npx",

397 args: ["-y", "@your-org/api-mcp-server"],397> args: ["-y", "@your-org/api-mcp-server"],

398 env: {398> env: {

399 API_KEY: process.env.API_KEY399> API_KEY: process.env.API_KEY

400 }400> }

401 }401> }

402 },402> },

403 allowedTools: ["mcp__api-server__*"]403> allowedTools: ["mcp__api-server__*"]

404 }404> }

405};405> };

406```406> ```

407 407>

408```python Python theme={null}408> ```python Python theme={null}

409options = ClaudeAgentOptions(409> options = ClaudeAgentOptions(

410 mcp_servers={410> mcp_servers={

411 "api-server": {411> "api-server": {

412 "command": "npx",412> "command": "npx",

413 "args": ["-y", "@your-org/api-mcp-server"],413> "args": ["-y", "@your-org/api-mcp-server"],

414 "env": {"API_KEY": os.environ["API_KEY"]},414> "env": {"API_KEY": os.environ["API_KEY"]},

415 }415> }

416 },416> },

417 allowed_tools=["mcp__api-server__*"],417> allowed_tools=["mcp__api-server__*"],

418)418> )

419```419> ```

420 420 

421**.mcp.json**421> [tab] .mcp.json

422 422>

423```json theme={null}423> ```json theme={null}

424{424> {

425 "mcpServers": {425> "mcpServers": {

426 "api-server": {426> "api-server": {

427 "command": "npx",427> "command": "npx",

428 "args": ["-y", "@your-org/api-mcp-server"],428> "args": ["-y", "@your-org/api-mcp-server"],

429 "env": {429> "env": {

430 "API_KEY": "${API_KEY}"430> "API_KEY": "${API_KEY}"

431 }431> }

432 }432> }

433 }433> }

434}434> }

435```435> ```

436 436>

437Die Syntax `${API_KEY}` erweitert Umgebungsvariablen zur Laufzeit.437> Die Syntax `${API_KEY}` erweitert Umgebungsvariablen zur Laufzeit.

438 438 

439### HTTP-Header für Remote-Server439### HTTP-Header für Remote-Server

440 440 

441Für HTTP- und SSE-Server übergeben Sie Authentifizierungs-Header direkt in der Serverkonfiguration:441Für HTTP- und SSE-Server übergeben Sie Authentifizierungs-Header direkt in der Serverkonfiguration:

442 442 

443**Im Code**443> [tab] Im Code

444 444>

445```typescript TypeScript hidelines={1,-1} theme={null}445> ```typescript TypeScript hidelines={1,-1} theme={null}

446const _ = {446> const _ = {

447 options: {447> options: {

448 mcpServers: {448> mcpServers: {

449 "secure-api": {449> "secure-api": {

450 type: "http",450> type: "http",

451 url: "https://api.example.com/mcp",451> url: "https://api.example.com/mcp",

452 headers: {452> headers: {

453 Authorization: `Bearer ${process.env.API_TOKEN}`453> Authorization: `Bearer ${process.env.API_TOKEN}`

454 }454> }

455 }455> }

456 },456> },

457 allowedTools: ["mcp__secure-api__*"]457> allowedTools: ["mcp__secure-api__*"]

458 }458> }

459};459> };

460```460> ```

461 461>

462```python Python theme={null}462> ```python Python theme={null}

463options = ClaudeAgentOptions(463> options = ClaudeAgentOptions(

464 mcp_servers={464> mcp_servers={

465 "secure-api": {465> "secure-api": {

466 "type": "http",466> "type": "http",

467 "url": "https://api.example.com/mcp",467> "url": "https://api.example.com/mcp",

468 "headers": {"Authorization": f"Bearer {os.environ['API_TOKEN']}"},468> "headers": {"Authorization": f"Bearer {os.environ['API_TOKEN']}"},

469 }469> }

470 },470> },

471 allowed_tools=["mcp__secure-api__*"],471> allowed_tools=["mcp__secure-api__*"],

472)472> )

473```473> ```

474 474 

475**.mcp.json**475> [tab] .mcp.json

476 476>

477```json theme={null}477> ```json theme={null}

478{478> {

479 "mcpServers": {479> "mcpServers": {

480 "secure-api": {480> "secure-api": {

481 "type": "http",481> "type": "http",

482 "url": "https://api.example.com/mcp",482> "url": "https://api.example.com/mcp",

483 "headers": {483> "headers": {

484 "Authorization": "Bearer ${API_TOKEN}"484> "Authorization": "Bearer ${API_TOKEN}"

485 }485> }

486 }486> }

487 }487> }

488}488> }

489```489> ```

490 490>

491Die Syntax `${API_TOKEN}` erweitert Umgebungsvariablen zur Laufzeit.491> Die Syntax `${API_TOKEN}` erweitert Umgebungsvariablen zur Laufzeit.

492 492 

493Ein vollständiges funktionierendes Beispiel eines Remote-Servers mit Header-Authentifizierung finden Sie unter [Probleme aus einem Repository auflisten](#list-issues-from-a-repository).493Ein vollständiges funktionierendes Beispiel eines Remote-Servers mit Header-Authentifizierung finden Sie unter [Probleme aus einem Repository auflisten](#list-issues-from-a-repository).

494 494 

163 163 

164Sie können den Berechtigungsmodus einmalig beim Starten einer Abfrage festlegen oder ihn dynamisch ändern, während die Sitzung aktiv ist.164Sie können den Berechtigungsmodus einmalig beim Starten einer Abfrage festlegen oder ihn dynamisch ändern, während die Sitzung aktiv ist.

165 165 

166**Zum Abfragezeitpunkt**166> [tab] Zum Abfragezeitpunkt

167 167>

168Übergeben Sie `permission_mode` (Python) oder `permissionMode` (TypeScript) beim Erstellen einer Abfrage.168> Übergeben Sie `permission_mode` (Python) oder `permissionMode` (TypeScript) beim Erstellen einer Abfrage.

169 169>

170```python Python theme={null}170> ```python Python theme={null}

171import asyncio171> import asyncio

172from claude_agent_sdk import query, ClaudeAgentOptions172> from claude_agent_sdk import query, ClaudeAgentOptions

173 173>

174 174>

175async def main():175> async def main():

176 async for message in query(176> async for message in query(

177 prompt="Help me refactor this code",177> prompt="Help me refactor this code",

178 options=ClaudeAgentOptions(178> options=ClaudeAgentOptions(

179 permission_mode="default", # Set the mode here179> permission_mode="default", # Set the mode here

180 ),180> ),

181 ):181> ):

182 if hasattr(message, "result"):182> if hasattr(message, "result"):

183 print(message.result)183> print(message.result)

184 184>

185 185>

186asyncio.run(main())186> asyncio.run(main())

187```187> ```

188 188>

189```typescript TypeScript theme={null}189> ```typescript TypeScript theme={null}

190import { query } from "@anthropic-ai/claude-agent-sdk";190> import { query } from "@anthropic-ai/claude-agent-sdk";

191 191>

192async function main() {192> async function main() {

193 for await (const message of query({193> for await (const message of query({

194 prompt: "Help me refactor this code",194> prompt: "Help me refactor this code",

195 options: {195> options: {

196 permissionMode: "default" // Set the mode here196> permissionMode: "default" // Set the mode here

197 }197> }

198 })) {198> })) {

199 if ("result" in message) {199> if ("result" in message) {

200 console.log(message.result);200> console.log(message.result);

201 }201> }

202 }202> }

203}203> }

204 204>

205main();205> main();

206```206> ```

207 

208**Während des Streaming**

209 

210Rufen Sie `set_permission_mode()` (Python) oder `setPermissionMode()` (TypeScript) auf, um den Modus während der Sitzung zu ändern. Der neue Modus wird sofort für alle nachfolgenden Tool-Anfragen wirksam. Dies ermöglicht es Ihnen, restriktiv zu beginnen und die Berechtigungen zu lockern, wenn Vertrauen aufgebaut wird, z. B. durch Wechsel zu `acceptEdits` nach Überprüfung von Claudes anfänglichem Ansatz.

211 

212```python Python theme={null}

213import asyncio

214from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

215 

216 

217async def main():

218 async with ClaudeSDKClient(

219 options=ClaudeAgentOptions(

220 permission_mode="default", # Start in default mode

221 )

222 ) as client:

223 await client.query("Help me refactor this code")

224 

225 # Change mode dynamically mid-session

226 await client.set_permission_mode("acceptEdits")

227 

228 # Process messages with the new permission mode

229 async for message in client.receive_response():

230 if hasattr(message, "result"):

231 print(message.result)

232 

233 

234asyncio.run(main())

235```

236 207 

237```typescript TypeScript theme={null}208> [tab] Während des Streaming

238import { query } from "@anthropic-ai/claude-agent-sdk";209>

239 210> Rufen Sie `set_permission_mode()` (Python) oder `setPermissionMode()` (TypeScript) auf, um den Modus während der Sitzung zu ändern. Der neue Modus wird sofort für alle nachfolgenden Tool-Anfragen wirksam. Dies ermöglicht es Ihnen, restriktiv zu beginnen und die Berechtigungen zu lockern, wenn Vertrauen aufgebaut wird, z. B. durch Wechsel zu `acceptEdits` nach Überprüfung von Claudes anfänglichem Ansatz.

240async function main() {211>

241 const q = query({212> ```python Python theme={null}

242 prompt: "Help me refactor this code",213> import asyncio

243 options: {214> from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

244 permissionMode: "default" // Start in default mode215>

245 }216>

246 });217> async def main():

247 218> async with ClaudeSDKClient(

248 // Change mode dynamically mid-session219> options=ClaudeAgentOptions(

249 await q.setPermissionMode("acceptEdits");220> permission_mode="default", # Start in default mode

250 221> )

251 // Process messages with the new permission mode222> ) as client:

252 for await (const message of q) {223> await client.query("Help me refactor this code")

253 if ("result" in message) {224>

254 console.log(message.result);225> # Change mode dynamically mid-session

255 }226> await client.set_permission_mode("acceptEdits")

256 }227>

257}228> # Process messages with the new permission mode

258 229> async for message in client.receive_response():

259main();230> if hasattr(message, "result"):

260```231> print(message.result)

232>

233>

234> asyncio.run(main())

235> ```

236>

237> ```typescript TypeScript theme={null}

238> import { query } from "@anthropic-ai/claude-agent-sdk";

239>

240> async function main() {

241> const q = query({

242> prompt: "Help me refactor this code",

243> options: {

244> permissionMode: "default" // Start in default mode

245> }

246> });

247>

248> // Change mode dynamically mid-session

249> await q.setPermissionMode("acceptEdits");

250>

251> // Process messages with the new permission mode

252> for await (const message of q) {

253> if ("result" in message) {

254> console.log(message.result);

255> }

256> }

257> }

258>

259> main();

260> ```

261 261 

262### Modusdetails262### Modusdetails

263 263 

36 36 

37Installieren Sie das Agent SDK-Paket für Ihre Sprache:37Installieren Sie das Agent SDK-Paket für Ihre Sprache:

38 38 

39**TypeScript (neues Projekt)**39> [tab] TypeScript (neues Projekt)

40 40>

41```bash theme={null}41> ```bash theme={null}

42npm init -y42> npm init -y

43npm pkg set type=module43> npm pkg set type=module

44npm install @anthropic-ai/claude-agent-sdk44> npm install @anthropic-ai/claude-agent-sdk

45npm install --save-dev tsx45> npm install --save-dev tsx

46```46> ```

47 47>

48Das Setzen von `"type": "module"` in `package.json` ermöglicht Ihrem Agent-Skript die Verwendung von Top-Level-`await`, und [tsx](https://tsx.hirok.io) führt TypeScript-Dateien direkt aus. npm gibt `added N packages` aus, wenn die Installation erfolgreich ist.48> Das Setzen von `"type": "module"` in `package.json` ermöglicht Ihrem Agent-Skript die Verwendung von Top-Level-`await`, und [tsx](https://tsx.hirok.io) führt TypeScript-Dateien direkt aus. npm gibt `added N packages` aus, wenn die Installation erfolgreich ist.

49 

50**TypeScript (bestehendes Projekt)**

51 

52```bash theme={null}

53npm install @anthropic-ai/claude-agent-sdk

54npm install --save-dev tsx

55```

56 

57[tsx](https://tsx.hirok.io) führt TypeScript-Dateien direkt aus. Wenn Ihr Projekt CommonJS verwendet, benennen Sie Ihr Agent-Skript `agent.mts` statt `agent.ts`. Die `.mts`-Erweiterung veranlasst tsx, die Datei als ES-Modul zu behandeln, sodass Top-Level-`await` funktioniert, ohne Ihr gesamtes Projekt in ES-Module zu konvertieren. Verwenden Sie `agent.mts` anstelle von `agent.ts` in den Erstellungs- und Ausführungsschritten später in diesem Schnellstart.

58 

59**Python (uv)**

60 

61[Installieren Sie uv](https://docs.astral.sh/uv/), einen schnellen Python-Paketmanager, der virtuelle Umgebungen automatisch verwaltet. Initialisieren Sie dann ein Projekt und fügen Sie das SDK hinzu:

62 

63```bash theme={null}

64uv init

65uv add claude-agent-sdk

66```

67 

68**Python (pip)**

69 

70Erstellen und aktivieren Sie eine virtuelle Umgebung und installieren Sie dann das Paket.

71 

72Auf macOS oder Linux:

73 

74```bash theme={null}

75python3 -m venv .venv

76source .venv/bin/activate

77pip install claude-agent-sdk

78```

79 49 

80Unter Windows:50> [tab] TypeScript (bestehendes Projekt)

51>

52> ```bash theme={null}

53> npm install @anthropic-ai/claude-agent-sdk

54> npm install --save-dev tsx

55> ```

56>

57> [tsx](https://tsx.hirok.io) führt TypeScript-Dateien direkt aus. Wenn Ihr Projekt CommonJS verwendet, benennen Sie Ihr Agent-Skript `agent.mts` statt `agent.ts`. Die `.mts`-Erweiterung veranlasst tsx, die Datei als ES-Modul zu behandeln, sodass Top-Level-`await` funktioniert, ohne Ihr gesamtes Projekt in ES-Module zu konvertieren. Verwenden Sie `agent.mts` anstelle von `agent.ts` in den Erstellungs- und Ausführungsschritten später in diesem Schnellstart.

81 58 

82```powershell theme={null}59> [tab] Python (uv)

83py -m venv .venv60>

84.venv\Scripts\Activate.ps161> [Installieren Sie uv](https://docs.astral.sh/uv/), einen schnellen Python-Paketmanager, der virtuelle Umgebungen automatisch verwaltet. Initialisieren Sie dann ein Projekt und fügen Sie das SDK hinzu:

85pip install claude-agent-sdk62>

86```63> ```bash theme={null}

64> uv init

65> uv add claude-agent-sdk

66> ```

87 67 

88Wenn PowerShell `Activate.ps1` mit einem Ausführungsrichtlinienfehler blockiert, führen Sie zuerst `Set-ExecutionPolicy -Scope Process RemoteSigned` aus.68> [tab] Python (pip)

69>

70> Erstellen und aktivieren Sie eine virtuelle Umgebung und installieren Sie dann das Paket.

71>

72> Auf macOS oder Linux:

73>

74> ```bash theme={null}

75> python3 -m venv .venv

76> source .venv/bin/activate

77> pip install claude-agent-sdk

78> ```

79>

80> Unter Windows:

81>

82> ```powershell theme={null}

83> py -m venv .venv

84> .venv\Scripts\Activate.ps1

85> pip install claude-agent-sdk

86> ```

87>

88> Wenn PowerShell `Activate.ps1` mit einem Ausführungsrichtlinienfehler blockiert, führen Sie zuerst `Set-ExecutionPolicy -Scope Process RemoteSigned` aus.

89 89 

90> [!NOTE]90> [!NOTE]

91>91>

98 98 

99Rufen Sie einen API-Schlüssel von der [Claude-Konsole](https://platform.claude.com/) ab und legen Sie ihn dann als Umgebungsvariable in der Shell fest, in der Sie Ihren Agenten ausführen:99Rufen Sie einen API-Schlüssel von der [Claude-Konsole](https://platform.claude.com/) ab und legen Sie ihn dann als Umgebungsvariable in der Shell fest, in der Sie Ihren Agenten ausführen:

100 100 

101**macOS / Linux**101> [tab] macOS / Linux

102 102>

103```bash theme={null}103> ```bash theme={null}

104export ANTHROPIC_API_KEY=your-api-key104> export ANTHROPIC_API_KEY=your-api-key

105```105> ```

106 

107**Windows (PowerShell)**

108 106 

109```powershell theme={null}107> [tab] Windows (PowerShell)

110$env:ANTHROPIC_API_KEY = "your-api-key"108>

111```109> ```powershell theme={null}

110> $env:ANTHROPIC_API_KEY = "your-api-key"

111> ```

112 112 

113Das SDK liest den Schlüssel aus der Umgebung des Prozesses, der Ihren Agenten ausführt; es lädt `.env`-Dateien nicht automatisch. Wenn Sie den Schlüssel in einer `.env`-Datei speichern, laden Sie ihn selbst, beispielsweise mit dem `dotenv`-Paket, bevor Sie das SDK aufrufen.113Das SDK liest den Schlüssel aus der Umgebung des Prozesses, der Ihren Agenten ausführt; es lädt `.env`-Dateien nicht automatisch. Wenn Sie den Schlüssel in einer `.env`-Datei speichern, laden Sie ihn selbst, beispielsweise mit dem `dotenv`-Paket, bevor Sie das SDK aufrufen.

114 114 

224 224 

225Ihr Agent ist bereit. Führen Sie ihn mit dem folgenden Befehl aus:225Ihr Agent ist bereit. Führen Sie ihn mit dem folgenden Befehl aus:

226 226 

227**TypeScript**227> [tab] TypeScript

228 228>

229```bash theme={null}229> ```bash theme={null}

230npx tsx agent.ts230> npx tsx agent.ts

231```231> ```

232 232>

233Wenn Sie Ihr Skript `agent.mts` genannt haben, führen Sie stattdessen `npx tsx agent.mts` aus.233> Wenn Sie Ihr Skript `agent.mts` genannt haben, führen Sie stattdessen `npx tsx agent.mts` aus.

234 

235**Python (uv)**

236 

237```bash theme={null}

238uv run agent.py

239```

240 

241**Python (pip)**

242 234 

243Mit Ihrer noch aktivierten virtuellen Umgebung:235> [tab] Python (uv)

236>

237> ```bash theme={null}

238> uv run agent.py

239> ```

244 240 

245```bash theme={null}241> [tab] Python (pip)

246python agent.py242>

247```243> Mit Ihrer noch aktivierten virtuellen Umgebung:

244>

245> ```bash theme={null}

246> python agent.py

247> ```

248 248 

249Während es arbeitet, druckt der Agent seine Überlegungen und jeden Tool-Aufruf aus und endet mit `Done: success`. Nach der Ausführung überprüfen Sie `utils.py`. Sie sehen defensiven Code, der leere Listen und Null-Benutzer verarbeitet. Ihr Agent hat autonom:249Während es arbeitet, druckt der Agent seine Überlegungen und jeden Tool-Aufruf aus und endet mit `Done: success`. Nach der Ausführung überprüfen Sie `utils.py`. Sie sehen defensiven Code, der leere Listen und Null-Benutzer verarbeitet. Ihr Agent hat autonom:

250 250 

470 470 

471Jedes SDK zeigt die Ablehnung unterschiedlich an:471Jedes SDK zeigt die Ablehnung unterschiedlich an:

472 472 

473**TypeScript**473> [tab] TypeScript

474 474>

475Das TypeScript SDK wirft einen `Error`, der die Regel angibt, die der Eintrag brach. Zum Beispiel wirft `skills: ["docs:*"]`:475> Das TypeScript SDK wirft einen `Error`, der die Regel angibt, die der Eintrag brach. Zum Beispiel wirft `skills: ["docs:*"]`:

476 476>

477```text theme={null}477> ```text theme={null}

478Invalid skill name "docs:*": wildcard-suffix names are not allowed; list each skill by its exact name.478> Invalid skill name "docs:*": wildcard-suffix names are not allowed; list each skill by its exact name.

479```479> ```

480 480>

481Ein leerer Name meldet `Skill names must be non-empty strings.`481> Ein leerer Name meldet `Skill names must be non-empty strings.`

482 482>

483Vor TypeScript Agent SDK 0.3.221 führte das SDK diese Überprüfung nicht durch.483> Vor TypeScript Agent SDK 0.3.221 führte das SDK diese Überprüfung nicht durch.

484 

485**Python**

486 

487Das Python SDK wirft `ValueError`, das die Regel angibt, die der Eintrag brach. Zum Beispiel wirft `skills=["docs:*"]`:

488 

489```text theme={null}

490ValueError: Invalid skill name 'docs:*': wildcard-suffix names are not allowed; list each skill by its exact name.

491```

492 

493Ein leerer Name meldet `Skill names must be non-empty strings`.

494 484 

495Vor Python Agent SDK 0.2.129 führte das SDK diese Überprüfung nicht durch.485> [tab] Python

486>

487> Das Python SDK wirft `ValueError`, das die Regel angibt, die der Eintrag brach. Zum Beispiel wirft `skills=["docs:*"]`:

488>

489> ```text theme={null}

490> ValueError: Invalid skill name 'docs:*': wildcard-suffix names are not allowed; list each skill by its exact name.

491> ```

492>

493> Ein leerer Name meldet `Skill names must be non-empty strings`.

494>

495> Vor Python Agent SDK 0.2.129 führte das SDK diese Überprüfung nicht durch.

496 496 

497### Zusätzliche Fehlerbehebung497### Zusätzliche Fehlerbehebung

498 498 

16 16 

17Stellen Sie sich eine Rezept-App vor, bei der ein Agent das Web durchsucht und Rezepte zurückbringt. Ohne strukturierte Ausgaben erhalten Sie freien Text, den Sie selbst analysieren müssten. Mit strukturierten Ausgaben definieren Sie die gewünschte Form und erhalten typisierte Daten, die Sie direkt in Ihrer App verwenden können.17Stellen Sie sich eine Rezept-App vor, bei der ein Agent das Web durchsucht und Rezepte zurückbringt. Ohne strukturierte Ausgaben erhalten Sie freien Text, den Sie selbst analysieren müssten. Mit strukturierten Ausgaben definieren Sie die gewünschte Form und erhalten typisierte Daten, die Sie direkt in Ihrer App verwenden können.

18 18 

19> **Ohne strukturierte Ausgaben**19> [accordion] Ohne strukturierte Ausgaben

20>20>

21> ```text theme={null}21> ```text theme={null}

22> Hier ist ein klassisches Rezept für Schokoladenchip-Kekse!22> Hier ist ein klassisches Rezept für Schokoladenchip-Kekse!

32>32>

33> Um dies in Ihrer App zu verwenden, müssten Sie den Titel extrahieren, '15 Minuten" in eine Zahl umwandeln, Zutaten von Anweisungen trennen und mit inkonsistenter Formatierung über Antworten hinweg umgehen.33> Um dies in Ihrer App zu verwenden, müssten Sie den Titel extrahieren, '15 Minuten" in eine Zahl umwandeln, Zutaten von Anweisungen trennen und mit inkonsistenter Formatierung über Antworten hinweg umgehen.

34 34 

35> **Mit strukturierten Ausgaben**35> [accordion] Mit strukturierten Ausgaben

36>36>

37> ```jsonc theme={null}37> ```jsonc theme={null}

38> {38> {

225 225 

226Die `ask_user`- und `askUser`-Hilfsfunktionen in den folgenden Snippets stehen für die eigene Eingabeaufforderungs-UI Ihrer Anwendung.226Die `ask_user`- und `askUser`-Hilfsfunktionen in den folgenden Snippets stehen für die eigene Eingabeaufforderungs-UI Ihrer Anwendung.

227 227 

228**Genehmigen**228> [tab] Genehmigen

229 229>

230Der Benutzer genehmigt die Aktion unverändert. Geben Sie die `input` aus Ihrem Callback unverändert durch und das Tool wird genau wie von Claude angefordert ausgeführt.230> Der Benutzer genehmigt die Aktion unverändert. Geben Sie die `input` aus Ihrem Callback unverändert durch und das Tool wird genau wie von Claude angefordert ausgeführt.

231 231>

232```python Python theme={null}232> ```python Python theme={null}

233async def can_use_tool(tool_name, input_data, context):233> async def can_use_tool(tool_name, input_data, context):

234 print(f"Claude wants to use {tool_name}")234> print(f"Claude wants to use {tool_name}")

235 approved = await ask_user("Allow this action?")235> approved = await ask_user("Allow this action?")

236 236>

237 if approved:237> if approved:

238 return PermissionResultAllow(updated_input=input_data)238> return PermissionResultAllow(updated_input=input_data)

239 return PermissionResultDeny(message="User declined")239> return PermissionResultDeny(message="User declined")

240```240> ```

241 241>

242```typescript TypeScript theme={null}242> ```typescript TypeScript theme={null}

243canUseTool: async (toolName, input) => {243> canUseTool: async (toolName, input) => {

244 console.log(`Claude wants to use ${toolName}`);244> console.log(`Claude wants to use ${toolName}`);

245 const approved = await askUser("Allow this action?");245> const approved = await askUser("Allow this action?");

246 246>

247 if (approved) {247> if (approved) {

248 return { behavior: "allow", updatedInput: input };248> return { behavior: "allow", updatedInput: input };

249 }249> }

250 return { behavior: "deny", message: "User declined" };250> return { behavior: "deny", message: "User declined" };

251};251> };

252```252> ```

253 253 

254**Mit Änderungen genehmigen**254> [tab] Mit Änderungen genehmigen

255 255>

256Der Benutzer genehmigt, möchte aber die Anfrage zuerst ändern. Sie können die Eingabe vor der Tool-Ausführung ändern. Claude sieht das Ergebnis, wird aber nicht darüber informiert, dass Sie etwas geändert haben. Nützlich zum Bereinigen von Parametern, zum Hinzufügen von Einschränkungen oder zum Einschränken des Zugriffs.256> Der Benutzer genehmigt, möchte aber die Anfrage zuerst ändern. Sie können die Eingabe vor der Tool-Ausführung ändern. Claude sieht das Ergebnis, wird aber nicht darüber informiert, dass Sie etwas geändert haben. Nützlich zum Bereinigen von Parametern, zum Hinzufügen von Einschränkungen oder zum Einschränken des Zugriffs.

257 257>

258```python Python theme={null}258> ```python Python theme={null}

259async def can_use_tool(tool_name, input_data, context):259> async def can_use_tool(tool_name, input_data, context):

260 if tool_name == "Bash":260> if tool_name == "Bash":

261 # Benutzer genehmigt, aber alle Befehle auf Sandbox beschränken261> # Benutzer genehmigt, aber alle Befehle auf Sandbox beschränken

262 sandboxed_input = {**input_data}262> sandboxed_input = {**input_data}

263 sandboxed_input["command"] = input_data["command"].replace(263> sandboxed_input["command"] = input_data["command"].replace(

264 "/tmp", "/tmp/sandbox"264> "/tmp", "/tmp/sandbox"

265 )265> )

266 return PermissionResultAllow(updated_input=sandboxed_input)266> return PermissionResultAllow(updated_input=sandboxed_input)

267 return PermissionResultAllow(updated_input=input_data)267> return PermissionResultAllow(updated_input=input_data)

268```268> ```

269 269>

270```typescript TypeScript theme={null}270> ```typescript TypeScript theme={null}

271canUseTool: async (toolName, input) => {271> canUseTool: async (toolName, input) => {

272 if (toolName === "Bash") {272> if (toolName === "Bash") {

273 // Benutzer genehmigt, aber alle Befehle auf Sandbox beschränken273> // Benutzer genehmigt, aber alle Befehle auf Sandbox beschränken

274 const sandboxedInput = {274> const sandboxedInput = {

275 ...input,275> ...input,

276 command: input.command.replace("/tmp", "/tmp/sandbox")276> command: input.command.replace("/tmp", "/tmp/sandbox")

277 };277> };

278 return { behavior: "allow", updatedInput: sandboxedInput };278> return { behavior: "allow", updatedInput: sandboxedInput };

279 }279> }

280 return { behavior: "allow", updatedInput: input };280> return { behavior: "allow", updatedInput: input };

281};281> };

282```282> ```

283 283 

284**Genehmigen und merken**284> [tab] Genehmigen und merken

285 285>

286Der Benutzer genehmigt und möchte nicht erneut gefragt werden für diese Art von Aufruf. Das dritte Callback-Argument enthält `suggestions`, ein Array von vorgefertigten [`PermissionUpdate`](https://code.claude.com/docs/de/agent-sdk/typescript#permissionupdate)-Einträgen. Geben Sie einen in `updatedPermissions` zurück, um ihn anzuwenden. Ein Vorschlag mit dem `localSettings`-Ziel schreibt die Regel in `.claude/settings.local.json`, damit zukünftige Sitzungen die Aufforderung für übereinstimmende Aufrufe überspringen.286> Der Benutzer genehmigt und möchte nicht erneut gefragt werden für diese Art von Aufruf. Das dritte Callback-Argument enthält `suggestions`, ein Array von vorgefertigten [`PermissionUpdate`](https://code.claude.com/docs/de/agent-sdk/typescript#permissionupdate)-Einträgen. Geben Sie einen in `updatedPermissions` zurück, um ihn anzuwenden. Ein Vorschlag mit dem `localSettings`-Ziel schreibt die Regel in `.claude/settings.local.json`, damit zukünftige Sitzungen die Aufforderung für übereinstimmende Aufrufe überspringen.

287 287>

288In TypeScript überspringen Sie die Wahl „Immer zulassen“ für eine Anfrage, deren Optionen [`suppressAlwaysAllowRule: true`](https://code.claude.com/docs/de/agent-sdk/typescript#canusetool) enthalten. Der Hinweis erfordert Agent SDK v0.3.268 oder später, und der Python-`context` enthält ihn nicht.288> In TypeScript überspringen Sie die Wahl „Immer zulassen“ für eine Anfrage, deren Optionen [`suppressAlwaysAllowRule: true`](https://code.claude.com/docs/de/agent-sdk/typescript#canusetool) enthalten. Der Hinweis erfordert Agent SDK v0.3.268 oder später, und der Python-`context` enthält ihn nicht.

289 289>

290Das Python-Beispiel erfordert `claude-agent-sdk` 0.1.80 oder später.290> Das Python-Beispiel erfordert `claude-agent-sdk` 0.1.80 oder später.

291 291>

292```python Python theme={null}292> ```python Python theme={null}

293async def can_use_tool(tool_name, input_data, context):293> async def can_use_tool(tool_name, input_data, context):

294 choice = await ask_user(f"Allow {tool_name}?", ["once", "always", "no"])294> choice = await ask_user(f"Allow {tool_name}?", ["once", "always", "no"])

295 295>

296 if choice == "always":296> if choice == "always":

297 persist = [297> persist = [

298 s for s in context.suggestions if s.destination == "localSettings"298> s for s in context.suggestions if s.destination == "localSettings"

299 ]299> ]

300 return PermissionResultAllow(300> return PermissionResultAllow(

301 updated_input=input_data, updated_permissions=persist301> updated_input=input_data, updated_permissions=persist

302 )302> )

303 if choice == "once":303> if choice == "once":

304 return PermissionResultAllow(updated_input=input_data)304> return PermissionResultAllow(updated_input=input_data)

305 return PermissionResultDeny(message="User declined")305> return PermissionResultDeny(message="User declined")

306```306> ```

307 307>

308```typescript TypeScript theme={null}308> ```typescript TypeScript theme={null}

309canUseTool: async (toolName, input, { suggestions = [] }) => {309> canUseTool: async (toolName, input, { suggestions = [] }) => {

310 const choice = await askUser(`Allow ${toolName}?`, ["once", "always", "no"]);310> const choice = await askUser(`Allow ${toolName}?`, ["once", "always", "no"]);

311 311>

312 if (choice === "always") {312> if (choice === "always") {

313 const persist = suggestions.filter(313> const persist = suggestions.filter(

314 (s) => s.destination === "localSettings"314> (s) => s.destination === "localSettings"

315 );315> );

316 return {316> return {

317 behavior: "allow",317> behavior: "allow",

318 updatedInput: input,318> updatedInput: input,

319 updatedPermissions: persist319> updatedPermissions: persist

320 };320> };

321 }321> }

322 if (choice === "once") {322> if (choice === "once") {

323 return { behavior: "allow", updatedInput: input };323> return { behavior: "allow", updatedInput: input };

324 }324> }

325 return { behavior: "deny", message: "User declined" };325> return { behavior: "deny", message: "User declined" };

326};326> };

327```327> ```

328 328 

329**Ablehnen**329> [tab] Ablehnen

330 330>

331Der Benutzer möchte nicht, dass diese Aktion stattfindet. Blockieren Sie das Tool und geben Sie eine Nachricht an, die erklärt, warum. Claude sieht diese Nachricht und kann einen anderen Ansatz versuchen.331> Der Benutzer möchte nicht, dass diese Aktion stattfindet. Blockieren Sie das Tool und geben Sie eine Nachricht an, die erklärt, warum. Claude sieht diese Nachricht und kann einen anderen Ansatz versuchen.

332 332>

333```python Python theme={null}333> ```python Python theme={null}

334async def can_use_tool(tool_name, input_data, context):334> async def can_use_tool(tool_name, input_data, context):

335 approved = await ask_user(f"Allow {tool_name}?")335> approved = await ask_user(f"Allow {tool_name}?")

336 336>

337 if not approved:337> if not approved:

338 return PermissionResultDeny(message="User rejected this action")338> return PermissionResultDeny(message="User rejected this action")

339 return PermissionResultAllow(updated_input=input_data)339> return PermissionResultAllow(updated_input=input_data)

340```340> ```

341 341>

342```typescript TypeScript theme={null}342> ```typescript TypeScript theme={null}

343canUseTool: async (toolName, input) => {343> canUseTool: async (toolName, input) => {

344 const approved = await askUser(`Allow ${toolName}?`);344> const approved = await askUser(`Allow ${toolName}?`);

345 345>

346 if (!approved) {346> if (!approved) {

347 return {347> return {

348 behavior: "deny",348> behavior: "deny",

349 message: "User rejected this action"349> message: "User rejected this action"

350 };350> };

351 }351> }

352 return { behavior: "allow", updatedInput: input };352> return { behavior: "allow", updatedInput: input };

353};353> };

354```354> ```

355 355 

356**Alternative vorschlagen**356> [tab] Alternative vorschlagen

357 357>

358Der Benutzer möchte diese spezifische Aktion nicht, hat aber eine andere Idee. Blockieren Sie das Tool und fügen Sie Anleitung in Ihre Nachricht ein. Claude wird dies lesen und basierend auf Ihrem Feedback entscheiden, wie er vorgehen soll.358> Der Benutzer möchte diese spezifische Aktion nicht, hat aber eine andere Idee. Blockieren Sie das Tool und fügen Sie Anleitung in Ihre Nachricht ein. Claude wird dies lesen und basierend auf Ihrem Feedback entscheiden, wie er vorgehen soll.

359 359>

360```python Python theme={null}360> ```python Python theme={null}

361async def can_use_tool(tool_name, input_data, context):361> async def can_use_tool(tool_name, input_data, context):

362 if tool_name == "Bash" and "rm" in input_data.get("command", ""):362> if tool_name == "Bash" and "rm" in input_data.get("command", ""):

363 # Benutzer möchte nicht löschen, schlagen Sie stattdessen Archivierung vor363> # Benutzer möchte nicht löschen, schlagen Sie stattdessen Archivierung vor

364 return PermissionResultDeny(364> return PermissionResultDeny(

365 message="User doesn't want to delete files. They asked if you could compress them into an archive instead."365> message="User doesn't want to delete files. They asked if you could compress them into an archive instead."

366 )366> )

367 return PermissionResultAllow(updated_input=input_data)367> return PermissionResultAllow(updated_input=input_data)

368```368> ```

369 369>

370```typescript TypeScript theme={null}370> ```typescript TypeScript theme={null}

371canUseTool: async (toolName, input) => {371> canUseTool: async (toolName, input) => {

372 if (toolName === "Bash" && input.command.includes("rm")) {372> if (toolName === "Bash" && input.command.includes("rm")) {

373 // Benutzer möchte nicht löschen, schlagen Sie stattdessen Archivierung vor373> // Benutzer möchte nicht löschen, schlagen Sie stattdessen Archivierung vor

374 return {374> return {

375 behavior: "deny",375> behavior: "deny",

376 message:376> message:

377 "User doesn't want to delete files. They asked if you could compress them into an archive instead."377> "User doesn't want to delete files. They asked if you could compress them into an archive instead."

378 };378> };

379 }379> }

380 return { behavior: "allow", updatedInput: input };380> return { behavior: "allow", updatedInput: input };

381};381> };

382```382> ```

383 383 

384**Vollständig umleiten**384> [tab] Vollständig umleiten

385 385>

386Für eine vollständige Richtungsänderung (nicht nur einen Anstoß) verwenden Sie [Streaming-Eingabe](https://code.claude.com/docs/de/agent-sdk/streaming-vs-single-mode.md), um Claude eine neue Anweisung direkt zu senden. Dies umgeht die aktuelle Tool-Anfrage und gibt Claude völlig neue Anweisungen zum Befolgen.386> Für eine vollständige Richtungsänderung (nicht nur einen Anstoß) verwenden Sie [Streaming-Eingabe](https://code.claude.com/docs/de/agent-sdk/streaming-vs-single-mode.md), um Claude eine neue Anweisung direkt zu senden. Dies umgeht die aktuelle Tool-Anfrage und gibt Claude völlig neue Anweisungen zum Befolgen.

387 387 

388## Klärungsfragen verarbeiten388## Klärungsfragen verarbeiten

389 389 

13| [Subagenten](https://code.claude.com/docs/de/sub-agents.md) | Delegierte Mitarbeiter in einer Sitzung, die eine Nebenaufgabe in ihrem eigenen Kontext ausführen und eine Zusammenfassung zurückgeben | Eine Nebenaufgabe würde Ihre Hauptkonversation mit Suchergebnissen, Protokollen oder Dateiinhalten überfluten, auf die Sie nicht mehr verweisen werden |13| [Subagenten](https://code.claude.com/docs/de/sub-agents.md) | Delegierte Mitarbeiter in einer Sitzung, die eine Nebenaufgabe in ihrem eigenen Kontext ausführen und eine Zusammenfassung zurückgeben | Eine Nebenaufgabe würde Ihre Hauptkonversation mit Suchergebnissen, Protokollen oder Dateiinhalten überfluten, auf die Sie nicht mehr verweisen werden |

14| [Agent-Ansicht](https://code.claude.com/docs/de/agent-view.md) | Ein Bildschirm zum Versenden und Überwachen von Sitzungen, die im Hintergrund ausgeführt werden, geöffnet mit `claude agents`. Forschungsvorschau | Sie haben mehrere unabhängige Aufgaben und möchten diese delegieren, den Status auf einen Blick überprüfen und nur eingreifen, wenn eine Aufgabe Sie benötigt |14| [Agent-Ansicht](https://code.claude.com/docs/de/agent-view.md) | Ein Bildschirm zum Versenden und Überwachen von Sitzungen, die im Hintergrund ausgeführt werden, geöffnet mit `claude agents`. Forschungsvorschau | Sie haben mehrere unabhängige Aufgaben und möchten diese delegieren, den Status auf einen Blick überprüfen und nur eingreifen, wenn eine Aufgabe Sie benötigt |

15| [Agent-Teams](https://code.claude.com/docs/de/agent-teams.md) | Mehrere koordinierte Sitzungen mit einer gemeinsamen Aufgabenliste und Messaging zwischen Agenten, verwaltet von einem Lead. Experimentell und standardmäßig deaktiviert | Sie möchten, dass Claude ein Projekt in Teile aufteilt, diese zuweist und die Mitarbeiter synchron hält |15| [Agent-Teams](https://code.claude.com/docs/de/agent-teams.md) | Mehrere koordinierte Sitzungen mit einer gemeinsamen Aufgabenliste und Messaging zwischen Agenten, verwaltet von einem Lead. Experimentell und standardmäßig deaktiviert | Sie möchten, dass Claude ein Projekt in Teile aufteilt, diese zuweist und die Mitarbeiter synchron hält |

16| [Projekte](https://code.claude.com/docs/de/claude-projects.md) | Eine laufende Konversation auf claude.ai/code oder in der Desktop-App. Claude startet parallele Sitzungen namens Threads in der Cloud oder, wenn Sie es anfordern, auf Ihrem Computer über Remote Control, gibt jedem die Anweisungen des Projekts und zeigt Ihnen, welche davon Ihre Aufmerksamkeit benötigen. Öffentliche Beta auf Pro und Max | Die Arbeit erstreckt sich über viele Aufgaben über Tage oder Wochen, sollte weiterlaufen, wenn Ihr Computer ausgeschaltet ist, und Sie möchten sie lieber einmal beschreiben, als jede Sitzung zu versenden und zu verfolgen |16| [Projekte](https://code.claude.com/docs/de/claude-projects.md) | Eine laufende Konversation auf claude.ai/code oder in der Desktop-App. Claude startet parallele Sitzungen namens Threads in der Cloud oder, wenn Sie es anfordern, auf Ihrem Computer über Remote Control. Es gibt jeder davon die Anweisungen des Projekts und zeigt Ihnen, welche davon Ihre Aufmerksamkeit benötigen. Öffentliche Beta auf Pro, Max und Ultra | Die Arbeit erstreckt sich über viele Aufgaben über Tage oder Wochen, sollte weiterlaufen, wenn Ihr Computer ausgeschaltet ist, und Sie möchten sie lieber einmal beschreiben, als jede Sitzung zu versenden und zu verfolgen |

17| [Dynamische Workflows](https://code.claude.com/docs/de/workflows.md) | Ein Skript, das viele Subagenten ausführt und deren Ergebnisse überprüft, für einen Job, der zu groß ist, um ihn in einem Durchgang zu koordinieren, oder der mehr als einen einzelnen Durchgang benötigt | Ein Job wächst über eine Handvoll Subagenten hinaus, oder Sie möchten, dass Ergebnisse gegeneinander überprüft werden: ein codebase-weites Audit, eine 500-Datei-Migration, überprüfte Recherche oder ein Plan, der aus mehreren Blickwinkeln entworfen wurde |17| [Dynamische Workflows](https://code.claude.com/docs/de/workflows.md) | Ein Skript, das viele Subagenten ausführt und deren Ergebnisse überprüft, für einen Job, der zu groß ist, um ihn in einem Durchgang zu koordinieren, oder der mehr als einen einzelnen Durchgang benötigt | Ein Job wächst über eine Handvoll Subagenten hinaus, oder Sie möchten, dass Ergebnisse gegeneinander überprüft werden: ein codebase-weites Audit, eine 500-Datei-Migration, überprüfte Recherche oder ein Plan, der aus mehreren Blickwinkeln entworfen wurde |

18 18 

19In jedem Ansatz sind die Mitarbeiter Claude-Sitzungen. Um ein anderes Tool einzubeziehen, stellen Sie es Claude als [MCP-Server](https://code.claude.com/docs/de/mcp.md) zur Verfügung.19In jedem Ansatz sind die Mitarbeiter Claude-Sitzungen. Um ein anderes Tool einzubeziehen, stellen Sie es Claude als [MCP-Server](https://code.claude.com/docs/de/mcp.md) zur Verfügung.

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> Artefakte sind auf Pro-, Max-, Team- und Enterprise-Plänen verfügbar und erfordern eine Sitzung, die mit [`/login`](https://code.claude.com/docs/de/setup#authenticate) angemeldet ist. Siehe [Verfügbarkeit](#availability) für die vollständige Liste der Anforderungen.11> Artefakte sind auf Pro-, Max-, Ultra-, Team- und Enterprise-Plänen verfügbar und erfordern eine Sitzung, die mit [`/login`](https://code.claude.com/docs/de/setup#authenticate) angemeldet ist. Siehe [Verfügbarkeit](#availability) für die vollständige Liste der Anforderungen.

12 12 

13Ein [Artefakt](https://claude.com/features/artifacts) ist eine Live-, interaktive Webseite, die Claude Code aus Ihrer Sitzung auf einer privaten URL auf claude.ai veröffentlicht. Sie öffnen sie in einem Browser, und sie wird aktualisiert, während die Sitzung fortgesetzt wird. Teilen Sie sie über die Kopfzeile der Seite, wenn jemand anderes sie auch sehen soll.13Ein [Artefakt](https://claude.com/features/artifacts) ist eine Live-, interaktive Webseite, die Claude Code aus Ihrer Sitzung auf einer privaten URL auf claude.ai veröffentlicht. Sie öffnen sie in einem Browser, und sie wird aktualisiert, während die Sitzung fortgesetzt wird. Teilen Sie sie über die Kopfzeile der Seite, wenn jemand anderes sie auch sehen soll.

14 14 

197 197 

198## Live-Daten mit MCP-Konnektoren abrufen198## Live-Daten mit MCP-Konnektoren abrufen

199 199 

200Ein Artefakt kann [MCP-Konnektoren](https://code.claude.com/docs/de/mcp.md#use-mcp-servers-from-claude-ai) jedes Mal aufrufen, wenn jemand es anzeigt, sodass die Seite aktuelle Daten anstelle eines Snapshots aus der Sitzung anzeigt, in der sie erstellt wurde. Konnektoraufrufe aus Artefakten sind in den Plänen Pro, Max, Team und Enterprise verfügbar und erfordern Claude Code v2.1.209 oder später. In früheren Versionen veröffentlicht Claude die Seite mit den Daten, die die Sitzung während der Erstellung gesammelt hat.200Ein Artefakt kann [MCP-Konnektoren](https://code.claude.com/docs/de/mcp.md#use-mcp-servers-from-claude-ai) jedes Mal aufrufen, wenn jemand es anzeigt, sodass die Seite aktuelle Daten anstelle eines Snapshots aus der Sitzung anzeigt, in der sie erstellt wurde. Konnektoraufrufe aus Artefakten sind in den Plänen Pro, Max, Ultra, Team und Enterprise verfügbar und erfordern Claude Code v2.1.209 oder später. In früheren Versionen veröffentlicht Claude die Seite mit den Daten, die die Sitzung während der Erstellung gesammelt hat.

201 201 

202Um eine Konnektor-gestützte Seite zu erstellen, nennen Sie den Konnektor und die gewünschten Daten in Ihrer Eingabeaufforderung:202Um eine Konnektor-gestützte Seite zu erstellen, nennen Sie den Konnektor und die gewünschten Daten in Ihrer Eingabeaufforderung:

203 203 

314 314 

315> [!NOTE]315> [!NOTE]

316>316>

317> Vorlagen befinden sich in der Beta-Phase. Sie sind standardmäßig in Pro-, Max- und Team-Plänen aktiviert. Bei Enterprise-Plänen aktiviert ein Besitzer [jede Vorlage](https://support.claude.com/en/articles/16994751-artifacts-admin-guide-for-team-and-enterprise-plans) unter **Organisationseinstellungen > Artefakte**. Wenn Ihre Organisation die Slides-Vorlage deaktiviert hat, wird `/slides` nicht angezeigt; wenn sie die Design-Vorlage deaktiviert hat, entwirft `/design` keine Designs. Beide Befehle erfordern Claude Code v2.1.265 oder später und eine Sitzung, in der [Artefakte verfügbar sind](#availability).317> Vorlagen befinden sich in der Beta-Phase. Sie sind standardmäßig in Pro-, Max-, Ultra- und Team-Plänen aktiviert. Bei Enterprise-Plänen aktiviert ein Besitzer [jede Vorlage](https://support.claude.com/en/articles/16994751-artifacts-admin-guide-for-team-and-enterprise-plans) unter **Organisationseinstellungen > Artefakte**. Wenn Ihre Organisation die Slides-Vorlage deaktiviert hat, wird `/slides` nicht angezeigt; wenn sie die Design-Vorlage deaktiviert hat, entwirft `/design` keine Designs. Beide Befehle erfordern Claude Code v2.1.265 oder später und eine Sitzung, in der [Artefakte verfügbar sind](#availability).

318 318 

319### Erstellen Sie ein Slide-Deck319### Erstellen Sie ein Slide-Deck

320 320 

368 368 

369| Anforderung | Verfügbar wenn |369| Anforderung | Verfügbar wenn |

370| :- | :- |370| :- | :- |

371| Plan | Pro, Max, Team oder Enterprise. Bei Pro- und Max-Plänen sind Artefakte privat für Sie, bis Sie sie freigeben, und es gilt keine Admin-Verwaltung. Bei Team- und Enterprise-Plänen sind Artefakte standardmäßig aktiviert, und ein Owner kann [sie für die Organisation deaktivieren](#manage-artifacts-for-your-organization) in den claude.ai-Admin-Einstellungen. |371| Plan | Pro, Max, Ultra, Team oder Enterprise. Bei Pro-, Max- und Ultra-Plänen sind Artefakte privat für Sie, bis Sie sie freigeben, und es gilt keine Admin-Verwaltung. Bei Team- und Enterprise-Plänen sind Artefakte standardmäßig aktiviert, und ein Owner kann [sie für die Organisation deaktivieren](#manage-artifacts-for-your-organization) in den claude.ai-Admin-Einstellungen. |

372| Authentifizierung | Die Sitzung wird durch ein claude.ai-Konto unterstützt: Melden Sie sich mit `/login` in der CLI oder Desktop-App an. Claude Tag-Sitzungen benötigen keinen Anmeldeschritt. Sitzungen, die einen API-Schlüssel, [Gateway-Token](https://code.claude.com/docs/de/llm-gateway) oder Cloud-Provider-Anmeldedaten verwenden, können nicht veröffentlichen. |372| Authentifizierung | Die Sitzung wird durch ein claude.ai-Konto unterstützt: Melden Sie sich mit `/login` in der CLI oder Desktop-App an. Claude Tag-Sitzungen benötigen keinen Anmeldeschritt. Sitzungen, die einen API-Schlüssel, [Gateway-Token](https://code.claude.com/docs/de/llm-gateway) oder Cloud-Provider-Anmeldedaten verwenden, können nicht veröffentlichen. |

373| Modell-Provider | Anthropic API. Nicht verfügbar auf [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md) oder [Microsoft Foundry](https://code.claude.com/docs/de/microsoft-foundry.md). |373| Modell-Provider | Anthropic API. Nicht verfügbar auf [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md) oder [Microsoft Foundry](https://code.claude.com/docs/de/microsoft-foundry.md). |

374| Organisationsrichtlinie | Customer-managed encryption keys (CMEK), HIPAA und [Zero Data Retention](https://code.claude.com/docs/de/zero-data-retention.md) sind nicht für die Organisation aktiviert. |374| Organisationsrichtlinie | Customer-managed encryption keys (CMEK), HIPAA und [Zero Data Retention](https://code.claude.com/docs/de/zero-data-retention.md) sind nicht für die Organisation aktiviert. |

23 23 

24Sie können sich mit einem dieser Kontotypen authentifizieren:24Sie können sich mit einem dieser Kontotypen authentifizieren:

25 25 

26* **Claude Pro oder Max Abonnement**: Melden Sie sich mit Ihrem claude.ai-Konto an. Abonnieren Sie unter [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).26* **Claude Pro-, Max- oder Ultra-Abonnement**: Melden Sie sich mit Ihrem claude.ai-Konto an. Abonnieren Sie unter [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).

27* **Claude for Teams oder Enterprise**: Melden Sie sich mit dem claude.ai-Konto an, zu dem Sie Ihr Team-Administrator eingeladen hat.27* **Claude for Teams oder Enterprise**: Melden Sie sich mit dem claude.ai-Konto an, zu dem Sie Ihr Team-Administrator eingeladen hat.

28* **Claude Console**: Melden Sie sich mit Ihren Console-Anmeldedaten an. Ihr Administrator muss Sie zunächst [eingeladen haben](#claude-console-authentication). Sie können sich mit oder ohne [Erstellen eines API-Schlüssels](#sign-in-without-an-api-key) anmelden.28* **Claude Console**: Melden Sie sich mit Ihren Console-Anmeldedaten an. Ihr Administrator muss Sie zunächst [eingeladen haben](#claude-console-authentication). Sie können sich mit oder ohne [Erstellen eines API-Schlüssels](#sign-in-without-an-api-key) anmelden.

29* **Cloud-Anbieter**: Wenn Ihre Organisation [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md) oder [Microsoft Foundry](https://code.claude.com/docs/de/microsoft-foundry.md) verwendet, legen Sie die erforderlichen Umgebungsvariablen fest, bevor Sie `claude` ausführen, oder wählen Sie **3rd-party platform** bei der Anmeldeeingabeaufforderung aus, die einen interaktiven Setup-Assistenten für Bedrock und Vertex AI startet. Es ist keine Browser-Anmeldung erforderlich.29* **Cloud-Anbieter**: Wenn Ihre Organisation [Amazon Bedrock](https://code.claude.com/docs/de/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/de/google-vertex-ai.md) oder [Microsoft Foundry](https://code.claude.com/docs/de/microsoft-foundry.md) verwendet, legen Sie die erforderlichen Umgebungsvariablen fest, bevor Sie `claude` ausführen, oder wählen Sie **3rd-party platform** bei der Anmeldeeingabeaufforderung aus, die einen interaktiven Setup-Assistenten für Bedrock und Vertex AI startet. Es ist keine Browser-Anmeldung erforderlich.

2534. [`apiKeyHelper`](https://code.claude.com/docs/de/settings-reference#apikeyhelper) Skriptausgabe. Verwenden Sie dies für dynamische oder rotierende Anmeldedaten, wie kurzlebige Tokens, die aus einem Vault abgerufen werden.2534. [`apiKeyHelper`](https://code.claude.com/docs/de/settings-reference#apikeyhelper) Skriptausgabe. Verwenden Sie dies für dynamische oder rotierende Anmeldedaten, wie kurzlebige Tokens, die aus einem Vault abgerufen werden.

2545. `CLAUDE_CODE_OAUTH_TOKEN` Umgebungsvariable. Ein langlebiges OAuth-Token, das von [`claude setup-token`](#generate-a-long-lived-token) generiert wird. Verwenden Sie dies für CI-Pipelines und Skripte, bei denen Browser-Anmeldung nicht verfügbar ist. Wenn Sie `/login` ausführen, während die Variable gesetzt ist, wechselt Claude Code die aktuelle Sitzung zur neuen Anmeldung, liest die Variable aber in jeder neuen Sitzung erneut, bis Sie sie aus Ihrem Shell-Profil oder dem `env` Block einer [Einstellungsdatei](https://code.claude.com/docs/de/settings.md) entfernen.2545. `CLAUDE_CODE_OAUTH_TOKEN` Umgebungsvariable. Ein langlebiges OAuth-Token, das von [`claude setup-token`](#generate-a-long-lived-token) generiert wird. Verwenden Sie dies für CI-Pipelines und Skripte, bei denen Browser-Anmeldung nicht verfügbar ist. Wenn Sie `/login` ausführen, während die Variable gesetzt ist, wechselt Claude Code die aktuelle Sitzung zur neuen Anmeldung, liest die Variable aber in jeder neuen Sitzung erneut, bis Sie sie aus Ihrem Shell-Profil oder dem `env` Block einer [Einstellungsdatei](https://code.claude.com/docs/de/settings.md) entfernen.

2556. Anthropic-Profil und Verbundsanmeldedaten, die Anmeldedaten, die die `ant` CLI und Workload Identity Federation verwenden. Ein Profil, das `ant auth login` geschrieben hat, wird hier nur eingestuft, wenn Sie es in `ANTHROPIC_PROFILE` benennen; andernfalls wird es unter `/login` eingestuft. Siehe [Anthropic-Profile und Verbundsanmeldedaten](#anthropic-profiles-and-federation-credentials).2556. Anthropic-Profil und Verbundsanmeldedaten, die Anmeldedaten, die die `ant` CLI und Workload Identity Federation verwenden. Ein Profil, das `ant auth login` geschrieben hat, wird hier nur eingestuft, wenn Sie es in `ANTHROPIC_PROFILE` benennen; andernfalls wird es unter `/login` eingestuft. Siehe [Anthropic-Profile und Verbundsanmeldedaten](#anthropic-profiles-and-federation-credentials).

2567. Abonnement-OAuth-Anmeldedaten von `/login`. Dies ist die Standardeinstellung für Claude Pro, Max, Team und Enterprise-Benutzer.2567. Abonnement-OAuth-Anmeldedaten von `/login`. Dies ist die Standardeinstellung für Claude Pro, Max, Ultra, Team und Enterprise-Benutzer.

257 257 

258Eine angemeldete [Claude Apps Gateway](https://code.claude.com/docs/de/claude-apps-gateway) Sitzung steht außerhalb dieser Liste: Sie ist eine Anbieterauswahl wie Amazon Bedrock oder Google Cloud's Agent Platform und hat Vorrang vor ihnen. Wenn eine Gateway-Sitzung vorhanden ist, authentifiziert sich die CLI mit dem Gateway-Token, auch wenn `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` oder `CLAUDE_CODE_USE_FOUNDRY` gesetzt ist, und Anmeldequellen oben wie der Bearer-Token, API-Schlüssel, `apiKeyHelper` und Profile werden nicht verwendet.258Eine angemeldete [Claude Apps Gateway](https://code.claude.com/docs/de/claude-apps-gateway) Sitzung steht außerhalb dieser Liste: Sie ist eine Anbieterauswahl wie Amazon Bedrock oder Google Cloud's Agent Platform und hat Vorrang vor ihnen. Wenn eine Gateway-Sitzung vorhanden ist, authentifiziert sich die CLI mit dem Gateway-Token, auch wenn `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` oder `CLAUDE_CODE_USE_FOUNDRY` gesetzt ist, und Anmeldequellen oben wie der Bearer-Token, API-Schlüssel, `apiKeyHelper` und Profile werden nicht verwendet.

259 259 

300 300 

301Der Befehl öffnet den gleichen Browser-Autorisierungsfluss wie `/login`, und das Token wird im Terminal ausgegeben, nachdem Sie den Zugriff im Browser genehmigt haben. Es speichert das Token nirgendwo; kopieren Sie es und legen Sie es als `CLAUDE_CODE_OAUTH_TOKEN` Umgebungsvariable überall dort fest, wo Sie sich authentifizieren möchten:301Der Befehl öffnet den gleichen Browser-Autorisierungsfluss wie `/login`, und das Token wird im Terminal ausgegeben, nachdem Sie den Zugriff im Browser genehmigt haben. Es speichert das Token nirgendwo; kopieren Sie es und legen Sie es als `CLAUDE_CODE_OAUTH_TOKEN` Umgebungsvariable überall dort fest, wo Sie sich authentifizieren möchten:

302 302 

303**macOS, Linux, WSL**303> [tab] macOS, Linux, WSL

304 304>

305```bash theme={null}305> ```bash theme={null}

306export CLAUDE_CODE_OAUTH_TOKEN=your-token306> export CLAUDE_CODE_OAUTH_TOKEN=your-token

307```307> ```

308 308 

309**Windows PowerShell**309> [tab] Windows PowerShell

310 310>

311```powershell theme={null}311> ```powershell theme={null}

312$env:CLAUDE_CODE_OAUTH_TOKEN = "your-token"312> $env:CLAUDE_CODE_OAUTH_TOKEN = "your-token"

313```313> ```

314 314 

315**Windows CMD**315> [tab] Windows CMD

316 316>

317```batch theme={null}317> ```batch theme={null}

318set CLAUDE_CODE_OAUTH_TOKEN=your-token318> set CLAUDE_CODE_OAUTH_TOKEN=your-token

319```319> ```

320 320 

321Dieses Token authentifiziert sich mit Ihrem Claude-Abonnement und erfordert einen Pro-, Max-, Team- oder Enterprise-Plan. Es kann nur Modellanfragen stellen, daher kann es keine [Remote Control](https://code.claude.com/docs/de/remote-control.md) Sitzungen einrichten oder [claude.ai Konnektoren](https://code.claude.com/docs/de/mcp.md#use-mcp-servers-from-claude-ai) abrufen. MCP-Server, die Sie lokal konfigurieren, funktionieren weiterhin.321Dieses Token authentifiziert sich mit Ihrem Claude-Abonnement und erfordert einen Pro-, Max-, Ultra-, Team- oder Enterprise-Plan. Es kann nur Modellanfragen stellen, daher kann es keine [Remote Control](https://code.claude.com/docs/de/remote-control.md) Sitzungen einrichten oder [claude.ai Konnektoren](https://code.claude.com/docs/de/mcp.md#use-mcp-servers-from-claude-ai) abrufen. MCP-Server, die Sie lokal konfigurieren, funktionieren weiterhin.

322 322 

323[Bare Mode](https://code.claude.com/docs/de/headless.md#start-faster-with-bare-mode) liest `CLAUDE_CODE_OAUTH_TOKEN` nicht. Wenn Ihr Skript `--bare` übergibt, authentifizieren Sie sich stattdessen mit `ANTHROPIC_API_KEY` oder einem `apiKeyHelper`.323[Bare Mode](https://code.claude.com/docs/de/headless.md#start-faster-with-bare-mode) liest `CLAUDE_CODE_OAUTH_TOKEN` nicht. Wenn Ihr Skript `--bare` übergibt, authentifizieren Sie sich stattdessen mit `ANTHROPIC_API_KEY` oder einem `apiKeyHelper`.

43 43 

44## Warum der Dialog angezeigt wird44## Warum der Dialog angezeigt wird

45 45 

46[Server-seitige Classifier-Überprüfung](https://code.claude.com/docs/de/permission-modes.md#server-side-classifier-review) listet auf, welche Sitzungen den Server um Classifier-Überprüfungen bitten. Pro-, Max- und Team-Pläne zeigen den Dialog nie an. Wenn er angezeigt wird, sind die üblichen Ursachen:46Mit einem Pro-, Max-, Ultra- oder Team-Plan sehen Sie den Dialog nie. Welche Sitzungen den Server um die Klassifikator-Überprüfungen bitten, erfahren Sie unter [Server-seitige Klassifikator-Überprüfung](https://code.claude.com/docs/de/permission-modes.md#server-side-classifier-review). Wenn Sie den Dialog sehen, prüfen Sie diese üblichen Ursachen:

47 47 

48* **Ein LLM-Gateway oder Proxy befindet sich im Pfad**: eines, das Request-Header entfernt oder umschreibt, Request-Felder löscht, die es nicht erkennt, oder Antworten bearbeitet. Der Server erhält dann nie die Anfrage für Überprüfungen, oder Claude Code erhält die Ergebnisse nie. Wenn Ihre Konfiguration oder die Antworten das Gateway identifizieren, benennt der Dialog es.48* **Ein LLM-Gateway oder Proxy befindet sich im Pfad**: eines, das Request-Header entfernt oder umschreibt, Request-Felder löscht, die es nicht erkennt, oder Antworten bearbeitet. Der Server erhält dann nie die Anfrage für Überprüfungen, oder Claude Code erhält die Ergebnisse nie. Wenn Ihre Konfiguration oder die Antworten das Gateway identifizieren, benennt der Dialog es.

49* **Server-seitige Überprüfungen haben Ihre Plattform, Region oder Anmeldedaten noch nicht erreicht**: ob eine Plattform oder Region diese durchführt, hängt vom Rollout dieser Plattform ab. Wenn Sie den Dialog ohne Gateway oder Proxy im Pfad sehen und er wird immer wieder angezeigt, ist dies die wahrscheinliche Ursache. Um dies zu bestätigen, kontaktieren Sie den Support oder den Administrator Ihres Unternehmens, oder melden Sie es mit `/feedback`.49* **Server-seitige Überprüfungen haben Ihre Plattform, Region oder Anmeldedaten noch nicht erreicht**: ob eine Plattform oder Region diese durchführt, hängt vom Rollout dieser Plattform ab. Wenn Sie den Dialog ohne Gateway oder Proxy im Pfad sehen und er wird immer wieder angezeigt, ist dies die wahrscheinliche Ursache. Um dies zu bestätigen, kontaktieren Sie den Support oder den Administrator Ihres Unternehmens, oder melden Sie es mit `/feedback`.

161 161 

162> [!NOTE]162> [!NOTE]

163>163>

164> `/auto-mode-setup` ist in den Pro-, Max-, Team- und Enterprise-Plänen sowie mit einem Claude Console API-Schlüssel verfügbar. Mit einem Pro-, Max- oder Team-Plan benötigen Sie v2.1.228 oder höher bzw. v2.1.233 oder höher unter nativem Windows. Mit einem Enterprise-Plan oder einem Claude Console API-Schlüssel benötigen Sie v2.1.283 oder höher. Wenn der Befehl in Ihrer Sitzung fehlt, lesen Sie [`/auto-mode-setup` gibt „Unknown command“ zurück](#auto-mode-setup-returns-unknown-command).164> `/auto-mode-setup` ist in den Pro-, Max-, Ultra-, Team- und Enterprise-Plänen sowie mit einem Claude Console API-Schlüssel verfügbar. Mit einem Pro-, Max-, Ultra- oder Team-Plan benötigen Sie v2.1.228 oder höher bzw. v2.1.233 oder höher unter nativem Windows. Mit einem Enterprise-Plan oder einem Claude Console API-Schlüssel benötigen Sie v2.1.283 oder höher. Wenn der Befehl in Ihrer Sitzung fehlt, lesen Sie [`/auto-mode-setup` gibt „Unknown command“ zurück](#auto-mode-setup-returns-unknown-command).

165 165 

166### Was `/auto-mode-setup` liest166### Was `/auto-mode-setup` liest

167 167 

489 489 

490Mit einem Fenster von 1M Token bei den meisten aktuellen Modellen und einer Komprimierung nahe dessen Obergrenze geht Ihnen selten der Kontext aus. Sie können aber trotzdem für Kontext *bezahlen*, den Sie nicht brauchen. Jede Anfrage sendet die gesamte Konversation, sodass eine Sitzung, die drei unzusammenhängende Aufgaben angesammelt hat, bei jedem Turn der vierten alle drei erneut liest. Das ist [vergünstigt, solange der Cache warm ist](https://code.claude.com/docs/de/costs.md#why-usage-climbs-in-a-long-session), und kostet den vollen Preis, sobald er abläuft.490Mit einem Fenster von 1M Token bei den meisten aktuellen Modellen und einer Komprimierung nahe dessen Obergrenze geht Ihnen selten der Kontext aus. Sie können aber trotzdem für Kontext *bezahlen*, den Sie nicht brauchen. Jede Anfrage sendet die gesamte Konversation, sodass eine Sitzung, die drei unzusammenhängende Aufgaben angesammelt hat, bei jedem Turn der vierten alle drei erneut liest. Das ist [vergünstigt, solange der Cache warm ist](https://code.claude.com/docs/de/costs.md#why-usage-climbs-in-a-long-session), und kostet den vollen Preis, sobald er abläuft.

491 491 

492[`/usage`](https://code.claude.com/docs/de/costs) ist die erste Anlaufstelle. Bei Pro, Max, Team und Enterprise schlüsselt es Ihre Nutzung nach Skill, Subagent, Plugin und MCP-Server auf. Außerdem kennzeichnet es Muster wie langen Kontext oder häufige Cache-Misses, sobald eines davon 10 % Ihrer Nutzung überschreitet. Von dort aus die üblichen Lösungen:492[`/usage`](https://code.claude.com/docs/de/costs) ist die erste Anlaufstelle. Bei Pro, Max, Ultra, Team und Enterprise schlüsselt es Ihre Nutzung nach Skill, Subagent, Plugin und MCP-Server auf. Außerdem kennzeichnet es Muster wie langen Kontext oder häufige Cache-Misses, sobald eines davon 10 % Ihrer Nutzung überschreitet. Von dort aus die üblichen Lösungen:

493 493 

494* `/clear` zwischen unzusammenhängenden Aufgaben. Es kostet nichts und sorgt dafür, dass die nächste Aufgabe nicht weiter für den Verlauf der vorherigen bezahlt. `/clear oauth-migration` benennt die Sitzung, die Sie verlassen, damit Sie später zu ihr zurückkehren können.494* `/clear` zwischen unzusammenhängenden Aufgaben. Es kostet nichts und sorgt dafür, dass die nächste Aufgabe nicht weiter für den Verlauf der vorherigen bezahlt. `/clear oauth-migration` benennt die Sitzung, die Sie verlassen, damit Sie später zu ihr zurückkehren können.

495* `/compact` mit einem Fokus, etwa `/compact keep the API changes and the test commands`. In einer langen Sitzung ist `/compact` selbst eine große Anfrage, da es die gesamte Konversation liest, um sie zusammenzufassen, und das umso mehr, wenn der Cache abgelaufen ist.495* `/compact` mit einem Fokus, etwa `/compact keep the API changes and the test commands`. In einer langen Sitzung ist `/compact` selbst eine große Anfrage, da es die gesamte Konversation liest, um sie zusammenzufassen, und das umso mehr, wenn der Cache abgelaufen ist.

24 24 

25Jeder unterstützte Kanal ist ein Plugin, das [Bun](https://bun.sh) erfordert. Für eine praktische Demo des Plugin-Flows, bevor Sie eine echte Plattform verbinden, versuchen Sie die [fakechat-Schnellstart](#quickstart).25Jeder unterstützte Kanal ist ein Plugin, das [Bun](https://bun.sh) erfordert. Für eine praktische Demo des Plugin-Flows, bevor Sie eine echte Plattform verbinden, versuchen Sie die [fakechat-Schnellstart](#quickstart).

26 26 

27**Telegram**27> [tab] Telegram

28 

29Sehen Sie sich den vollständigen [Telegram-Plugin-Quellcode](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram) an.

30 

31**1. Erstellen Sie einen Telegram-Bot**

32 

33Öffnen Sie [BotFather](https://t.me/BotFather) in Telegram und senden Sie `/newbot`. Geben Sie ihm einen Anzeigenamen und einen eindeutigen Benutzernamen, der auf `bot` endet. Kopieren Sie das Token, das BotFather zurückgibt.

34 

35**2. Installieren Sie das Plugin**

36 

37Starten Sie Claude Code, indem Sie `claude` in Ihrem Terminal ausführen, und geben Sie dann Folgendes in das Eingabefeld ein:

38 

39```

40/plugin install telegram@claude-plugins-official

41```

42 

43Wenn die Installation fehlschlägt, stimmen Sie die Meldung ab, die Claude Code meldet:

44 

45* `Marketplace "claude-plugins-official" not found`: Fügen Sie den Marketplace mit `/plugin marketplace add anthropics/claude-plugins-official` hinzu und versuchen Sie dann die Installation erneut.

46* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: Ihre lokale Kopie des Marketplace-Katalogs ist möglicherweise veraltet. Aktualisieren Sie sie mit `/plugin marketplace update claude-plugins-official` und versuchen Sie dann die Installation erneut. Wenn der erneute Versuch dieselbe Meldung ausgibt, siehe [Plugin nicht im Marketplace gefunden](https://code.claude.com/docs/de/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

47 

48Wenn die Installation nach einem Geltungsbereich für die Installation fragt, wählen Sie die Option für den Benutzer-Geltungsbereich, damit das Plugin in allen Ihren Projekten verfügbar ist. Überprüfen Sie die Installationszusammenfassung: Wenn sie `Run /reload-plugins to apply.` meldet, siehe [Plugin-Änderungen ohne Neustart anwenden](https://code.claude.com/docs/de/plugins/cli-reference.md#reload-plugins), um den Konfigurationsbefehl des Plugins verfügbar zu machen.

49 

50**3. Konfigurieren Sie Ihr Token**

51 

52Führen Sie den Konfigurationsbefehl mit dem Token von BotFather aus:

53 

54```

55/telegram:configure <token>

56```

57 

58Dies speichert es in `~/.claude/channels/telegram/.env`. Sie können auch `TELEGRAM_BOT_TOKEN` in Ihrer Shell-Umgebung setzen, bevor Sie Claude Code starten.

59 

60**4. Starten Sie mit aktivierten Kanälen neu**

61 

62Beenden Sie Claude Code und starten Sie mit dem Kanal-Flag neu. Dies startet das Telegram-Plugin, das mit dem Abrufen von Nachrichten von Ihrem Bot beginnt:

63 

64```bash theme={null}

65claude --channels plugin:telegram@claude-plugins-official

66```

67 

68**5. Koppeln Sie Ihr Konto**

69 

70Öffnen Sie Telegram und senden Sie eine beliebige Nachricht an Ihren Bot. Der Bot antwortet mit einem Kopplungscode.

71 

72> [!NOTE]

73>28>

74> Wenn Ihr Bot nicht antwortet, stellen Sie sicher, dass Claude Code mit `--channels` aus dem vorherigen Schritt ausgeführt wird. Der Bot kann nur antworten, während der Kanal aktiv ist.29> Sehen Sie sich den vollständigen [Telegram-Plugin-Quellcode](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram) an.

75 

76Zurück in Claude Code führen Sie aus:

77 

78```

79/telegram:access pair <code>

80```

81 

82Dann sperren Sie den Zugriff, damit nur Ihr Konto Nachrichten senden kann:

83 

84```

85/telegram:access policy allowlist

86```

87 

88**Discord**

89 

90Sehen Sie sich den vollständigen [Discord-Plugin-Quellcode](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/discord) an.

91 

92**1. Erstellen Sie einen Discord-Bot**

93 

94Gehen Sie zum [Discord Developer Portal](https://discord.com/developers/applications), klicken Sie auf **New Application** und benennen Sie ihn. Im Abschnitt **Bot** erstellen Sie einen Benutzernamen, klicken dann auf **Reset Token** und kopieren das Token.

95 

96**2. Aktivieren Sie Message Content Intent**

97 

98In den Einstellungen Ihres Bots scrollen Sie zu **Privileged Gateway Intents** und aktivieren **Message Content Intent**.

99 

100**3. Laden Sie den Bot auf Ihren Server ein**

101 

102Gehen Sie zu **OAuth2 > URL Generator**. Wählen Sie den `bot`-Bereich und aktivieren Sie diese Berechtigungen:

103 

104* View Channels

105* Send Messages

106* Send Messages in Threads

107* Read Message History

108* Attach Files

109* Add Reactions

110 

111Öffnen Sie die generierte URL, um den Bot zu Ihrem Server hinzuzufügen.

112 

113**4. Installieren Sie das Plugin**

114 

115Starten Sie Claude Code, indem Sie `claude` in Ihrem Terminal ausführen, und geben Sie dann Folgendes in das Eingabefeld ein:

116 

117```

118/plugin install discord@claude-plugins-official

119```

120 

121Wenn die Installation fehlschlägt, stimmen Sie die Meldung ab, die Claude Code meldet:

122 

123* `Marketplace "claude-plugins-official" not found`: Fügen Sie den Marketplace mit `/plugin marketplace add anthropics/claude-plugins-official` hinzu und versuchen Sie dann die Installation erneut.

124* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: Ihre lokale Kopie des Marketplace-Katalogs ist möglicherweise veraltet. Aktualisieren Sie sie mit `/plugin marketplace update claude-plugins-official` und versuchen Sie dann die Installation erneut. Wenn der erneute Versuch dieselbe Meldung ausgibt, siehe [Plugin nicht im Marketplace gefunden](https://code.claude.com/docs/de/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

125 

126Wenn die Installation nach einem Geltungsbereich für die Installation fragt, wählen Sie die Option für den Benutzer-Geltungsbereich, damit das Plugin in allen Ihren Projekten verfügbar ist. Überprüfen Sie die Installationszusammenfassung: Wenn sie `Run /reload-plugins to apply.` meldet, siehe [Plugin-Änderungen ohne Neustart anwenden](https://code.claude.com/docs/de/plugins/cli-reference.md#reload-plugins), um den Konfigurationsbefehl des Plugins verfügbar zu machen.

127 

128**5. Konfigurieren Sie Ihr Token**

129 

130Führen Sie den Konfigurationsbefehl mit dem Bot-Token aus, das Sie kopiert haben:

131 

132```

133/discord:configure <token>

134```

135 

136Dies speichert es in `~/.claude/channels/discord/.env`. Sie können auch `DISCORD_BOT_TOKEN` in Ihrer Shell-Umgebung setzen, bevor Sie Claude Code starten.

137 

138**6. Starten Sie mit aktivierten Kanälen neu**

139 

140Beenden Sie Claude Code und starten Sie mit dem Kanal-Flag neu. Dies verbindet das Discord-Plugin, damit Ihr Bot Nachrichten empfangen und beantworten kann:

141 

142```bash theme={null}

143claude --channels plugin:discord@claude-plugins-official

144```

145 

146**7. Koppeln Sie Ihr Konto**

147 

148Schreiben Sie Ihrem Bot auf Discord eine Direktnachricht. Der Bot antwortet mit einem Kopplungscode.

149 

150> [!NOTE]

151>30>

152> Wenn Ihr Bot nicht antwortet, stellen Sie sicher, dass Claude Code mit `--channels` aus dem vorherigen Schritt ausgeführt wird. Der Bot kann nur antworten, während der Kanal aktiv ist.31> **1. Erstellen Sie einen Telegram-Bot**

153 

154Zurück in Claude Code führen Sie aus:

155 

156```

157/discord:access pair <code>

158```

159 

160Dann sperren Sie den Zugriff, damit nur Ihr Konto Nachrichten senden kann:

161 

162```

163/discord:access policy allowlist

164```

165 

166**iMessage**

167 

168Sehen Sie sich den vollständigen [iMessage-Plugin-Quellcode](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/imessage) an.

169 

170Der iMessage-Kanal liest Ihre Messages-Datenbank direkt und sendet Antworten über AppleScript. Er erfordert macOS und benötigt kein Bot-Token oder externen Service.

171 

172**1. Gewähren Sie vollständigen Festplattenzugriff**

173 

174Die Messages-Datenbank unter `~/Library/Messages/chat.db` ist durch macOS geschützt. Wenn der Server sie zum ersten Mal liest, fordert macOS Zugriff an: klicken Sie auf **Allow**. Die Aufforderung nennt die App, die Bun gestartet hat, wie Terminal, iTerm oder Ihre IDE.

175 

176Wenn die Abfrage nicht angezeigt wird oder Sie auf „Don't Allow“ geklickt haben, gewähren Sie den Zugriff manuell unter **System Settings > Privacy & Security > Full Disk Access** und fügen Sie Ihr Terminal hinzu. Ohne dies beendet sich der Server sofort mit `authorization denied`.

177 

178**2. Installieren Sie das Plugin**

179 

180Starten Sie Claude Code, indem Sie `claude` in Ihrem Terminal ausführen, und geben Sie dann Folgendes in das Eingabefeld ein:

181 

182```

183/plugin install imessage@claude-plugins-official

184```

185 

186Wenn die Installation fehlschlägt, stimmen Sie die Meldung ab, die Claude Code meldet:

187 

188* `Marketplace "claude-plugins-official" not found`: Fügen Sie den Marketplace mit `/plugin marketplace add anthropics/claude-plugins-official` hinzu und versuchen Sie dann die Installation erneut.

189* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: Ihre lokale Kopie des Marketplace-Katalogs ist möglicherweise veraltet. Aktualisieren Sie sie mit `/plugin marketplace update claude-plugins-official` und versuchen Sie dann die Installation erneut. Wenn der erneute Versuch dieselbe Meldung ausgibt, siehe [Plugin nicht im Marketplace gefunden](https://code.claude.com/docs/de/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

190 

191Wenn die Installation nach einem Geltungsbereich für die Installation fragt, wählen Sie die Option für den Benutzer-Geltungsbereich, damit das Plugin in allen Ihren Projekten verfügbar ist.

192 

193Wenn die Installationszusammenfassung `Run /reload-plugins to apply.` meldet, müssen Sie hier nichts unternehmen, da der Neustart im nächsten Schritt das Plugin lädt.

194 

195**3. Starten Sie mit aktivierten Channels neu**

196 

197Beenden Sie Claude Code und starten Sie mit dem Channel-Flag neu:

198 

199```bash theme={null}

200claude --channels plugin:imessage@claude-plugins-official

201```

202 

203**4. Schreiben Sie sich selbst**

204 

205Öffnen Sie Messages auf einem beliebigen Gerät, das in Ihrer Apple ID angemeldet ist, und senden Sie sich selbst eine Nachricht. Sie erreicht Claude sofort: Self-Chat umgeht die Zugriffskontrolle ohne Setup.

206 

207> [!NOTE]

208>32>

209> Die erste Antwort, die Claude sendet, löst eine macOS-Automatisierungsaufforderung aus, die fragt, ob Ihr Terminal Messages steuern kann. Klicken Sie auf **OK**.33> Öffnen Sie [BotFather](https://t.me/BotFather) in Telegram und senden Sie `/newbot`. Geben Sie ihm einen Anzeigenamen und einen eindeutigen Benutzernamen, der auf `bot` endet. Kopieren Sie das Token, das BotFather zurückgibt.

210 34>

211**5. Erlauben Sie anderen Absendern**35> **2. Installieren Sie das Plugin**

212 36>

213Standardmäßig passieren nur Ihre eigenen Nachrichten durch. Um einem anderen Kontakt zu ermöglichen, Claude zu erreichen, fügen Sie seinen Handle hinzu:37> Starten Sie Claude Code, indem Sie `claude` in Ihrem Terminal ausführen, und geben Sie dann Folgendes in das Eingabefeld ein:

38>

39> ```

40> /plugin install telegram@claude-plugins-official

41> ```

42>

43> Wenn die Installation fehlschlägt, stimmen Sie die Meldung ab, die Claude Code meldet:

44>

45> * `Marketplace "claude-plugins-official" not found`: Fügen Sie den Marketplace mit `/plugin marketplace add anthropics/claude-plugins-official` hinzu und versuchen Sie dann die Installation erneut.

46> * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: Ihre lokale Kopie des Marketplace-Katalogs ist möglicherweise veraltet. Aktualisieren Sie sie mit `/plugin marketplace update claude-plugins-official` und versuchen Sie dann die Installation erneut. Wenn der erneute Versuch dieselbe Meldung ausgibt, siehe [Plugin nicht im Marketplace gefunden](https://code.claude.com/docs/de/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

47>

48> Wenn die Installation nach einem Geltungsbereich für die Installation fragt, wählen Sie die Option für den Benutzer-Geltungsbereich, damit das Plugin in allen Ihren Projekten verfügbar ist. Überprüfen Sie die Installationszusammenfassung: Wenn sie `Run /reload-plugins to apply.` meldet, siehe [Plugin-Änderungen ohne Neustart anwenden](https://code.claude.com/docs/de/plugins/cli-reference.md#reload-plugins), um den Konfigurationsbefehl des Plugins verfügbar zu machen.

49>

50> **3. Konfigurieren Sie Ihr Token**

51>

52> Führen Sie den Konfigurationsbefehl mit dem Token von BotFather aus:

53>

54> ```

55> /telegram:configure <token>

56> ```

57>

58> Dies speichert es in `~/.claude/channels/telegram/.env`. Sie können auch `TELEGRAM_BOT_TOKEN` in Ihrer Shell-Umgebung setzen, bevor Sie Claude Code starten.

59>

60> **4. Starten Sie mit aktivierten Kanälen neu**

61>

62> Beenden Sie Claude Code und starten Sie mit dem Kanal-Flag neu. Dies startet das Telegram-Plugin, das mit dem Abrufen von Nachrichten von Ihrem Bot beginnt:

63>

64> ```bash theme={null}

65> claude --channels plugin:telegram@claude-plugins-official

66> ```

67>

68> **5. Koppeln Sie Ihr Konto**

69>

70> Öffnen Sie Telegram und senden Sie eine beliebige Nachricht an Ihren Bot. Der Bot antwortet mit einem Kopplungscode.

71>

72> > [!NOTE]

73> >

74> > Wenn Ihr Bot nicht antwortet, stellen Sie sicher, dass Claude Code mit `--channels` aus dem vorherigen Schritt ausgeführt wird. Der Bot kann nur antworten, während der Kanal aktiv ist.

75>

76> Zurück in Claude Code führen Sie aus:

77>

78> ```

79> /telegram:access pair <code>

80> ```

81>

82> Dann sperren Sie den Zugriff, damit nur Ihr Konto Nachrichten senden kann:

83>

84> ```

85> /telegram:access policy allowlist

86> ```

214 87 

215```88> [tab] Discord

216/imessage:access allow +1555123456789>

217```90> Sehen Sie sich den vollständigen [Discord-Plugin-Quellcode](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/discord) an.

91>

92> **1. Erstellen Sie einen Discord-Bot**

93>

94> Gehen Sie zum [Discord Developer Portal](https://discord.com/developers/applications), klicken Sie auf **New Application** und benennen Sie ihn. Im Abschnitt **Bot** erstellen Sie einen Benutzernamen, klicken dann auf **Reset Token** und kopieren das Token.

95>

96> **2. Aktivieren Sie Message Content Intent**

97>

98> In den Einstellungen Ihres Bots scrollen Sie zu **Privileged Gateway Intents** und aktivieren **Message Content Intent**.

99>

100> **3. Laden Sie den Bot auf Ihren Server ein**

101>

102> Gehen Sie zu **OAuth2 > URL Generator**. Wählen Sie den `bot`-Bereich und aktivieren Sie diese Berechtigungen:

103>

104> * View Channels

105> * Send Messages

106> * Send Messages in Threads

107> * Read Message History

108> * Attach Files

109> * Add Reactions

110>

111> Öffnen Sie die generierte URL, um den Bot zu Ihrem Server hinzuzufügen.

112>

113> **4. Installieren Sie das Plugin**

114>

115> Starten Sie Claude Code, indem Sie `claude` in Ihrem Terminal ausführen, und geben Sie dann Folgendes in das Eingabefeld ein:

116>

117> ```

118> /plugin install discord@claude-plugins-official

119> ```

120>

121> Wenn die Installation fehlschlägt, stimmen Sie die Meldung ab, die Claude Code meldet:

122>

123> * `Marketplace "claude-plugins-official" not found`: Fügen Sie den Marketplace mit `/plugin marketplace add anthropics/claude-plugins-official` hinzu und versuchen Sie dann die Installation erneut.

124> * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: Ihre lokale Kopie des Marketplace-Katalogs ist möglicherweise veraltet. Aktualisieren Sie sie mit `/plugin marketplace update claude-plugins-official` und versuchen Sie dann die Installation erneut. Wenn der erneute Versuch dieselbe Meldung ausgibt, siehe [Plugin nicht im Marketplace gefunden](https://code.claude.com/docs/de/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

125>

126> Wenn die Installation nach einem Geltungsbereich für die Installation fragt, wählen Sie die Option für den Benutzer-Geltungsbereich, damit das Plugin in allen Ihren Projekten verfügbar ist. Überprüfen Sie die Installationszusammenfassung: Wenn sie `Run /reload-plugins to apply.` meldet, siehe [Plugin-Änderungen ohne Neustart anwenden](https://code.claude.com/docs/de/plugins/cli-reference.md#reload-plugins), um den Konfigurationsbefehl des Plugins verfügbar zu machen.

127>

128> **5. Konfigurieren Sie Ihr Token**

129>

130> Führen Sie den Konfigurationsbefehl mit dem Bot-Token aus, das Sie kopiert haben:

131>

132> ```

133> /discord:configure <token>

134> ```

135>

136> Dies speichert es in `~/.claude/channels/discord/.env`. Sie können auch `DISCORD_BOT_TOKEN` in Ihrer Shell-Umgebung setzen, bevor Sie Claude Code starten.

137>

138> **6. Starten Sie mit aktivierten Kanälen neu**

139>

140> Beenden Sie Claude Code und starten Sie mit dem Kanal-Flag neu. Dies verbindet das Discord-Plugin, damit Ihr Bot Nachrichten empfangen und beantworten kann:

141>

142> ```bash theme={null}

143> claude --channels plugin:discord@claude-plugins-official

144> ```

145>

146> **7. Koppeln Sie Ihr Konto**

147>

148> Schreiben Sie Ihrem Bot auf Discord eine Direktnachricht. Der Bot antwortet mit einem Kopplungscode.

149>

150> > [!NOTE]

151> >

152> > Wenn Ihr Bot nicht antwortet, stellen Sie sicher, dass Claude Code mit `--channels` aus dem vorherigen Schritt ausgeführt wird. Der Bot kann nur antworten, während der Kanal aktiv ist.

153>

154> Zurück in Claude Code führen Sie aus:

155>

156> ```

157> /discord:access pair <code>

158> ```

159>

160> Dann sperren Sie den Zugriff, damit nur Ihr Konto Nachrichten senden kann:

161>

162> ```

163> /discord:access policy allowlist

164> ```

218 165 

219Handles sind Telefonnummern im Format `+country` oder Apple ID-E-Mails wie `user@example.com`.166> [tab] iMessage

167>

168> Sehen Sie sich den vollständigen [iMessage-Plugin-Quellcode](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/imessage) an.

169>

170> Der iMessage-Kanal liest Ihre Messages-Datenbank direkt und sendet Antworten über AppleScript. Er erfordert macOS und benötigt kein Bot-Token oder externen Service.

171>

172> **1. Gewähren Sie vollständigen Festplattenzugriff**

173>

174> Die Messages-Datenbank unter `~/Library/Messages/chat.db` ist durch macOS geschützt. Wenn der Server sie zum ersten Mal liest, fordert macOS Zugriff an: klicken Sie auf **Allow**. Die Aufforderung nennt die App, die Bun gestartet hat, wie Terminal, iTerm oder Ihre IDE.

175>

176> Wenn die Abfrage nicht angezeigt wird oder Sie auf „Don't Allow“ geklickt haben, gewähren Sie den Zugriff manuell unter **System Settings > Privacy & Security > Full Disk Access** und fügen Sie Ihr Terminal hinzu. Ohne dies beendet sich der Server sofort mit `authorization denied`.

177>

178> **2. Installieren Sie das Plugin**

179>

180> Starten Sie Claude Code, indem Sie `claude` in Ihrem Terminal ausführen, und geben Sie dann Folgendes in das Eingabefeld ein:

181>

182> ```

183> /plugin install imessage@claude-plugins-official

184> ```

185>

186> Wenn die Installation fehlschlägt, stimmen Sie die Meldung ab, die Claude Code meldet:

187>

188> * `Marketplace "claude-plugins-official" not found`: Fügen Sie den Marketplace mit `/plugin marketplace add anthropics/claude-plugins-official` hinzu und versuchen Sie dann die Installation erneut.

189> * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: Ihre lokale Kopie des Marketplace-Katalogs ist möglicherweise veraltet. Aktualisieren Sie sie mit `/plugin marketplace update claude-plugins-official` und versuchen Sie dann die Installation erneut. Wenn der erneute Versuch dieselbe Meldung ausgibt, siehe [Plugin nicht im Marketplace gefunden](https://code.claude.com/docs/de/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

190>

191> Wenn die Installation nach einem Geltungsbereich für die Installation fragt, wählen Sie die Option für den Benutzer-Geltungsbereich, damit das Plugin in allen Ihren Projekten verfügbar ist.

192>

193> Wenn die Installationszusammenfassung `Run /reload-plugins to apply.` meldet, müssen Sie hier nichts unternehmen, da der Neustart im nächsten Schritt das Plugin lädt.

194>

195> **3. Starten Sie mit aktivierten Channels neu**

196>

197> Beenden Sie Claude Code und starten Sie mit dem Channel-Flag neu:

198>

199> ```bash theme={null}

200> claude --channels plugin:imessage@claude-plugins-official

201> ```

202>

203> **4. Schreiben Sie sich selbst**

204>

205> Öffnen Sie Messages auf einem beliebigen Gerät, das in Ihrer Apple ID angemeldet ist, und senden Sie sich selbst eine Nachricht. Sie erreicht Claude sofort: Self-Chat umgeht die Zugriffskontrolle ohne Setup.

206>

207> > [!NOTE]

208> >

209> > Die erste Antwort, die Claude sendet, löst eine macOS-Automatisierungsaufforderung aus, die fragt, ob Ihr Terminal Messages steuern kann. Klicken Sie auf **OK**.

210>

211> **5. Erlauben Sie anderen Absendern**

212>

213> Standardmäßig passieren nur Ihre eigenen Nachrichten durch. Um einem anderen Kontakt zu ermöglichen, Claude zu erreichen, fügen Sie seinen Handle hinzu:

214>

215> ```

216> /imessage:access allow +15551234567

217> ```

218>

219> Handles sind Telefonnummern im Format `+country` oder Apple ID-E-Mails wie `user@example.com`.

220 220 

221## Schnellstart221## Schnellstart

222 222 

308| `channelsEnabled` | Hauptschalter. Muss `true` sein, damit ein Kanal Nachrichten liefert. Blockiert alle Kanäle einschließlich des Entwicklungs-Flags, wenn deaktiviert. Siehe [Aktivieren Sie Kanäle für Ihre Organisation](#enable-channels-for-your-organization). | claude.ai Team und Enterprise: Kanäle blockiert. Console: Kanäle zulässig, es sei denn, Ihre Organisation stellt verwaltete Einstellungen bereit. In diesem Fall sind Kanäle blockiert, bis dieser Schlüssel gesetzt ist |308| `channelsEnabled` | Hauptschalter. Muss `true` sein, damit ein Kanal Nachrichten liefert. Blockiert alle Kanäle einschließlich des Entwicklungs-Flags, wenn deaktiviert. Siehe [Aktivieren Sie Kanäle für Ihre Organisation](#enable-channels-for-your-organization). | claude.ai Team und Enterprise: Kanäle blockiert. Console: Kanäle zulässig, es sei denn, Ihre Organisation stellt verwaltete Einstellungen bereit. In diesem Fall sind Kanäle blockiert, bis dieser Schlüssel gesetzt ist |

309| `allowedChannelPlugins` | Welche Plugins sich registrieren können, sobald Kanäle aktiviert sind. Ersetzt die von Anthropic verwaltete Liste, wenn gesetzt. | Anthropic-Standardliste gilt |309| `allowedChannelPlugins` | Welche Plugins sich registrieren können, sobald Kanäle aktiviert sind. Ersetzt die von Anthropic verwaltete Liste, wenn gesetzt. | Anthropic-Standardliste gilt |

310 310 

311Pro- und Max-Benutzer ohne Organisation überspringen diese Überprüfungen vollständig: Kanäle sind verfügbar und Benutzer aktivieren sie pro Sitzung mit `--channels`.311Pro-, Max- und Ultra-Benutzer ohne Organisation überspringen diese Überprüfungen vollständig: Channels sind verfügbar und Benutzer aktivieren sie pro Sitzung mit `--channels`.

312 312 

313### Aktivieren Sie Kanäle für Ihre Organisation313### Aktivieren Sie Kanäle für Ihre Organisation

314 314 

39* [Google Chrome](https://www.google.com/chrome/), [Microsoft Edge](https://www.microsoft.com/edge) oder einen anderen Chromium-basierten Browser wie Brave, Arc, Vivaldi oder Opera39* [Google Chrome](https://www.google.com/chrome/), [Microsoft Edge](https://www.microsoft.com/edge) oder einen anderen Chromium-basierten Browser wie Brave, Arc, Vivaldi oder Opera

40* [Claude in Chrome-Erweiterung](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) Version 1.0.36 oder höher, verfügbar im Chrome Web Store40* [Claude in Chrome-Erweiterung](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) Version 1.0.36 oder höher, verfügbar im Chrome Web Store

41* [Claude Code](https://code.claude.com/docs/de/quickstart.md#step-1-install-claude-code)41* [Claude Code](https://code.claude.com/docs/de/quickstart.md#step-1-install-claude-code)

42* Einen direkten Anthropic-Plan (Pro, Max, Team oder Enterprise)42* Einen direkten Anthropic-Plan (Pro, Max, Ultra, Team oder Enterprise)

43 43 

44In Enterprise-Organisationen, in denen HIPAA aktiviert ist, ist Claude in Chrome standardmäßig ausgeschaltet, und ein [Owner](https://code.claude.com/docs/de/server-managed-settings.md#access-control) kann es unter [**Organisationseinstellungen > Claude in Chrome**](https://claude.ai/admin-settings/browser-extension) einschalten. Ihre Business Associate Agreement (BAA) mit Anthropic deckt keine Daten ab, die über Claude in Chrome an Websites von Drittanbietern gesendet werden. Eine Liste der Eligible Services finden Sie im [Implementation Guide](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide).44In Enterprise-Organisationen, in denen HIPAA aktiviert ist, ist Claude in Chrome standardmäßig ausgeschaltet, und ein [Owner](https://code.claude.com/docs/de/server-managed-settings.md#access-control) kann es unter [**Organisationseinstellungen > Claude in Chrome**](https://claude.ai/admin-settings/browser-extension) einschalten. Ihre Business Associate Agreement (BAA) mit Anthropic deckt keine Daten ab, die über Claude in Chrome an Websites von Drittanbietern gesendet werden. Eine Liste der Eligible Services finden Sie im [Implementation Guide](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide).

45 45 

325 325 

326**7. Bereitstellen**326**7. Bereitstellen**

327 327 

328**ECS Fargate**328> [tab] ECS Fargate

329 329>

330Erstellen Sie den Cluster und eine Log-Gruppe für die stderr des Gateways, die sowohl seine Audit-Events als auch Betriebslogs trägt. Die Aufbewahrung ist ein separater Aufruf, und ohne einen behält CloudWatch die Logs für immer; richten Sie die 90 Tage auf Ihre Audit-Aufbewahrungsrichtlinie aus:330> Erstellen Sie den Cluster und eine Log-Gruppe für die stderr des Gateways, die sowohl seine Audit-Events als auch Betriebslogs trägt. Die Aufbewahrung ist ein separater Aufruf, und ohne einen behält CloudWatch die Logs für immer; richten Sie die 90 Tage auf Ihre Audit-Aufbewahrungsrichtlinie aus:

331 331>

332```bash theme={null}332> ```bash theme={null}

333aws ecs create-cluster --cluster-name claude-gateway333> aws ecs create-cluster --cluster-name claude-gateway

334aws logs create-log-group --log-group-name /ecs/claude-gateway334> aws logs create-log-group --log-group-name /ecs/claude-gateway

335aws logs put-retention-policy --log-group-name /ecs/claude-gateway \335> aws logs put-retention-policy --log-group-name /ecs/claude-gateway \

336 --retention-in-days 90336> --retention-in-days 90

337```337> ```

338 338>

339Schreiben Sie die Task-Definition. Die Task-Rolle trägt die Bedrock-Berechtigung und die Ausführungsrolle injiziert die Geheimnisse; verwenden Sie die Geheimnis-ARNs aus dem Secrets Manager-Schritt:339> Schreiben Sie die Task-Definition. Die Task-Rolle trägt die Bedrock-Berechtigung und die Ausführungsrolle injiziert die Geheimnisse; verwenden Sie die Geheimnis-ARNs aus dem Secrets Manager-Schritt:

340 340>

341```json claude-gateway-task.json theme={null}341> ```json claude-gateway-task.json theme={null}

342{342> {

343 "family": "claude-gateway",343> "family": "claude-gateway",

344 "networkMode": "awsvpc",344> "networkMode": "awsvpc",

345 "requiresCompatibilities": ["FARGATE"],345> "requiresCompatibilities": ["FARGATE"],

346 "cpu": "1024",346> "cpu": "1024",

347 "memory": "2048",347> "memory": "2048",

348 "runtimePlatform": { "cpuArchitecture": "X86_64", "operatingSystemFamily": "LINUX" },348> "runtimePlatform": { "cpuArchitecture": "X86_64", "operatingSystemFamily": "LINUX" },

349 "executionRoleArn": "arn:aws:iam::<account-id>:role/claude-gateway-execution",349> "executionRoleArn": "arn:aws:iam::<account-id>:role/claude-gateway-execution",

350 "taskRoleArn": "arn:aws:iam::<account-id>:role/claude-gateway-task",350> "taskRoleArn": "arn:aws:iam::<account-id>:role/claude-gateway-task",

351 "containerDefinitions": [351> "containerDefinitions": [

352 {352> {

353 "name": "gateway",353> "name": "gateway",

354 "image": "<account-id>.dkr.ecr.<region>.amazonaws.com/claude-gateway:<version>",354> "image": "<account-id>.dkr.ecr.<region>.amazonaws.com/claude-gateway:<version>",

355 "portMappings": [{ "containerPort": 8080 }],355> "portMappings": [{ "containerPort": 8080 }],

356 "secrets": [356> "secrets": [

357 { "name": "GATEWAY_JWT_SECRET", "valueFrom": "<gateway-jwt-secret ARN>" },357> { "name": "GATEWAY_JWT_SECRET", "valueFrom": "<gateway-jwt-secret ARN>" },

358 { "name": "OIDC_CLIENT_SECRET", "valueFrom": "<gateway-oidc-client-secret ARN>" },358> { "name": "OIDC_CLIENT_SECRET", "valueFrom": "<gateway-oidc-client-secret ARN>" },

359 { "name": "GATEWAY_POSTGRES_URL", "valueFrom": "<gateway-postgres-url ARN>" }359> { "name": "GATEWAY_POSTGRES_URL", "valueFrom": "<gateway-postgres-url ARN>" }

360 ],360> ],

361 "logConfiguration": {361> "logConfiguration": {

362 "logDriver": "awslogs",362> "logDriver": "awslogs",

363 "options": {363> "options": {

364 "awslogs-group": "/ecs/claude-gateway",364> "awslogs-group": "/ecs/claude-gateway",

365 "awslogs-region": "<region>",365> "awslogs-region": "<region>",

366 "awslogs-stream-prefix": "gateway"366> "awslogs-stream-prefix": "gateway"

367 }367> }

368 }368> }

369 }369> }

370 ]370> ]