# 01 - Cai Dat Tung Buoc Cho May BOD

Huong dan nay dung cho mot may tinh moi cua nhan su BOD, su dung account Lark rieng.

## Buoc 0 - Copy Kit Sang May BOD

Copy ca folder:

```text
BOD_Lark_Codex_Claude_Setup_Kit
```

vao may BOD, vi du:

```text
~/Desktop/BOD_Lark_Codex_Claude_Setup_Kit
```

Mo Terminal tren may BOD:

```bash
cd "$HOME/Desktop/BOD_Lark_Codex_Claude_Setup_Kit"
```

Neu ban copy file nen `.tar.gz`, giai nen:

```bash
cd "$HOME/Desktop"
tar -xzf BOD_Lark_Codex_Claude_Setup_Kit/files/allin-lark-bod-skill-package-20260602.tar.gz
```

## Buoc 1 - Kiem Tra Node.js

Chay:

```bash
node --version
npm --version
```

Neu khong co Node.js, cai Node.js LTS tu:

```text
https://nodejs.org
```

Sau khi cai xong, dong Terminal va mo lai.

## Buoc 2 - Cai Skill Va Lark CLI Bang One-Shot Setup

Tu folder kit:

```bash
cd "$HOME/Desktop/BOD_Lark_Codex_Claude_Setup_Kit/files/allin-lark-bod-skill-package"
bash setup-bod-machine.sh
```

Script nay se:

- Copy skill `allin-lark-bod` vao `~/.codex/skills`.
- Copy skill vao `~/.agents/skills`.
- Copy vao `~/.claude/skills` neu may co folder Claude.
- Cai/cap nhat `@larksuite/cli`.
- Cai/cap nhat Lark CLI skills neu `npx skills` kha dung.

## Buoc 3 - Dang Nhap Lark Bang Account BOD

Chay lan luot:

```bash
lark-cli auth login --domain base
lark-cli auth login --domain docs
lark-cli auth login --domain im
```

Trinh duyet se mo link dang nhap. Dang nhap bang account Lark cua nhan su BOD.

Khong dung account cua nguoi khac.

## Buoc 4 - Verify Quyen Truy Cap Base

Chay:

```bash
cd "$HOME/Desktop/BOD_Lark_Codex_Claude_Setup_Kit/files/allin-lark-bod-skill-package"
bash allin-lark-bod/scripts/verify-lark-access.sh
```

Ket qua dung:

- Hien version Lark CLI.
- Hien danh sach table cua Base 1.
- Hien danh sach table cua Base 2.
- Ket thuc bang dong `OK: BOD account can access the configured Bases.`

Neu loi permission:

- Kiem tra account BOD da duoc share quyen vao Base chua.
- Can quyen toi thieu: xem Base.
- De phan tich day du, nen cap quyen doc tat ca table lien quan.

## Buoc 5 - Restart Codex / Claude Code

Sau khi cai skill, restart Codex va Claude Code de load skill moi.

## Buoc 6 - Test Trong Codex

Mo Codex va hoi:

```text
Use $allin-lark-bod to verify Lark Base access and list the key All-In business tables.
```

Test phan tich hop dong:

```text
Use $allin-lark-bod to analyze current An Khánh contracts: expiry, installment risk, missing documents, wrong branch, and action plan for BOD.
```

## Buoc 7 - Test Trong Claude Code

Mo Claude Code trong mot folder lam viec bat ky va hoi:

```text
Use the allin-lark-bod skill. Verify Lark CLI access, then analyze current All-In contract and sales risks.
```

Neu Claude Code khong tu thay skill:

1. Kiem tra folder:

```bash
ls "$HOME/.agents/skills/allin-lark-bod"
ls "$HOME/.claude/skills/allin-lark-bod"
```

2. Restart Claude Code.

3. Goi ro ten skill:

```text
Use allin-lark-bod from my installed skills.
```

## Buoc 8 - Dump Du Lieu Ve May Neu Can Phan Tich Offline

Neu muon tao local cache:

```bash
cd "$HOME/Desktop/BOD_Lark_Codex_Claude_Setup_Kit/files/allin-lark-bod-skill-package"
bash allin-lark-bod/scripts/dump-allin-bases.sh
```

Mac dinh output:

```text
./allin-base-dump
```

Chi dung cache khi realtime Lark CLI loi. Khi tra loi, phai noi ro dang dung cache.

## Buoc 9 - Cap Nhat Lark CLI Ve Sau

Chay:

```bash
npm install -g @larksuite/cli@latest
npx skills add larksuite/cli -g -y
lark-cli --version
```

Neu gap loi npm/network, chay lai trong Terminal thuong, khong chay trong sandbox.