# Claude Code Agent

## Tổng quan

Chạy Claude Code CLI dưới dạng LangBot Runner.

## Thông tin gói

- **Runner ID**: `plugin:langbot-team/ClaudeCodeAgent/default`
- **Phiên bản**: `0.1.3`
- **Kho mã nguồn**: [https://github.com/langbot-app/LangBot/tree/master/plugins/Runner/claude-code-agent](https://github.com/langbot-app/LangBot/tree/master/plugins/Runner/claude-code-agent)

## Khả năng chính

- **Đã bật**: `streaming`, `tool calling`, `knowledge retrieval`, `steering`
- **Không khai báo**: `multimodal input`, `interrupt`

## Cấu hình

| Trường | Kiểu | Bắt buộc | Mặc định |
| --- | --- | --- | --- |
| `daemon-enabled` | `boolean` | Không | false |
| `daemon-host` | `string` | Không | `127.0.0.1` |
| `daemon-port` | `integer` | Không | `8767` |
| `daemon-token` | `secret` | Không | Trống |
| `location` | `select` | Có | `local` |
| `workspace` | `string` | Không | Trống |
| `advanced-settings` | `boolean` | Không | false |
| `command` | `string` | Không | `claude` |
| `args-json` | `string` | Không | `[]` |
| `env-json` | `string` | Không | `{}` |
| `ssh-target` | `string` | Không | Trống |
| `ssh-port` | `integer` | Không | `22` |
| `daemon-id` | `string` | Không | Trống |
| `timeout` | `integer` | Không | `300` |
| `streaming` | `boolean` | Không | true |
| `reuse-session` | `boolean` | Không | true |
| `dangerously-skip-permissions` | `boolean` | Không | true |
| `knowledge-bases` | `knowledge-base-multi-selector` | Không | `[]` |
| `langbot-assets-enabled` | `boolean` | Không | true |
| `mcp-bridge-transport` | `select` | Không | `auto` |
| `mcp-servers-json` | `string` | Không | `[]` |

## Quyền Host

- **`tools`**: `detail`, `call`
- **`knowledge_bases`**: `retrieve`
- **`history`**: `page`

## Cài đặt và sử dụng

1. Cài đặt plugin từ chợ plugin LangBot.
2. Chọn Runner ID bên dưới trong bộ chọn Runner của Pipeline.
3. Điền thông tin kết nối theo bảng và lưu giá trị nhạy cảm bằng trường secret trong giao diện quản trị.

## Bảo mật và giới hạn

- Runner chỉ được dùng tài nguyên LangBot đã cấp quyền cho lần chạy hiện tại.
- Claude Code mặc định dùng `--dangerously-skip-permissions` vì LangBot chưa có luồng phê duyệt tương tác. Chỉ dùng với workspace đáng tin cậy và tài khoản hệ điều hành bị giới hạn; đặt thành false để khôi phục kiểm tra quyền thông thường.
- Tính sẵn sàng, khả năng mô hình và giới hạn tốc độ phụ thuộc vào dịch vụ bên ngoài.
- Xem hành vi nâng cao và giới hạn riêng của sản phẩm trong README tiếng Trung ở thư mục gốc hoặc README_en_US.md tiếng Anh.


> Shared runtime / daemon upgrade: [required setup and safety contract](../README.md#shared-worker-candidate--daemon-upgrade). Shared 模式必须配置独立强 token 和端口；默认本地工作目录为 `/data/workspace`。请同时升级 daemon.py 与完整 pkg 目录；旧客户端不兼容。