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

77* **Python:** periksa message types dengan `isinstance()` terhadap classes yang diimpor dari `claude_agent_sdk` (misalnya, `isinstance(message, ResultMessage)`).77* **Python:** periksa message types dengan `isinstance()` terhadap classes yang diimpor dari `claude_agent_sdk` (misalnya, `isinstance(message, ResultMessage)`).

78* **TypeScript:** periksa field string `type` (misalnya, `message.type === "result"`). `AssistantMessage` dan `UserMessage` membungkus raw API message dalam field `.message`, jadi content blocks berada di `message.message.content`, bukan `message.content`.78* **TypeScript:** periksa field string `type` (misalnya, `message.type === "result"`). `AssistantMessage` dan `UserMessage` membungkus raw API message dalam field `.message`, jadi content blocks berada di `message.message.content`, bukan `message.content`.

79 79 

80> **Contoh: Periksa message types dan handle results**80> [accordion] Contoh: Periksa message types dan handle results

81>81>

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

83> import asyncio83> import asyncio

273* **`PreCompact` hook:** Jalankan custom logic sebelum compaction terjadi, misalnya untuk archive full transcript. Hook menerima field `trigger` (`manual` atau `auto`). Lihat [hooks](https://code.claude.com/docs/id/agent-sdk/hooks.md).273* **`PreCompact` hook:** Jalankan custom logic sebelum compaction terjadi, misalnya untuk archive full transcript. Hook menerima field `trigger` (`manual` atau `auto`). Lihat [hooks](https://code.claude.com/docs/id/agent-sdk/hooks.md).

274* **Manual compaction:** Kirim `/compact` sebagai prompt string untuk trigger compaction on demand. Commands yang dikirim dengan cara ini adalah SDK inputs biasa. Lihat [dispatch commands by name](https://code.claude.com/docs/id/agent-sdk/skills.md#dispatch-commands-by-name).274* **Manual compaction:** Kirim `/compact` sebagai prompt string untuk trigger compaction on demand. Commands yang dikirim dengan cara ini adalah SDK inputs biasa. Lihat [dispatch commands by name](https://code.claude.com/docs/id/agent-sdk/skills.md#dispatch-commands-by-name).

275 275 

276> **Contoh: Summarization instructions dalam CLAUDE.md**276> [accordion] Contoh: Summarization instructions dalam CLAUDE.md

277>277>

278> Tambahkan section ke CLAUDE.md proyek Anda yang memberi tahu compactor apa yang dipertahankan. Nama header tidak special; gunakan label yang jelas apa pun.278> Tambahkan section ke CLAUDE.md proyek Anda yang memberi tahu compactor apa yang dipertahankan. Nama header tidak special; gunakan label yang jelas apa pun.

279>279>

42 42 

43Contoh Python di halaman ini yang membuat permintaan HTTP menggunakan [httpx](https://www.python-httpx.org/). Tambahkan dengan package manager yang digunakan proyek Anda:43Contoh Python di halaman ini yang membuat permintaan HTTP menggunakan [httpx](https://www.python-httpx.org/). Tambahkan dengan package manager yang digunakan proyek Anda:

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### Contoh alat cuaca57### Contoh alat cuaca

58 58 

198 198 

199Gabungkan potongan ini dengan definisi tool dan server dari [contoh tool cuaca](#weather-tool-example) dalam satu file, `weather.py` atau `weather.ts`, kemudian jalankan dari terminal Anda:199Gabungkan potongan ini dengan definisi tool dan server dari [contoh tool cuaca](#weather-tool-example) dalam satu file, `weather.py` atau `weather.ts`, kemudian jalankan dari terminal Anda:

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 

215Aktifkan virtual environment tempat Anda menginstal SDK, lalu jalankan: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> Aktifkan virtual environment tempat Anda menginstal SDK, lalu jalankan:

216>

217> ```bash theme={null}

218> python weather.py

219> ```

220 220 

221Claude memanggil `get_temperature` dan skrip mencetak jawaban satu baris dengan suhu saat ini di San Francisco.221Claude memanggil `get_temperature` dan skrip mencetak jawaban satu baris dengan suhu saat ini di San Francisco.

222 222 

585>585>

586> Buka file utilitas Anda (`utils.py` atau `utils.ts`) di IDE atau editor Anda sebelum menjalankan skrip. Anda akan melihat file diperbarui secara real-time saat agen menambahkan komentar doc, kemudian kembali ke asli ketika Anda memilih untuk mengembalikan.586> Buka file utilitas Anda (`utils.py` atau `utils.ts`) di IDE atau editor Anda sebelum menjalankan skrip. Anda akan melihat file diperbarui secara real-time saat agen menambahkan komentar doc, kemudian kembali ke asli ketika Anda memilih untuk mengembalikan.

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 

600Anda akan melihat agen menambahkan komentar doc, kemudian prompt yang menanyakan apakah Anda ingin mengembalikan. Jika Anda memilih ya, file dipulihkan ke status aslinya.600Anda akan melihat agen menambahkan komentar doc, kemudian prompt yang menanyakan apakah Anda ingin mengembalikan. Jika Anda memilih ya, file dipulihkan ke status aslinya.

601 601 

386 386 

387Gunakan field `env` untuk meneruskan kunci API, token, dan kredensial lainnya ke server MCP:387Gunakan field `env` untuk meneruskan kunci API, token, dan kredensial lainnya ke server MCP:

388 388 

389**Dalam kode**389> [tab] Dalam kode

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>

437Sintaks `${API_KEY}` memperluas variabel lingkungan saat runtime.437> Sintaks `${API_KEY}` memperluas variabel lingkungan saat runtime.

438 438 

439### Header HTTP untuk server jarak jauh439### Header HTTP untuk server jarak jauh

440 440 

441Untuk server HTTP dan SSE, teruskan header autentikasi langsung dalam konfigurasi server:441Untuk server HTTP dan SSE, teruskan header autentikasi langsung dalam konfigurasi server:

442 442 

443**Dalam kode**443> [tab] Dalam kode

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>

491Sintaks `${API_TOKEN}` memperluas variabel lingkungan saat runtime.491> Sintaks `${API_TOKEN}` memperluas variabel lingkungan saat runtime.

492 492 

493Untuk contoh kerja lengkap dari server jarak jauh yang diautentikasi dengan header, lihat [Daftar masalah dari repositori](#list-issues-from-a-repository).493Untuk contoh kerja lengkap dari server jarak jauh yang diautentikasi dengan header, lihat [Daftar masalah dari repositori](#list-issues-from-a-repository).

494 494 

163 163 

164Anda dapat mengatur mode izin sekali saat memulai query, atau mengubahnya secara dinamis saat sesi aktif.164Anda dapat mengatur mode izin sekali saat memulai query, atau mengubahnya secara dinamis saat sesi aktif.

165 165 

166**Pada waktu query**166> [tab] Pada waktu query

167 167>

168Lewatkan `permission_mode` (Python) atau `permissionMode` (TypeScript) saat membuat query.168> Lewatkan `permission_mode` (Python) atau `permissionMode` (TypeScript) saat membuat query.

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**Selama streaming**

209 

210Panggil `set_permission_mode()` (Python) atau `setPermissionMode()` (TypeScript) untuk mengubah mode di tengah sesi. Mode baru berlaku segera untuk semua permintaan tool berikutnya. Ini memungkinkan Anda untuk memulai dengan pembatasan dan melonggarkan izin seiring kepercayaan berkembang, misalnya beralih ke `acceptEdits` setelah meninjau pendekatan awal Claude.

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] Selama streaming

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

239 210> Panggil `set_permission_mode()` (Python) atau `setPermissionMode()` (TypeScript) untuk mengubah mode di tengah sesi. Mode baru berlaku segera untuk semua permintaan tool berikutnya. Ini memungkinkan Anda untuk memulai dengan pembatasan dan melonggarkan izin seiring kepercayaan berkembang, misalnya beralih ke `acceptEdits` setelah meninjau pendekatan awal Claude.

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### Detail mode262### Detail mode

263 263 

36 36 

37Instal paket Agent SDK untuk bahasa Anda:37Instal paket Agent SDK untuk bahasa Anda:

38 38 

39**TypeScript (proyek baru)**39> [tab] TypeScript (proyek baru)

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>

48Mengatur `"type": "module"` di `package.json` memungkinkan skrip agen Anda menggunakan `await` tingkat atas, dan [tsx](https://tsx.hirok.io) menjalankan file TypeScript secara langsung. npm mencetak `added N packages` ketika instalasi berhasil.48> Mengatur `"type": "module"` di `package.json` memungkinkan skrip agen Anda menggunakan `await` tingkat atas, dan [tsx](https://tsx.hirok.io) menjalankan file TypeScript secara langsung. npm mencetak `added N packages` ketika instalasi berhasil.

49 

50**TypeScript (proyek yang ada)**

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) menjalankan file TypeScript secara langsung. Jika proyek Anda menggunakan CommonJS, beri nama skrip agen Anda `agent.mts` alih-alih `agent.ts`. Ekstensi `.mts` membuat tsx memperlakukan file sebagai modul ES, sehingga `await` tingkat atas berfungsi tanpa mengonversi seluruh proyek Anda ke modul ES. Gunakan `agent.mts` sebagai pengganti `agent.ts` dalam langkah buat dan jalankan nanti dalam panduan cepat ini.

58 

59**Python (uv)**

60 

61[Instal uv](https://docs.astral.sh/uv/), pengelola paket Python yang cepat yang menangani lingkungan virtual secara otomatis. Kemudian inisialisasi proyek dan tambahkan SDK:

62 

63```bash theme={null}

64uv init

65uv add claude-agent-sdk

66```

67 

68**Python (pip)**

69 

70Buat dan aktifkan lingkungan virtual, kemudian instal paket.

71 

72Di macOS atau Linux:

73 

74```bash theme={null}

75python3 -m venv .venv

76source .venv/bin/activate

77pip install claude-agent-sdk

78```

79 49 

80Di Windows:50> [tab] TypeScript (proyek yang ada)

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) menjalankan file TypeScript secara langsung. Jika proyek Anda menggunakan CommonJS, beri nama skrip agen Anda `agent.mts` alih-alih `agent.ts`. Ekstensi `.mts` membuat tsx memperlakukan file sebagai modul ES, sehingga `await` tingkat atas berfungsi tanpa mengonversi seluruh proyek Anda ke modul ES. Gunakan `agent.mts` sebagai pengganti `agent.ts` dalam langkah buat dan jalankan nanti dalam panduan cepat ini.

81 58 

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

83py -m venv .venv60>

84.venv\Scripts\Activate.ps161> [Instal uv](https://docs.astral.sh/uv/), pengelola paket Python yang cepat yang menangani lingkungan virtual secara otomatis. Kemudian inisialisasi proyek dan tambahkan SDK:

85pip install claude-agent-sdk62>

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

64> uv init

65> uv add claude-agent-sdk

66> ```

87 67 

88Jika PowerShell memblokir `Activate.ps1` dengan kesalahan kebijakan eksekusi, jalankan `Set-ExecutionPolicy -Scope Process RemoteSigned` terlebih dahulu.68> [tab] Python (pip)

69>

70> Buat dan aktifkan lingkungan virtual, kemudian instal paket.

71>

72> Di macOS atau 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> Di 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> Jika PowerShell memblokir `Activate.ps1` dengan kesalahan kebijakan eksekusi, jalankan `Set-ExecutionPolicy -Scope Process RemoteSigned` terlebih dahulu.

89 89 

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

91>91>

98 98 

99Dapatkan kunci API dari [Claude Console](https://platform.claude.com/), kemudian atur sebagai variabel lingkungan di shell tempat Anda akan menjalankan agen Anda:99Dapatkan kunci API dari [Claude Console](https://platform.claude.com/), kemudian atur sebagai variabel lingkungan di shell tempat Anda akan menjalankan agen Anda:

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 

113SDK membaca kunci dari lingkungan proses yang menjalankan agen Anda; SDK tidak memuat file `.env` secara otomatis. Jika Anda menyimpan kunci di file `.env`, muat sendiri, misalnya dengan paket `dotenv`, sebelum memanggil SDK.113SDK membaca kunci dari lingkungan proses yang menjalankan agen Anda; SDK tidak memuat file `.env` secara otomatis. Jika Anda menyimpan kunci di file `.env`, muat sendiri, misalnya dengan paket `dotenv`, sebelum memanggil SDK.

114 114 

224 224 

225Agen Anda siap. Jalankan dengan perintah berikut:225Agen Anda siap. Jalankan dengan perintah berikut:

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>

233Jika Anda memberi nama skrip Anda `agent.mts`, jalankan `npx tsx agent.mts` sebagai gantinya.233> Jika Anda memberi nama skrip Anda `agent.mts`, jalankan `npx tsx agent.mts` sebagai gantinya.

234 

235**Python (uv)**

236 

237```bash theme={null}

238uv run agent.py

239```

240 

241**Python (pip)**

242 234 

243Dengan lingkungan virtual Anda masih diaktifkan: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> Dengan lingkungan virtual Anda masih diaktifkan:

244>

245> ```bash theme={null}

246> python agent.py

247> ```

248 248 

249Saat bekerja, agen mencetak penalarannya dan setiap alat yang dipanggilnya, diakhiri dengan `Done: success`. Setelah menjalankan, periksa `utils.py`. Anda akan melihat kode defensif yang menangani daftar kosong dan pengguna null. Agen Anda secara mandiri:249Saat bekerja, agen mencetak penalarannya dan setiap alat yang dipanggilnya, diakhiri dengan `Done: success`. Setelah menjalankan, periksa `utils.py`. Anda akan melihat kode defensif yang menangani daftar kosong dan pengguna null. Agen Anda secara mandiri:

250 250 

470 470 

471Setiap SDK menampilkan penolakan secara berbeda:471Setiap SDK menampilkan penolakan secara berbeda:

472 472 

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

474 474>

475SDK TypeScript melempar `Error` yang menyatakan aturan yang entri langgar. Misalnya, `skills: ["docs:*"]` melempar:475> SDK TypeScript melempar `Error` yang menyatakan aturan yang entri langgar. Misalnya, `skills: ["docs:*"]` melempar:

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>

481Nama kosong melaporkan `Skill names must be non-empty strings.`481> Nama kosong melaporkan `Skill names must be non-empty strings.`

482 482>

483Sebelum TypeScript Agent SDK 0.3.221, SDK tidak menjalankan pemeriksaan ini.483> Sebelum TypeScript Agent SDK 0.3.221, SDK tidak menjalankan pemeriksaan ini.

484 

485**Python**

486 

487SDK Python menaikkan `ValueError` yang menyatakan aturan yang entri langgar. Misalnya, `skills=["docs:*"]` menaikkan:

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 

493Nama kosong melaporkan `Skill names must be non-empty strings`.

494 484 

495Sebelum Python Agent SDK 0.2.129, SDK tidak menjalankan pemeriksaan ini.485> [tab] Python

486>

487> SDK Python menaikkan `ValueError` yang menyatakan aturan yang entri langgar. Misalnya, `skills=["docs:*"]` menaikkan:

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> Nama kosong melaporkan `Skill names must be non-empty strings`.

494>

495> Sebelum Python Agent SDK 0.2.129, SDK tidak menjalankan pemeriksaan ini.

496 496 

497### Pemecahan masalah tambahan497### Pemecahan masalah tambahan

498 498 

16 16 

17Pertimbangkan aplikasi resep di mana agen mencari web dan membawa kembali resep. Tanpa output terstruktur, Anda mendapatkan teks bentuk bebas yang perlu Anda parsing sendiri. Dengan output terstruktur, Anda menentukan bentuk yang Anda inginkan dan mendapatkan data yang diketik yang dapat Anda gunakan langsung di aplikasi Anda.17Pertimbangkan aplikasi resep di mana agen mencari web dan membawa kembali resep. Tanpa output terstruktur, Anda mendapatkan teks bentuk bebas yang perlu Anda parsing sendiri. Dengan output terstruktur, Anda menentukan bentuk yang Anda inginkan dan mendapatkan data yang diketik yang dapat Anda gunakan langsung di aplikasi Anda.

18 18 

19> **Tanpa output terstruktur**19> [accordion] Tanpa output terstruktur

20>20>

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

22> Berikut adalah resep kue cokelat chip klasik!22> Berikut adalah resep kue cokelat chip klasik!

32>32>

33> Untuk menggunakan ini di aplikasi Anda, Anda perlu mengurai judul, mengonversi "15 menit" menjadi angka, memisahkan bahan dari instruksi, dan menangani pemformatan yang tidak konsisten di seluruh respons.33> Untuk menggunakan ini di aplikasi Anda, Anda perlu mengurai judul, mengonversi "15 menit" menjadi angka, memisahkan bahan dari instruksi, dan menangani pemformatan yang tidak konsisten di seluruh respons.

34 34 

35> **Dengan output terstruktur**35> [accordion] Dengan output terstruktur

36>36>

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

38> {38> {

225 225 

226Pembantu `ask_user` dan `askUser` dalam cuplikan berikut berdiri untuk UI prompt aplikasi Anda sendiri.226Pembantu `ask_user` dan `askUser` dalam cuplikan berikut berdiri untuk UI prompt aplikasi Anda sendiri.

227 227 

228**Setujui**228> [tab] Setujui

229 229>

230Pengguna menyetujui tindakan apa adanya. Teruskan `input` dari callback Anda tanpa perubahan dan alat dijalankan persis seperti yang diminta Claude.230> Pengguna menyetujui tindakan apa adanya. Teruskan `input` dari callback Anda tanpa perubahan dan alat dijalankan persis seperti yang diminta Claude.

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**Setujui dengan perubahan**254> [tab] Setujui dengan perubahan

255 255>

256Pengguna menyetujui tetapi ingin memodifikasi permintaan terlebih dahulu. Anda dapat mengubah input sebelum alat dijalankan. Claude melihat hasilnya tetapi tidak diberitahu Anda mengubah apa pun. Berguna untuk sanitasi parameter, menambahkan batasan, atau membatasi akses.256> Pengguna menyetujui tetapi ingin memodifikasi permintaan terlebih dahulu. Anda dapat mengubah input sebelum alat dijalankan. Claude melihat hasilnya tetapi tidak diberitahu Anda mengubah apa pun. Berguna untuk sanitasi parameter, menambahkan batasan, atau membatasi akses.

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 # Pengguna menyetujui, tetapi batasi semua perintah ke sandbox261> # Pengguna menyetujui, tetapi batasi semua perintah ke sandbox

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 // Pengguna menyetujui, tetapi batasi semua perintah ke sandbox273> // Pengguna menyetujui, tetapi batasi semua perintah ke sandbox

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**Setujui dan ingat**284> [tab] Setujui dan ingat

285 285>

286Pengguna menyetujui dan tidak ingin ditanya lagi untuk jenis panggilan ini. Argumen callback ketiga membawa `suggestions`, sebuah array entri [`PermissionUpdate`](https://code.claude.com/docs/id/agent-sdk/typescript#permissionupdate) yang sudah jadi. Kembalikan satu di `updatedPermissions` untuk menerapkannya. Saran dengan tujuan `localSettings` menulis aturan ke `.claude/settings.local.json` sehingga sesi mendatang melewati prompt untuk panggilan yang cocok.286> Pengguna menyetujui dan tidak ingin ditanya lagi untuk jenis panggilan ini. Argumen callback ketiga membawa `suggestions`, sebuah array entri [`PermissionUpdate`](https://code.claude.com/docs/id/agent-sdk/typescript#permissionupdate) yang sudah jadi. Kembalikan satu di `updatedPermissions` untuk menerapkannya. Saran dengan tujuan `localSettings` menulis aturan ke `.claude/settings.local.json` sehingga sesi mendatang melewati prompt untuk panggilan yang cocok.

287 287>

288Di TypeScript, lewati pilihan selalu-izinkan untuk permintaan yang opsinya membawa [`suppressAlwaysAllowRule: true`](https://code.claude.com/docs/id/agent-sdk/typescript#canusetool). Petunjuk memerlukan Agent SDK v0.3.268 atau lebih baru, dan `context` Python tidak membawanya.288> Di TypeScript, lewati pilihan selalu-izinkan untuk permintaan yang opsinya membawa [`suppressAlwaysAllowRule: true`](https://code.claude.com/docs/id/agent-sdk/typescript#canusetool). Petunjuk memerlukan Agent SDK v0.3.268 atau lebih baru, dan `context` Python tidak membawanya.

289 289>

290Contoh Python memerlukan `claude-agent-sdk` 0.1.80 atau lebih baru.290> Contoh Python memerlukan `claude-agent-sdk` 0.1.80 atau lebih baru.

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**Tolak**329> [tab] Tolak

330 330>

331Pengguna tidak menginginkan tindakan ini terjadi. Blokir alat dan berikan pesan yang menjelaskan alasannya. Claude melihat pesan ini dan mungkin mencoba pendekatan yang berbeda.331> Pengguna tidak menginginkan tindakan ini terjadi. Blokir alat dan berikan pesan yang menjelaskan alasannya. Claude melihat pesan ini dan mungkin mencoba pendekatan yang berbeda.

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**Sarankan alternatif**356> [tab] Sarankan alternatif

357 357>

358Pengguna tidak menginginkan tindakan spesifik ini, tetapi memiliki ide yang berbeda. Blokir alat dan sertakan panduan dalam pesan Anda. Claude akan membaca ini dan memutuskan cara melanjutkan berdasarkan umpan balik Anda.358> Pengguna tidak menginginkan tindakan spesifik ini, tetapi memiliki ide yang berbeda. Blokir alat dan sertakan panduan dalam pesan Anda. Claude akan membaca ini dan memutuskan cara melanjutkan berdasarkan umpan balik Anda.

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 # Pengguna tidak ingin menghapus, sarankan pengarsipan sebagai gantinya363> # Pengguna tidak ingin menghapus, sarankan pengarsipan sebagai gantinya

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 // Pengguna tidak ingin menghapus, sarankan pengarsipan sebagai gantinya373> // Pengguna tidak ingin menghapus, sarankan pengarsipan sebagai gantinya

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**Alihkan sepenuhnya**384> [tab] Alihkan sepenuhnya

385 385>

386Untuk perubahan arah yang lengkap (bukan hanya dorongan), gunakan [input streaming](https://code.claude.com/docs/id/agent-sdk/streaming-vs-single-mode.md) untuk mengirim Claude instruksi baru secara langsung. Ini melewati permintaan alat saat ini dan memberikan Claude instruksi yang sepenuhnya baru untuk diikuti.386> Untuk perubahan arah yang lengkap (bukan hanya dorongan), gunakan [input streaming](https://code.claude.com/docs/id/agent-sdk/streaming-vs-single-mode.md) untuk mengirim Claude instruksi baru secara langsung. Ini melewati permintaan alat saat ini dan memberikan Claude instruksi yang sepenuhnya baru untuk diikuti.

387 387 

388## Menangani pertanyaan klarifikasi388## Menangani pertanyaan klarifikasi

389 389 

13| [Subagents](https://code.claude.com/docs/id/sub-agents.md) | Pekerja delegasi di dalam satu sesi yang melakukan tugas sampingan dalam konteks mereka sendiri dan mengembalikan ringkasan | Tugas sampingan akan membanjiri percakapan utama Anda dengan hasil pencarian, log, atau konten file yang tidak akan Anda referensikan lagi |13| [Subagents](https://code.claude.com/docs/id/sub-agents.md) | Pekerja delegasi di dalam satu sesi yang melakukan tugas sampingan dalam konteks mereka sendiri dan mengembalikan ringkasan | Tugas sampingan akan membanjiri percakapan utama Anda dengan hasil pencarian, log, atau konten file yang tidak akan Anda referensikan lagi |

14| [Agent view](https://code.claude.com/docs/id/agent-view.md) | Satu layar untuk mengirim dan memantau sesi yang berjalan di latar belakang, dibuka dengan `claude agents`. Pratinjau penelitian | Anda memiliki beberapa tugas independen dan ingin menyerahkannya, memeriksa status sekilas, dan hanya melangkah ketika salah satunya membutuhkan Anda |14| [Agent view](https://code.claude.com/docs/id/agent-view.md) | Satu layar untuk mengirim dan memantau sesi yang berjalan di latar belakang, dibuka dengan `claude agents`. Pratinjau penelitian | Anda memiliki beberapa tugas independen dan ingin menyerahkannya, memeriksa status sekilas, dan hanya melangkah ketika salah satunya membutuhkan Anda |

15| [Agent teams](https://code.claude.com/docs/id/agent-teams.md) | Beberapa sesi terkoordinasi dengan daftar tugas bersama dan pesan antar-agen, dikelola oleh pemimpin. Eksperimental dan dinonaktifkan secara default | Anda ingin Claude membagi proyek menjadi beberapa bagian, menugaskannya, dan menjaga pekerja tetap tersinkronisasi |15| [Agent teams](https://code.claude.com/docs/id/agent-teams.md) | Beberapa sesi terkoordinasi dengan daftar tugas bersama dan pesan antar-agen, dikelola oleh pemimpin. Eksperimental dan dinonaktifkan secara default | Anda ingin Claude membagi proyek menjadi beberapa bagian, menugaskannya, dan menjaga pekerja tetap tersinkronisasi |

16| [Projects](https://code.claude.com/docs/id/claude-projects.md) | Satu percakapan berkelanjutan di claude.ai/code atau di aplikasi desktop. Claude memulai sesi paralel yang disebut threads, di cloud atau, ketika Anda meminta, di komputer Anda melalui Remote Control, memberikan masing-masing instruksi proyek, dan menunjukkan kepada Anda mana yang membutuhkan Anda. Beta publik di Pro dan Max | Pekerjaan mencakup banyak tugas selama berhari-hari atau berminggu-minggu, harus terus berjalan ketika mesin Anda mati, dan Anda lebih suka mendeskripsikannya sekali daripada mengirim dan melacak setiap sesi |16| [Projects](https://code.claude.com/docs/id/claude-projects.md) | Satu percakapan berkelanjutan di claude.ai/code atau di aplikasi desktop. Claude memulai sesi paralel yang disebut threads, di cloud atau, ketika Anda meminta, di komputer Anda melalui Remote Control. Claude memberikan masing-masing instruksi proyek dan menunjukkan kepada Anda mana yang membutuhkan Anda. Beta publik di Pro, Max, dan Ultra | Pekerjaan mencakup banyak tugas selama berhari-hari atau berminggu-minggu, harus terus berjalan ketika mesin Anda mati, dan Anda lebih suka mendeskripsikannya sekali daripada mengirim dan melacak setiap sesi |

17| [Dynamic workflows](https://code.claude.com/docs/id/workflows.md) | Skrip yang menjalankan banyak subagents dan memeriksa silang hasil mereka, untuk pekerjaan yang terlalu besar untuk dikoordinasikan satu putaran sekaligus atau yang memerlukan lebih dari satu kali lintasan | Tugas terlalu besar untuk segelintir subagents, atau Anda ingin temuan diverifikasi satu sama lain: audit seluruh codebase, migrasi 500 file, penelitian yang diperiksa silang, atau rencana yang disusun dari beberapa sudut |17| [Dynamic workflows](https://code.claude.com/docs/id/workflows.md) | Skrip yang menjalankan banyak subagents dan memeriksa silang hasil mereka, untuk pekerjaan yang terlalu besar untuk dikoordinasikan satu putaran sekaligus atau yang memerlukan lebih dari satu kali lintasan | Tugas terlalu besar untuk segelintir subagents, atau Anda ingin temuan diverifikasi satu sama lain: audit seluruh codebase, migrasi 500 file, penelitian yang diperiksa silang, atau rencana yang disusun dari beberapa sudut |

18 18 

19Dalam setiap pendekatan, pekerja adalah sesi Claude. Untuk melibatkan alat yang berbeda, paparkan ke Claude sebagai [MCP server](https://code.claude.com/docs/id/mcp.md).19Dalam setiap pendekatan, pekerja adalah sesi Claude. Untuk melibatkan alat yang berbeda, paparkan ke Claude sebagai [MCP server](https://code.claude.com/docs/id/mcp.md).

8 8 

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

10>10>

11> Artifacts tersedia di paket Pro, Max, Team, dan Enterprise dan memerlukan sesi yang masuk dengan [`/login`](https://code.claude.com/docs/id/setup#authenticate). Lihat [Availability](#availability) untuk rangkaian lengkap persyaratan.11> Artifacts tersedia di paket Pro, Max, Ultra, Team, dan Enterprise dan memerlukan sesi yang masuk dengan [`/login`](https://code.claude.com/docs/id/setup#authenticate). Lihat [Availability](#availability) untuk rangkaian lengkap persyaratan.

12 12 

13Sebuah [artifact](https://claude.com/features/artifacts) adalah halaman web interaktif langsung yang Claude Code publikasikan dari sesi Anda ke URL pribadi di claude.ai. Anda membukanya di browser, dan halaman tersebut diperbarui di tempat saat sesi berlanjut. Bagikan dari header halaman ketika Anda ingin orang lain melihatnya juga.13Sebuah [artifact](https://claude.com/features/artifacts) adalah halaman web interaktif langsung yang Claude Code publikasikan dari sesi Anda ke URL pribadi di claude.ai. Anda membukanya di browser, dan halaman tersebut diperbarui di tempat saat sesi berlanjut. Bagikan dari header halaman ketika Anda ingin orang lain melihatnya juga.

14 14 

197 197 

198## Tarik data langsung dengan konektor MCP198## Tarik data langsung dengan konektor MCP

199 199 

200Sebuah artifact dapat memanggil [konektor MCP](https://code.claude.com/docs/id/mcp.md#use-mcp-servers-from-claude-ai) setiap kali seseorang melihatnya, sehingga halaman menampilkan data terkini daripada snapshot dari sesi yang membangunnya. Panggilan konektor dari artifact tersedia di paket Pro, Max, Team, dan Enterprise dan memerlukan Claude Code v2.1.209 atau lebih baru. Pada versi sebelumnya, Claude menerbitkan halaman dengan data apa pun yang dikumpulkan sesi saat membangunnya.200Sebuah artifact dapat memanggil [konektor MCP](https://code.claude.com/docs/id/mcp.md#use-mcp-servers-from-claude-ai) setiap kali seseorang melihatnya, sehingga halaman menampilkan data terkini daripada snapshot dari sesi yang membangunnya. Panggilan konektor dari artifact tersedia di paket Pro, Max, Ultra, Team, dan Enterprise dan memerlukan Claude Code v2.1.209 atau lebih baru. Pada versi sebelumnya, Claude menerbitkan halaman dengan data apa pun yang dikumpulkan sesi saat membangunnya.

201 201 

202Untuk membuat halaman yang didukung konektor, namai konektor dan data yang Anda inginkan dalam prompt Anda:202Untuk membuat halaman yang didukung konektor, namai konektor dan data yang Anda inginkan dalam prompt Anda:

203 203 

314 314 

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

316>316>

317> Template sedang dalam beta. Mereka aktif secara default pada paket Pro, Max, dan Team. Pada paket Enterprise, Owner [mengaktifkan setiap template](https://support.claude.com/en/articles/16994751-artifacts-admin-guide-for-team-and-enterprise-plans) di bawah **Organization settings > Artifacts**. Jika organisasi Anda menonaktifkan template Slides, `/slides` tidak muncul; jika menonaktifkan template Design, `/design` tidak membuat draf desain. Kedua perintah memerlukan Claude Code v2.1.265 atau lebih baru dan sesi di mana [artefak tersedia](#availability).317> Template sedang dalam beta. Mereka aktif secara default pada paket Pro, Max, Ultra, dan Team. Pada paket Enterprise, Owner [mengaktifkan setiap template](https://support.claude.com/en/articles/16994751-artifacts-admin-guide-for-team-and-enterprise-plans) di bawah **Organization settings > Artifacts**. Jika organisasi Anda menonaktifkan template Slides, `/slides` tidak muncul; jika menonaktifkan template Design, `/design` tidak membuat draf desain. Kedua perintah memerlukan Claude Code v2.1.265 atau lebih baru dan sesi di mana [artifact tersedia](#availability).

318 318 

319### Buat slide deck319### Buat slide deck

320 320 

368 368 

369| Persyaratan | Tersedia ketika |369| Persyaratan | Tersedia ketika |

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

371| Paket | Pro, Max, Team, atau Enterprise. Pada paket Pro dan Max, artifacts bersifat pribadi untuk Anda sampai Anda membagikannya, dan tidak ada manajemen admin yang berlaku. Pada paket Team dan Enterprise, artifacts diaktifkan secara default, dan Pemilik dapat [mengaturnya untuk organisasi](#manage-artifacts-for-your-organization) di pengaturan admin claude.ai. |371| Paket | Pro, Max, Ultra, Team, atau Enterprise. Pada paket Pro, Max, dan Ultra, artifacts bersifat pribadi untuk Anda sampai Anda membagikannya, dan tidak ada manajemen admin yang berlaku. Pada paket Team dan Enterprise, artifacts diaktifkan secara default, dan Owner dapat [mematikannya untuk organisasi](#manage-artifacts-for-your-organization) di pengaturan admin claude.ai. |

372| Autentikasi | Sesi didukung oleh akun claude.ai: masuk dengan `/login` di CLI atau aplikasi desktop. Sesi Claude Tag tidak memerlukan langkah masuk. Sesi menggunakan kunci API, [gateway token](https://code.claude.com/docs/id/llm-gateway), atau kredensial penyedia cloud tidak dapat menerbitkan. |372| Autentikasi | Sesi didukung oleh akun claude.ai: masuk dengan `/login` di CLI atau aplikasi desktop. Sesi Claude Tag tidak memerlukan langkah masuk. Sesi menggunakan kunci API, [gateway token](https://code.claude.com/docs/id/llm-gateway), atau kredensial penyedia cloud tidak dapat menerbitkan. |

373| Penyedia model | Anthropic API. Tidak tersedia di [Amazon Bedrock](https://code.claude.com/docs/id/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/id/google-vertex-ai.md), atau [Microsoft Foundry](https://code.claude.com/docs/id/microsoft-foundry.md). |373| Penyedia model | Anthropic API. Tidak tersedia di [Amazon Bedrock](https://code.claude.com/docs/id/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/id/google-vertex-ai.md), atau [Microsoft Foundry](https://code.claude.com/docs/id/microsoft-foundry.md). |

374| Kebijakan organisasi | Kunci enkripsi yang dikelola pelanggan (CMEK), HIPAA, dan [Zero Data Retention](https://code.claude.com/docs/id/zero-data-retention.md) tidak diaktifkan untuk organisasi. |374| Kebijakan organisasi | Kunci enkripsi yang dikelola pelanggan (CMEK), HIPAA, dan [Zero Data Retention](https://code.claude.com/docs/id/zero-data-retention.md) tidak diaktifkan untuk organisasi. |

23 23 

24Anda dapat melakukan autentikasi dengan salah satu jenis akun berikut:24Anda dapat melakukan autentikasi dengan salah satu jenis akun berikut:

25 25 

26* **Langganan Claude Pro atau Max**: masuk dengan akun claude.ai Anda. Berlangganan di [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).26* **Langganan Claude Pro, Max, atau Ultra**: masuk dengan akun claude.ai Anda. Berlangganan di [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).

27* **Claude for Teams atau Enterprise**: masuk dengan akun claude.ai yang diundang oleh admin tim Anda.27* **Claude for Teams atau Enterprise**: masuk dengan akun claude.ai yang diundang oleh admin tim Anda.

28* **Claude Console**: masuk dengan kredensial Console Anda. Admin Anda harus telah [mengundang Anda](#claude-console-authentication) terlebih dahulu. Anda dapat masuk dengan atau tanpa [membuat kunci API](#sign-in-without-an-api-key).28* **Claude Console**: masuk dengan kredensial Console Anda. Admin Anda harus telah [mengundang Anda](#claude-console-authentication) terlebih dahulu. Anda dapat masuk dengan atau tanpa [membuat kunci API](#sign-in-without-an-api-key).

29* **Penyedia cloud**: jika organisasi Anda menggunakan [Amazon Bedrock](https://code.claude.com/docs/id/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/id/google-vertex-ai.md), atau [Microsoft Foundry](https://code.claude.com/docs/id/microsoft-foundry.md), atur variabel lingkungan yang diperlukan sebelum menjalankan `claude`, atau pilih **3rd-party platform** di prompt login, yang meluncurkan wizard pengaturan interaktif untuk Bedrock dan Vertex AI. Tidak diperlukan login browser.29* **Penyedia cloud**: jika organisasi Anda menggunakan [Amazon Bedrock](https://code.claude.com/docs/id/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/id/google-vertex-ai.md), atau [Microsoft Foundry](https://code.claude.com/docs/id/microsoft-foundry.md), atur variabel lingkungan yang diperlukan sebelum menjalankan `claude`, atau pilih **3rd-party platform** di prompt login, yang meluncurkan wizard pengaturan interaktif untuk Bedrock dan Vertex AI. Tidak diperlukan login browser.

2534. Output skrip [`apiKeyHelper`](https://code.claude.com/docs/id/settings-reference#apikeyhelper). Gunakan ini untuk kredensial dinamis atau berputar, seperti token berumur pendek yang diambil dari vault.2534. Output skrip [`apiKeyHelper`](https://code.claude.com/docs/id/settings-reference#apikeyhelper). Gunakan ini untuk kredensial dinamis atau berputar, seperti token berumur pendek yang diambil dari vault.

2545. Variabel lingkungan `CLAUDE_CODE_OAUTH_TOKEN`. Token OAuth berumur panjang yang dihasilkan oleh [`claude setup-token`](#generate-a-long-lived-token). Gunakan ini untuk pipeline CI dan skrip di mana login browser tidak tersedia. Jika Anda menjalankan `/login` saat variabel diatur, Claude Code beralih sesi saat ini ke login baru, tetapi membaca variabel lagi di setiap sesi baru sampai Anda menghapusnya dari profil shell atau blok `env` dari [file pengaturan](https://code.claude.com/docs/id/settings.md).2545. Variabel lingkungan `CLAUDE_CODE_OAUTH_TOKEN`. Token OAuth berumur panjang yang dihasilkan oleh [`claude setup-token`](#generate-a-long-lived-token). Gunakan ini untuk pipeline CI dan skrip di mana login browser tidak tersedia. Jika Anda menjalankan `/login` saat variabel diatur, Claude Code beralih sesi saat ini ke login baru, tetapi membaca variabel lagi di setiap sesi baru sampai Anda menghapusnya dari profil shell atau blok `env` dari [file pengaturan](https://code.claude.com/docs/id/settings.md).

2556. Kredensial profil Anthropic dan federasi, kredensial yang digunakan CLI `ant` dan Workload Identity Federation. Profil yang ditulis `ant auth login` hanya menempati peringkat di sini ketika Anda menamakannya di `ANTHROPIC_PROFILE`; jika tidak, itu menempati peringkat di bawah `/login`. Lihat [Profil Anthropic dan kredensial federasi](#anthropic-profiles-and-federation-credentials).2556. Kredensial profil Anthropic dan federasi, kredensial yang digunakan CLI `ant` dan Workload Identity Federation. Profil yang ditulis `ant auth login` hanya menempati peringkat di sini ketika Anda menamakannya di `ANTHROPIC_PROFILE`; jika tidak, itu menempati peringkat di bawah `/login`. Lihat [Profil Anthropic dan kredensial federasi](#anthropic-profiles-and-federation-credentials).

2567. Kredensial OAuth langganan dari `/login`. Ini adalah default untuk pengguna Claude Pro, Max, Team, dan Enterprise.2567. Kredensial OAuth langganan dari `/login`. Ini adalah default untuk pengguna Claude Pro, Max, Ultra, Team, dan Enterprise.

257 257 

258Sesi [gateway aplikasi Claude](https://code.claude.com/docs/id/claude-apps-gateway) yang sudah masuk berada di luar daftar ini: ini adalah pemilihan penyedia seperti Amazon Bedrock atau Agent Platform Google Cloud, dan itu mengungguli mereka. Ketika sesi gateway ada, CLI melakukan autentikasi dengan token gateway bahkan jika `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, atau `CLAUDE_CODE_USE_FOUNDRY` diatur, dan sumber kredensial di atas seperti token bearer, kunci API, `apiKeyHelper`, dan profil tidak digunakan.258Sesi [gateway aplikasi Claude](https://code.claude.com/docs/id/claude-apps-gateway) yang sudah masuk berada di luar daftar ini: ini adalah pemilihan penyedia seperti Amazon Bedrock atau Agent Platform Google Cloud, dan itu mengungguli mereka. Ketika sesi gateway ada, CLI melakukan autentikasi dengan token gateway bahkan jika `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, atau `CLAUDE_CODE_USE_FOUNDRY` diatur, dan sumber kredensial di atas seperti token bearer, kunci API, `apiKeyHelper`, dan profil tidak digunakan.

259 259 

300 300 

301Perintah membuka alur otorisasi browser yang sama seperti `/login`, dan token dicetak ke terminal setelah Anda menyetujui akses di browser. Itu tidak menyimpan token di mana pun; salin dan atur sebagai variabel lingkungan `CLAUDE_CODE_OAUTH_TOKEN` di mana pun Anda ingin melakukan autentikasi:301Perintah membuka alur otorisasi browser yang sama seperti `/login`, dan token dicetak ke terminal setelah Anda menyetujui akses di browser. Itu tidak menyimpan token di mana pun; salin dan atur sebagai variabel lingkungan `CLAUDE_CODE_OAUTH_TOKEN` di mana pun Anda ingin melakukan autentikasi:

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 

321Token ini melakukan autentikasi dengan langganan Claude Anda dan memerlukan paket Pro, Max, Team, atau Enterprise. Itu hanya dapat membuat permintaan model, jadi itu tidak dapat membuat sesi [Remote Control](https://code.claude.com/docs/id/remote-control.md) atau mengambil [konektor claude.ai](https://code.claude.com/docs/id/mcp.md#use-mcp-servers-from-claude-ai). Server MCP yang Anda konfigurasi secara lokal masih berfungsi.321Token ini melakukan autentikasi dengan langganan Claude Anda dan memerlukan paket Pro, Max, Ultra, Team, atau Enterprise. Itu hanya dapat membuat permintaan model, jadi itu tidak dapat membuat sesi [Remote Control](https://code.claude.com/docs/id/remote-control.md) atau mengambil [konektor claude.ai](https://code.claude.com/docs/id/mcp.md#use-mcp-servers-from-claude-ai). Server MCP yang Anda konfigurasi secara lokal masih berfungsi.

322 322 

323[Mode bare](https://code.claude.com/docs/id/headless.md#start-faster-with-bare-mode) tidak membaca `CLAUDE_CODE_OAUTH_TOKEN`. Jika skrip Anda melewatkan `--bare`, lakukan autentikasi dengan `ANTHROPIC_API_KEY` atau `apiKeyHelper` sebagai gantinya.323[Mode bare](https://code.claude.com/docs/id/headless.md#start-faster-with-bare-mode) tidak membaca `CLAUDE_CODE_OAUTH_TOKEN`. Jika skrip Anda melewatkan `--bare`, lakukan autentikasi dengan `ANTHROPIC_API_KEY` atau `apiKeyHelper` sebagai gantinya.

43 43 

44## Mengapa pemberitahuan muncul44## Mengapa pemberitahuan muncul

45 45 

46[Tinjauan classifier sisi server](https://code.claude.com/docs/id/permission-modes.md#server-side-classifier-review) mencantumkan sesi mana yang meminta server untuk pemeriksaan classifier. Paket Pro, Max, dan Team tidak pernah menampilkan pemberitahuan. Ketika muncul, penyebab umum adalah:46Pada paket Pro, Max, Ultra, atau Team, Anda tidak pernah melihat pemberitahuan ini. Untuk mengetahui sesi mana yang meminta server untuk pemeriksaan pengklasifikasi, lihat [Tinjauan pengklasifikasi sisi server](https://code.claude.com/docs/id/permission-modes.md#server-side-classifier-review). Jika Anda melihat pemberitahuan ini, periksa penyebab umum berikut:

47 47 

48* **Gateway LLM atau proxy berada di jalur**: yang menghapus atau menulis ulang header permintaan, menghilangkan bidang permintaan yang tidak dikenalinya, atau mengedit respons. Server kemudian tidak pernah menerima permintaan untuk pemeriksaan, atau Claude Code tidak pernah menerima hasilnya. Ketika konfigurasi Anda atau respons mengidentifikasi gateway, pemberitahuan menamakannya.48* **Gateway LLM atau proxy berada di jalur**: yang menghapus atau menulis ulang header permintaan, menghilangkan bidang permintaan yang tidak dikenalinya, atau mengedit respons. Server kemudian tidak pernah menerima permintaan untuk pemeriksaan, atau Claude Code tidak pernah menerima hasilnya. Ketika konfigurasi Anda atau respons mengidentifikasi gateway, pemberitahuan menamakannya.

49* **Pemeriksaan sisi server belum mencapai platform, wilayah, atau kredensial Anda**: apakah platform atau wilayah melakukannya tergantung pada peluncuran platform tersebut. Jika Anda melihat pemberitahuan tanpa gateway atau proxy di jalur dan terus muncul, ini kemungkinan penyebabnya. Untuk mengonfirmasi, hubungi dukungan atau admin perusahaan Anda, atau laporkan dengan `/feedback`.49* **Pemeriksaan sisi server belum mencapai platform, wilayah, atau kredensial Anda**: apakah platform atau wilayah melakukannya tergantung pada peluncuran platform tersebut. Jika Anda melihat pemberitahuan tanpa gateway atau proxy di jalur dan terus muncul, ini kemungkinan penyebabnya. Untuk mengonfirmasi, hubungi dukungan atau admin perusahaan Anda, atau laporkan dengan `/feedback`.

161 161 

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

163>163>

164> `/auto-mode-setup` tersedia pada paket Pro, Max, Team, dan Enterprise serta dengan kunci API Claude Console. Pada paket Pro, Max, atau Team, Anda memerlukan v2.1.228 atau yang lebih baru, atau v2.1.233 atau yang lebih baru di Windows native. Pada paket Enterprise atau dengan kunci API Claude Console, Anda memerlukan v2.1.283 atau yang lebih baru. Jika perintah ini tidak tersedia di sesi Anda, lihat [`/auto-mode-setup` mengembalikan "Unknown command"](#auto-mode-setup-returns-unknown-command).164> `/auto-mode-setup` tersedia pada paket Pro, Max, Ultra, Team, dan Enterprise serta dengan kunci API Claude Console. Pada paket Pro, Max, Ultra, atau Team, Anda memerlukan v2.1.228 atau yang lebih baru, atau v2.1.233 atau yang lebih baru di Windows native. Pada paket Enterprise atau dengan kunci API Claude Console, Anda memerlukan v2.1.283 atau yang lebih baru. Jika perintah ini tidak tersedia di sesi Anda, lihat [`/auto-mode-setup` mengembalikan "Unknown command"](#auto-mode-setup-returns-unknown-command).

165 165 

166### Apa yang dibaca oleh `/auto-mode-setup`166### Apa yang dibaca oleh `/auto-mode-setup`

167 167 

489 489 

490Dengan window 1M token pada sebagian besar model saat ini dan compaction di dekat batas atasnya, Anda jarang akan kehabisan konteks. Namun, Anda tetap dapat *membayar* untuk konteks yang tidak Anda butuhkan. Setiap permintaan mengirim seluruh percakapan, sehingga sesi yang telah mengumpulkan tiga tugas yang tidak terkait akan membaca ulang ketiganya pada setiap giliran tugas keempat. Biaya itu [didiskon selama cache masih hangat](https://code.claude.com/docs/id/costs.md#why-usage-climbs-in-a-long-session) dan dikenakan harga penuh setelah cache kedaluwarsa.490Dengan window 1M token pada sebagian besar model saat ini dan compaction di dekat batas atasnya, Anda jarang akan kehabisan konteks. Namun, Anda tetap dapat *membayar* untuk konteks yang tidak Anda butuhkan. Setiap permintaan mengirim seluruh percakapan, sehingga sesi yang telah mengumpulkan tiga tugas yang tidak terkait akan membaca ulang ketiganya pada setiap giliran tugas keempat. Biaya itu [didiskon selama cache masih hangat](https://code.claude.com/docs/id/costs.md#why-usage-climbs-in-a-long-session) dan dikenakan harga penuh setelah cache kedaluwarsa.

491 491 

492[`/usage`](https://code.claude.com/docs/id/costs) adalah tempat pertama untuk melihat. Pada Pro, Max, Team, dan Enterprise, perintah ini merinci penggunaan Anda berdasarkan skill, subagent, plugin, dan server MCP. Perintah ini juga menandai pola seperti konteks panjang atau cache miss yang sering setelah salah satunya melewati 10% penggunaan Anda. Dari sana, perbaikan yang biasa:492[`/usage`](https://code.claude.com/docs/id/costs) adalah tempat pertama untuk melihat. Pada Pro, Max, Ultra, Team, dan Enterprise, perintah ini merinci penggunaan Anda berdasarkan skill, subagent, plugin, dan server MCP. Perintah ini juga menandai pola seperti konteks panjang atau cache miss yang sering setelah salah satunya melewati 10% penggunaan Anda. Dari sana, perbaikan yang biasa:

493 493 

494* `/clear` di antara tugas yang tidak terkait. Tidak ada biayanya, dan artinya tugas berikutnya tidak terus membayar riwayat tugas sebelumnya. `/clear oauth-migration` memberi nama sesi yang Anda tinggalkan, sehingga Anda dapat kembali ke sesi itu nanti.494* `/clear` di antara tugas yang tidak terkait. Tidak ada biayanya, dan artinya tugas berikutnya tidak terus membayar riwayat tugas sebelumnya. `/clear oauth-migration` memberi nama sesi yang Anda tinggalkan, sehingga Anda dapat kembali ke sesi itu nanti.

495* `/compact` dengan fokus, seperti `/compact keep the API changes and the test commands`. Pada sesi panjang, `/compact` sendiri merupakan permintaan besar, karena membaca seluruh percakapan untuk meringkasnya, terlebih lagi setelah cache kedaluwarsa.495* `/compact` dengan fokus, seperti `/compact keep the API changes and the test commands`. Pada sesi panjang, `/compact` sendiri merupakan permintaan besar, karena membaca seluruh percakapan untuk meringkasnya, terlebih lagi setelah cache kedaluwarsa.

24 24 

25Setiap channel yang didukung adalah plugin yang memerlukan [Bun](https://bun.sh). Untuk demo langsung dari alur plugin sebelum menghubungkan platform nyata, coba [mulai cepat fakechat](#quickstart).25Setiap channel yang didukung adalah plugin yang memerlukan [Bun](https://bun.sh). Untuk demo langsung dari alur plugin sebelum menghubungkan platform nyata, coba [mulai cepat fakechat](#quickstart).

26 26 

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

28 

29Lihat [sumber plugin Telegram](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram) lengkap.

30 

31**1. Buat bot Telegram**

32 

33Buka [BotFather](https://t.me/BotFather) di Telegram dan kirim `/newbot`. Berikan nama tampilan dan nama pengguna unik yang diakhiri dengan `bot`. Salin token yang dikembalikan BotFather.

34 

35**2. Instal plugin**

36 

37Mulai Claude Code dengan menjalankan `claude` di terminal Anda, lalu masukkan ini di prompt-nya:

38 

39```

40/plugin install telegram@claude-plugins-official

41```

42 

43Jika instalasi gagal, cocokkan pesan yang dilaporkan Claude Code:

44 

45* `Marketplace "claude-plugins-official" not found`: tambahkan marketplace dengan `/plugin marketplace add anthropics/claude-plugins-official`, kemudian coba ulang instalasi.

46* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: salinan lokal katalog marketplace Anda mungkin sudah usang. Perbarui dengan `/plugin marketplace update claude-plugins-official`, kemudian coba ulang instalasi. Jika percobaan ulang menampilkan pesan yang sama, lihat [Plugin tidak ditemukan di marketplace](https://code.claude.com/docs/id/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

47 

48Ketika instalasi meminta cakupan instalasi, pilih opsi cakupan pengguna sehingga plugin tersedia di semua proyek Anda. Periksa ringkasan instalasi: jika melaporkan `Run /reload-plugins to apply.`, lihat [Terapkan perubahan plugin tanpa memulai ulang](https://code.claude.com/docs/id/plugins/cli-reference.md#reload-plugins) untuk membuat perintah konfigurasi plugin tersedia.

49 

50**3. Konfigurasikan token Anda**

51 

52Jalankan perintah konfigurasi dengan token dari BotFather:

53 

54```

55/telegram:configure <token>

56```

57 

58Ini menyimpannya ke `~/.claude/channels/telegram/.env`. Anda juga dapat mengatur `TELEGRAM_BOT_TOKEN` di lingkungan shell Anda sebelum meluncurkan Claude Code.

59 

60**4. Mulai ulang dengan channels diaktifkan**

61 

62Keluar dari Claude Code dan mulai ulang dengan flag channel. Ini memulai plugin Telegram, yang mulai polling untuk pesan dari bot Anda:

63 

64```bash theme={null}

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

66```

67 

68**5. Pasangkan akun Anda**

69 

70Buka Telegram dan kirim pesan apa pun ke bot Anda. Bot membalas dengan kode pemasangan.

71 

72> [!NOTE]

73>28>

74> Jika bot Anda tidak merespons, pastikan Claude Code berjalan dengan `--channels` dari langkah sebelumnya. Bot hanya dapat membalas saat channel aktif.29> Lihat [sumber plugin Telegram](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram) lengkap.

75 

76Kembali di Claude Code, jalankan:

77 

78```

79/telegram:access pair <code>

80```

81 

82Kemudian kunci akses sehingga hanya akun Anda yang dapat mengirim pesan:

83 

84```

85/telegram:access policy allowlist

86```

87 

88**Discord**

89 

90Lihat [sumber plugin Discord](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/discord) lengkap.

91 

92**1. Buat bot Discord**

93 

94Buka [Portal Pengembang Discord](https://discord.com/developers/applications), klik **New Application**, dan beri nama. Di bagian **Bot**, buat nama pengguna, kemudian klik **Reset Token** dan salin token.

95 

96**2. Aktifkan Message Content Intent**

97 

98Di pengaturan bot Anda, gulir ke **Privileged Gateway Intents** dan aktifkan **Message Content Intent**.

99 

100**3. Undang bot ke server Anda**

101 

102Buka **OAuth2 > URL Generator**. Pilih scope `bot` dan aktifkan izin ini:

103 

104* View Channels

105* Send Messages

106* Send Messages in Threads

107* Read Message History

108* Attach Files

109* Add Reactions

110 

111Buka URL yang dihasilkan untuk menambahkan bot ke server Anda.

112 

113**4. Instal plugin**

114 

115Mulai Claude Code dengan menjalankan `claude` di terminal Anda, lalu masukkan ini di prompt-nya:

116 

117```

118/plugin install discord@claude-plugins-official

119```

120 

121Jika instalasi gagal, cocokkan pesan yang dilaporkan Claude Code:

122 

123* `Marketplace "claude-plugins-official" not found`: tambahkan marketplace dengan `/plugin marketplace add anthropics/claude-plugins-official`, kemudian coba ulang instalasi.

124* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: salinan lokal katalog marketplace Anda mungkin sudah usang. Perbarui dengan `/plugin marketplace update claude-plugins-official`, kemudian coba ulang instalasi. Jika percobaan ulang menampilkan pesan yang sama, lihat [Plugin tidak ditemukan di marketplace](https://code.claude.com/docs/id/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

125 

126Ketika instalasi meminta cakupan instalasi, pilih opsi cakupan pengguna sehingga plugin tersedia di semua proyek Anda. Periksa ringkasan instalasi: jika melaporkan `Run /reload-plugins to apply.`, lihat [Terapkan perubahan plugin tanpa memulai ulang](https://code.claude.com/docs/id/plugins/cli-reference.md#reload-plugins) untuk membuat perintah konfigurasi plugin tersedia.

127 

128**5. Konfigurasikan token Anda**

129 

130Jalankan perintah konfigurasi dengan token bot yang Anda salin:

131 

132```

133/discord:configure <token>

134```

135 

136Ini menyimpannya ke `~/.claude/channels/discord/.env`. Anda juga dapat mengatur `DISCORD_BOT_TOKEN` di lingkungan shell Anda sebelum meluncurkan Claude Code.

137 

138**6. Mulai ulang dengan channels diaktifkan**

139 

140Keluar dari Claude Code dan mulai ulang dengan flag channel. Ini menghubungkan plugin Discord sehingga bot Anda dapat menerima dan merespons pesan:

141 

142```bash theme={null}

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

144```

145 

146**7. Pasangkan akun Anda**

147 

148DM bot Anda di Discord. Bot membalas dengan kode pemasangan.

149 

150> [!NOTE]

151>30>

152> Jika bot Anda tidak merespons, pastikan Claude Code berjalan dengan `--channels` dari langkah sebelumnya. Bot hanya dapat membalas saat channel aktif.31> **1. Buat bot Telegram**

153 

154Kembali di Claude Code, jalankan:

155 

156```

157/discord:access pair <code>

158```

159 

160Kemudian kunci akses sehingga hanya akun Anda yang dapat mengirim pesan:

161 

162```

163/discord:access policy allowlist

164```

165 

166**iMessage**

167 

168Lihat [sumber plugin iMessage](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/imessage) lengkap.

169 

170Channel iMessage membaca database Messages Anda secara langsung dan mengirim balasan melalui AppleScript. Ini memerlukan macOS dan tidak memerlukan token bot atau layanan eksternal.

171 

172**1. Berikan Full Disk Access**

173 

174Database Messages di `~/Library/Messages/chat.db` dilindungi oleh macOS. Pertama kali server membacanya, macOS meminta akses: klik **Allow**. Permintaan tersebut menyebutkan aplikasi mana pun yang meluncurkan Bun, seperti Terminal, iTerm, atau IDE Anda.

175 

176Jika permintaan tidak muncul atau Anda mengklik Don't Allow, berikan akses secara manual di bawah **System Settings > Privacy & Security > Full Disk Access** dan tambahkan terminal Anda. Tanpa ini, server keluar segera dengan `authorization denied`.

177 

178**2. Instal plugin**

179 

180Mulai Claude Code dengan menjalankan `claude` di terminal Anda, lalu masukkan ini di prompt-nya:

181 

182```

183/plugin install imessage@claude-plugins-official

184```

185 

186Jika instalasi gagal, cocokkan pesan yang dilaporkan Claude Code:

187 

188* `Marketplace "claude-plugins-official" not found`: tambahkan marketplace dengan `/plugin marketplace add anthropics/claude-plugins-official`, kemudian coba ulang instalasi.

189* `Plugin "<name>" not found in marketplace "claude-plugins-official"`: salinan lokal katalog marketplace Anda mungkin sudah usang. Perbarui dengan `/plugin marketplace update claude-plugins-official`, kemudian coba ulang instalasi. Jika percobaan ulang menampilkan pesan yang sama, lihat [Plugin tidak ditemukan di marketplace](https://code.claude.com/docs/id/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

190 

191Ketika instalasi meminta cakupan instalasi, pilih opsi cakupan pengguna sehingga plugin tersedia di semua proyek Anda.

192 

193Jika ringkasan instalasi melaporkan `Run /reload-plugins to apply.`, Anda tidak perlu bertindak di sini, karena memulai ulang di langkah berikutnya akan memuat plugin.

194 

195**3. Mulai ulang dengan channels diaktifkan**

196 

197Keluar dari Claude Code dan mulai ulang dengan flag channel:

198 

199```bash theme={null}

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

201```

202 

203**4. Kirim pesan ke diri sendiri**

204 

205Buka Messages di perangkat apa pun yang masuk ke Apple ID Anda dan kirim pesan ke diri sendiri. Pesan tersebut mencapai Claude segera: obrolan mandiri melewati kontrol akses tanpa pengaturan.

206 

207> [!NOTE]

208>32>

209> Balasan pertama yang Claude kirim memicu permintaan Automation macOS yang menanyakan apakah terminal Anda dapat mengontrol Messages. Klik **OK**.33> Buka [BotFather](https://t.me/BotFather) di Telegram dan kirim `/newbot`. Berikan nama tampilan dan nama pengguna unik yang diakhiri dengan `bot`. Salin token yang dikembalikan BotFather.

210 34>

211**5. Izinkan pengirim lain**35> **2. Instal plugin**

212 36>

213Secara default, hanya pesan Anda sendiri yang diteruskan. Untuk membiarkan kontak lain mencapai Claude, tambahkan handle mereka:37> Mulai Claude Code dengan menjalankan `claude` di terminal Anda, lalu masukkan ini di prompt-nya:

38>

39> ```

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

41> ```

42>

43> Jika instalasi gagal, cocokkan pesan yang dilaporkan Claude Code:

44>

45> * `Marketplace "claude-plugins-official" not found`: tambahkan marketplace dengan `/plugin marketplace add anthropics/claude-plugins-official`, kemudian coba ulang instalasi.

46> * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: salinan lokal katalog marketplace Anda mungkin sudah usang. Perbarui dengan `/plugin marketplace update claude-plugins-official`, kemudian coba ulang instalasi. Jika percobaan ulang menampilkan pesan yang sama, lihat [Plugin tidak ditemukan di marketplace](https://code.claude.com/docs/id/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

47>

48> Ketika instalasi meminta cakupan instalasi, pilih opsi cakupan pengguna sehingga plugin tersedia di semua proyek Anda. Periksa ringkasan instalasi: jika melaporkan `Run /reload-plugins to apply.`, lihat [Terapkan perubahan plugin tanpa memulai ulang](https://code.claude.com/docs/id/plugins/cli-reference.md#reload-plugins) untuk membuat perintah konfigurasi plugin tersedia.

49>

50> **3. Konfigurasikan token Anda**

51>

52> Jalankan perintah konfigurasi dengan token dari BotFather:

53>

54> ```

55> /telegram:configure <token>

56> ```

57>

58> Ini menyimpannya ke `~/.claude/channels/telegram/.env`. Anda juga dapat mengatur `TELEGRAM_BOT_TOKEN` di lingkungan shell Anda sebelum meluncurkan Claude Code.

59>

60> **4. Mulai ulang dengan channels diaktifkan**

61>

62> Keluar dari Claude Code dan mulai ulang dengan flag channel. Ini memulai plugin Telegram, yang mulai polling untuk pesan dari bot Anda:

63>

64> ```bash theme={null}

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

66> ```

67>

68> **5. Pasangkan akun Anda**

69>

70> Buka Telegram dan kirim pesan apa pun ke bot Anda. Bot membalas dengan kode pemasangan.

71>

72> > [!NOTE]

73> >

74> > Jika bot Anda tidak merespons, pastikan Claude Code berjalan dengan `--channels` dari langkah sebelumnya. Bot hanya dapat membalas saat channel aktif.

75>

76> Kembali di Claude Code, jalankan:

77>

78> ```

79> /telegram:access pair <code>

80> ```

81>

82> Kemudian kunci akses sehingga hanya akun Anda yang dapat mengirim pesan:

83>

84> ```

85> /telegram:access policy allowlist

86> ```

214 87 

215```88> [tab] Discord

216/imessage:access allow +1555123456789>

217```90> Lihat [sumber plugin Discord](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/discord) lengkap.

91>

92> **1. Buat bot Discord**

93>

94> Buka [Portal Pengembang Discord](https://discord.com/developers/applications), klik **New Application**, dan beri nama. Di bagian **Bot**, buat nama pengguna, kemudian klik **Reset Token** dan salin token.

95>

96> **2. Aktifkan Message Content Intent**

97>

98> Di pengaturan bot Anda, gulir ke **Privileged Gateway Intents** dan aktifkan **Message Content Intent**.

99>

100> **3. Undang bot ke server Anda**

101>

102> Buka **OAuth2 > URL Generator**. Pilih scope `bot` dan aktifkan izin ini:

103>

104> * View Channels

105> * Send Messages

106> * Send Messages in Threads

107> * Read Message History

108> * Attach Files

109> * Add Reactions

110>

111> Buka URL yang dihasilkan untuk menambahkan bot ke server Anda.

112>

113> **4. Instal plugin**

114>

115> Mulai Claude Code dengan menjalankan `claude` di terminal Anda, lalu masukkan ini di prompt-nya:

116>

117> ```

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

119> ```

120>

121> Jika instalasi gagal, cocokkan pesan yang dilaporkan Claude Code:

122>

123> * `Marketplace "claude-plugins-official" not found`: tambahkan marketplace dengan `/plugin marketplace add anthropics/claude-plugins-official`, kemudian coba ulang instalasi.

124> * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: salinan lokal katalog marketplace Anda mungkin sudah usang. Perbarui dengan `/plugin marketplace update claude-plugins-official`, kemudian coba ulang instalasi. Jika percobaan ulang menampilkan pesan yang sama, lihat [Plugin tidak ditemukan di marketplace](https://code.claude.com/docs/id/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

125>

126> Ketika instalasi meminta cakupan instalasi, pilih opsi cakupan pengguna sehingga plugin tersedia di semua proyek Anda. Periksa ringkasan instalasi: jika melaporkan `Run /reload-plugins to apply.`, lihat [Terapkan perubahan plugin tanpa memulai ulang](https://code.claude.com/docs/id/plugins/cli-reference.md#reload-plugins) untuk membuat perintah konfigurasi plugin tersedia.

127>

128> **5. Konfigurasikan token Anda**

129>

130> Jalankan perintah konfigurasi dengan token bot yang Anda salin:

131>

132> ```

133> /discord:configure <token>

134> ```

135>

136> Ini menyimpannya ke `~/.claude/channels/discord/.env`. Anda juga dapat mengatur `DISCORD_BOT_TOKEN` di lingkungan shell Anda sebelum meluncurkan Claude Code.

137>

138> **6. Mulai ulang dengan channels diaktifkan**

139>

140> Keluar dari Claude Code dan mulai ulang dengan flag channel. Ini menghubungkan plugin Discord sehingga bot Anda dapat menerima dan merespons pesan:

141>

142> ```bash theme={null}

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

144> ```

145>

146> **7. Pasangkan akun Anda**

147>

148> DM bot Anda di Discord. Bot membalas dengan kode pemasangan.

149>

150> > [!NOTE]

151> >

152> > Jika bot Anda tidak merespons, pastikan Claude Code berjalan dengan `--channels` dari langkah sebelumnya. Bot hanya dapat membalas saat channel aktif.

153>

154> Kembali di Claude Code, jalankan:

155>

156> ```

157> /discord:access pair <code>

158> ```

159>

160> Kemudian kunci akses sehingga hanya akun Anda yang dapat mengirim pesan:

161>

162> ```

163> /discord:access policy allowlist

164> ```

218 165 

219Handle adalah nomor telepon dalam format `+country` atau email Apple ID seperti `user@example.com`.166> [tab] iMessage

167>

168> Lihat [sumber plugin iMessage](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/imessage) lengkap.

169>

170> Channel iMessage membaca database Messages Anda secara langsung dan mengirim balasan melalui AppleScript. Ini memerlukan macOS dan tidak memerlukan token bot atau layanan eksternal.

171>

172> **1. Berikan Full Disk Access**

173>

174> Database Messages di `~/Library/Messages/chat.db` dilindungi oleh macOS. Pertama kali server membacanya, macOS meminta akses: klik **Allow**. Permintaan tersebut menyebutkan aplikasi mana pun yang meluncurkan Bun, seperti Terminal, iTerm, atau IDE Anda.

175>

176> Jika permintaan tidak muncul atau Anda mengklik Don't Allow, berikan akses secara manual di bawah **System Settings > Privacy & Security > Full Disk Access** dan tambahkan terminal Anda. Tanpa ini, server keluar segera dengan `authorization denied`.

177>

178> **2. Instal plugin**

179>

180> Mulai Claude Code dengan menjalankan `claude` di terminal Anda, lalu masukkan ini di prompt-nya:

181>

182> ```

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

184> ```

185>

186> Jika instalasi gagal, cocokkan pesan yang dilaporkan Claude Code:

187>

188> * `Marketplace "claude-plugins-official" not found`: tambahkan marketplace dengan `/plugin marketplace add anthropics/claude-plugins-official`, kemudian coba ulang instalasi.

189> * `Plugin "<name>" not found in marketplace "claude-plugins-official"`: salinan lokal katalog marketplace Anda mungkin sudah usang. Perbarui dengan `/plugin marketplace update claude-plugins-official`, kemudian coba ulang instalasi. Jika percobaan ulang menampilkan pesan yang sama, lihat [Plugin tidak ditemukan di marketplace](https://code.claude.com/docs/id/plugins/troubleshooting.md#plugin-not-found-in-marketplace).

190>

191> Ketika instalasi meminta cakupan instalasi, pilih opsi cakupan pengguna sehingga plugin tersedia di semua proyek Anda.

192>

193> Jika ringkasan instalasi melaporkan `Run /reload-plugins to apply.`, Anda tidak perlu bertindak di sini, karena memulai ulang di langkah berikutnya akan memuat plugin.

194>

195> **3. Mulai ulang dengan channels diaktifkan**

196>

197> Keluar dari Claude Code dan mulai ulang dengan flag channel:

198>

199> ```bash theme={null}

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

201> ```

202>

203> **4. Kirim pesan ke diri sendiri**

204>

205> Buka Messages di perangkat apa pun yang masuk ke Apple ID Anda dan kirim pesan ke diri sendiri. Pesan tersebut mencapai Claude segera: obrolan mandiri melewati kontrol akses tanpa pengaturan.

206>

207> > [!NOTE]

208> >

209> > Balasan pertama yang Claude kirim memicu permintaan Automation macOS yang menanyakan apakah terminal Anda dapat mengontrol Messages. Klik **OK**.

210>

211> **5. Izinkan pengirim lain**

212>

213> Secara default, hanya pesan Anda sendiri yang diteruskan. Untuk membiarkan kontak lain mencapai Claude, tambahkan handle mereka:

214>

215> ```

216> /imessage:access allow +15551234567

217> ```

218>

219> Handle adalah nomor telepon dalam format `+country` atau email Apple ID seperti `user@example.com`.

220 220 

221## Quickstart221## Quickstart

222 222 

308| `channelsEnabled` | Master switch. Harus `true` agar channel apa pun dapat mengirimkan pesan. Memblokir semua channels termasuk bendera pengembangan saat dimatikan. Lihat [Aktifkan channels untuk organisasi Anda](#enable-channels-for-your-organization). | claude.ai Tim dan Enterprise: channels diblokir. Console: channels diizinkan kecuali organisasi Anda menerapkan pengaturan terkelola, dalam hal ini channels diblokir sampai kunci ini diatur |308| `channelsEnabled` | Master switch. Harus `true` agar channel apa pun dapat mengirimkan pesan. Memblokir semua channels termasuk bendera pengembangan saat dimatikan. Lihat [Aktifkan channels untuk organisasi Anda](#enable-channels-for-your-organization). | claude.ai Tim dan Enterprise: channels diblokir. Console: channels diizinkan kecuali organisasi Anda menerapkan pengaturan terkelola, dalam hal ini channels diblokir sampai kunci ini diatur |

309| `allowedChannelPlugins` | Plugin mana yang dapat mendaftar setelah channels diaktifkan. Menggantikan daftar yang dipertahankan Anthropic saat diatur. | Daftar default Anthropic berlaku |309| `allowedChannelPlugins` | Plugin mana yang dapat mendaftar setelah channels diaktifkan. Menggantikan daftar yang dipertahankan Anthropic saat diatur. | Daftar default Anthropic berlaku |

310 310 

311Pengguna Pro dan Max tanpa organisasi melewati pemeriksaan ini sepenuhnya: channels tersedia dan pengguna memilih per sesi dengan `--channels`.311Pengguna Pro, Max, dan Ultra tanpa organisasi melewati pemeriksaan ini sepenuhnya: channels tersedia dan pengguna memilih per sesi dengan `--channels`.

312 312 

313### Aktifkan channels untuk organisasi Anda313### Aktifkan channels untuk organisasi Anda

314 314 

39* [Google Chrome](https://www.google.com/chrome/), [Microsoft Edge](https://www.microsoft.com/edge), atau browser berbasis Chromium lainnya seperti Brave, Arc, Vivaldi, atau Opera39* [Google Chrome](https://www.google.com/chrome/), [Microsoft Edge](https://www.microsoft.com/edge), atau browser berbasis Chromium lainnya seperti Brave, Arc, Vivaldi, atau Opera

40* Ekstensi [Claude in Chrome](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) versi 1.0.36 atau lebih tinggi, tersedia di Chrome Web Store40* Ekstensi [Claude in Chrome](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) versi 1.0.36 atau lebih tinggi, tersedia di Chrome Web Store

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

42* Paket Anthropic langsung (Pro, Max, Team, atau Enterprise)42* Paket Anthropic langsung (Pro, Max, Ultra, Team, atau Enterprise)

43 43 

44Di organisasi Enterprise yang mengaktifkan HIPAA, Claude in Chrome nonaktif secara default, dan seorang [Owner](https://code.claude.com/docs/id/server-managed-settings.md#access-control) dapat mengaktifkannya di [**Organization settings > Claude in Chrome**](https://claude.ai/admin-settings/browser-extension). Business Associate Agreement (BAA) Anda dengan Anthropic tidak mencakup data yang dikirim ke situs pihak ketiga melalui Claude in Chrome. Lihat [Implementation Guide](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) untuk daftar Eligible Services.44Di organisasi Enterprise yang mengaktifkan HIPAA, Claude in Chrome nonaktif secara default, dan seorang [Owner](https://code.claude.com/docs/id/server-managed-settings.md#access-control) dapat mengaktifkannya di [**Organization settings > Claude in Chrome**](https://claude.ai/admin-settings/browser-extension). Business Associate Agreement (BAA) Anda dengan Anthropic tidak mencakup data yang dikirim ke situs pihak ketiga melalui Claude in Chrome. Lihat [Implementation Guide](https://trust.anthropic.com/resources?s=l1wrssd9hsbi4gak0tp5a6\&name=%5Banthropic%5D-hipaa-ready-offering-implementation-guide) untuk daftar Eligible Services.

45 45 

325 325 

326**7. Terapkan**326**7. Terapkan**

327 327 

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

329 329>

330Buat kluster dan grup log untuk stderr gateway, yang membawa acara audit dan log operasional. Retensi adalah panggilan terpisah, dan tanpa satu CloudWatch menyimpan log selamanya; selaraskan 90 hari dengan kebijakan retensi audit Anda:330> Buat kluster dan grup log untuk stderr gateway, yang membawa acara audit dan log operasional. Retensi adalah panggilan terpisah, dan tanpa satu CloudWatch menyimpan log selamanya; selaraskan 90 hari dengan kebijakan retensi audit Anda:

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>

339Tulis definisi tugas. Peran tugas membawa izin Bedrock dan peran eksekusi menyuntikkan rahasia; gunakan ARN rahasia dari langkah Secrets Manager:339> Tulis definisi tugas. Peran tugas membawa izin Bedrock dan peran eksekusi menyuntikkan rahasia; gunakan ARN rahasia dari langkah Secrets Manager:

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> ]

371}371> }

372```372> ```

373 373>