1. Cài 1Password CLI#

Trên Windows:

1
winget install AgileBits.1Password.CLI

Sau đó vào app 1Password, chọn Settings → Developer và bật Integrate with 1Password CLI. Khi đã bật, lệnh op xác thực qua app 1Password, có thể bằng Windows Hello hay vân tay. Bạn không cần dán session token vào terminal, nên Claude Code cũng không bao giờ thấy mật khẩu chính của bạn.

2. Xuất danh sách item, chỉ lấy metadata#

1
op item list --format json > items.json

Điểm quan trọng: op item list chỉ trả về metadata như tiêu đề, URL, tag, danh mục và vault. Mật khẩu không nằm trong đó. Trường additional_information thường chứa username, nên vẫn nên coi file này là dữ liệu nhạy cảm.

Đừng dùng tính năng export đầy đủ của app (.1pux hay CSV) cho việc này, vì các file đó có chứa mật khẩu.

Bước 1: Xem cấu trúc trước khi đọc dữ liệu#

Claude không mở file ra đọc ngay. Nó viết một script nhỏ để in cấu trúc của JSON (tên khóa, kiểu dữ liệu, số lượng) mà không in giá trị nào. Nhờ đó nó biết đây là output của op item list, có 740 item, phần lớn là LOGIN, và tag cũ được phân bố ra sao.

Sau đó nó tạo một file chỉ mục gọn với tiêu đề, danh mục, domain và tag cũ, đồng thời cố ý bỏ qua additional_information vì trường đó chứa username. Nó chỉ dùng phần thông tin này để phân loại.

Bước 2: Đề xuất hệ tag#

Claude đề xuất một hệ tag phân cấp, vì 1Password hiển thị tag có dấu / thành dạng cây ở sidebar:

Việc phân loại dựa vào domain: một bảng quy tắc ánh xạ domain sang tag, trong đó domain cụ thể nhất được ưu tiên. Ví dụ ship.amazon.com được gắn Business/Shipping, signin.aws.amazon.com được gắn Tech/Cloud, còn amazon.com là Shopping. Những item mà URL bị thiếu hoặc không khớp với tiêu đề thì được chỉ định thủ công, hoặc gắn Needs Review.

Bước 3: Xem trước, chưa ghi gì#

Trước khi động vào 1Password, Claude tạo một file preview.csv gồm tiêu đề, domain, tag mới và tag cũ để mình mở bằng Excel, kèm bảng thống kê số item theo từng tag.

Nó cũng hỏi mình một quyết định mà nó không nên tự quyết: xử lý tag cũ thế nào. Lý do là op item edit --tags thay toàn bộ tag chứ không cộng thêm. Mình chọn thay hết, nhưng giữ các tag tên công ty vì chúng giúp phân biệt tài khoản của từng công ty. Mình còn bổ sung một quy tắc: tài khoản Etsy của công ty thì gắn tag công ty kèm Business/Ecommerce, không để chung với Shopping cá nhân. Claude cập nhật lại và cho mình xem preview lần nữa.

Bước 4: Kiểm tra lại dữ liệu thật trước khi ghi#

Khi mình đồng ý, Claude chưa ghi ngay mà lấy lại danh sách hiện tại từ vault và so với file export. Nó phát hiện vault chỉ còn 739 item thay vì 740: một item rác (dòng tiêu đề CSV bị import nhầm thành item name / url) đã bị xóa sau khi export. Nó bỏ qua item đó, và chỉ sửa những item có version vẫn khớp với lúc export. Cách này tránh ghi đè lên một thay đổi mình vừa làm trong app.

Bước 5: Chạy thử, và dừng lại khi có điều bất thường#

Claude chạy thử trên 5 item đại diện, gồm một login thường, một identity, một tag có ký tự & và hai secure note. Với mỗi item, script lấy hash toàn bộ nội dung trước và sau khi sửa (bỏ qua tag, version và thời gian cập nhật) để chắc chắn chỉ có tag thay đổi.

Ba item đạt, còn hai secure note thì báo hash bị thay đổi. Claude dừng lại, không chạy tiếp cho toàn bộ, và tìm nguyên nhân:

• So hai lần op item get liên tiếp thì giống hệt nhau, nên hash không tự dao động.
• Dùng op item edit --dry-run cũng không tái hiện được.
• Sửa thật một note khác, rồi so từng đường dẫn trường (chỉ in tên trường và độ dài, không in giá trị). Kết quả cho thấy chỉ có trường additional_information thay đổi, từ không có thành có. Đây là dòng tóm tắt mà 1Password tự sinh khi lưu một item trước đó chưa có. Username, password, ghi chú và custom field đều giữ nguyên.

Sau đó script được chỉnh để chấp nhận đúng thay đổi đó: additional_information được phép xuất hiện nếu trước đó chưa có, còn mọi khác biệt khác vẫn bị báo lỗi.

Bước 6: Chạy toàn bộ và đối chiếu#

Script chạy nền với 4 luồng, ghi log để chạy lại tiếp được nếu bị ngắt giữa chừng, và tự thử lại khi gặp giới hạn tần suất. Kết quả là 733/733 item thành công, không có lỗi.

Cuối cùng, Claude đọc lại toàn bộ vault và so với kế hoạch:

1
tag mismatches: 0
2
items without tags: 0
3
distinct tags live: 56 | outside plan: []
4
version bumps != 1: Counter({1: 739})
5
title changed: 0
6
urls changed: 0