Thao tác từng bước · miễn phí
Giữ khoá API an toàn trong file .env
Khoá API là chuỗi bí mật cho phần mềm dùng tài khoản trả tiền của bạn. Ai cầm được là tiêu được tiền của bạn. Xong bạn có khoá nằm trong file .env của dự án, không lộ trong chat hay ảnh.
Cần có trước
- Tài khoản ở dịch vụ cần lấy khoá, do bạn tự đăng nhập.
- Agent mở trong thư mục dự án, ví dụ ~/hoc-agent (thao tác Mở Terminal).
6 bước
Hiểu khoá là gì và nằm ở đâu.
Khoá API, token, khoá webhook đều là mật khẩu cho máy dùng. Mỗi dịch vụ có trang quản lý riêng, thường nằm trong mục API keys, Developer hoặc Cài đặt của tài khoản. Bài học dùng dịch vụ nào sẽ chỉ trang đó. Không tìm khoá qua link lạ gửi trong tin nhắn.
Đúng khi: bạn đang ở trang quản lý khoá của đúng dịch vụ, đã tự đăng nhập.
Tạo khoá và chép một lần.
Bấm nút tạo khoá mới, đặt tên dễ nhớ theo việc, ví dụ
hoc-agent. Nhiều dịch vụ chỉ hiện khoá đầy đủ đúng một lần. Bấm chép, chưa dán vào đâu cả.Đúng khi: khoá đã chép vào bộ nhớ tạm, trang vẫn còn mở.
Nhờ agent tạo file .env trống.
Trong agent đang mở ở thư mục dự án, dán câu dưới. Agent tạo file
.envcó tên biến nhưng chưa có giá trị, và thêm.envvào.gitignoređể file không bị đẩy lên GitHub. Thay chữ trong ngoặc vuông bằng tên bài học ghi.Dán vào: Claude Code hoặc Codex đang mở trong thư mục dự án (ô nhắn có dấu >), ví dụ ~/hoc-agent.Tạo file .env trong thư mục này với biến [TEN_BIEN_KHOA]= để trống giá trị. Thêm .env vào .gitignore. Không in giá trị khoá ra chat. Báo tôi lệnh mở file .env để tự dán khoá.
Đúng khi: agent báo đã tạo .env, đã thêm vào .gitignore và đưa lệnh mở file.
Tự dán khoá vào file .env.
Mở cửa sổ Terminal thứ hai,
cdvào đúng thư mục dự án, chạy lệnh mở file: Mac dòng đầu (mở bằng TextEdit), Windows dòng sau (mở bằng Notepad). Dán khoá ngay sau dấu=, không thêm dấu cách, không thêm ngoặc kép. Lưu file (Command + S hoặc Ctrl + S), đóng lại.Dán vào: cửa sổ Terminal (Mac) hoặc PowerShell (Windows) thứ hai, đang đứng ở thư mục dự án (ví dụ gõ cd ~/hoc-agent trước). Chỉ chạy dòng của máy bạn.open -e .env notepad .env
Lưu kết quả: khoá nằm trong file .env của thư mục dự án, không ghi vào Sổ tay. Dùng tiếp: agent và lệnh trong thư mục đó tự đọc khoá từ .env.
Đúng khi: file .env có một dòng dạng TEN_BIEN=chuỗi khoá, đã lưu.
Giữ khoá ngoài chat và ảnh.
Không dán khoá vào ô chat với agent, ChatGPT, Claude hay nhóm Telegram. Trước khi chụp màn hình nộp bài, đóng file .env và che chỗ có khoá. Nhờ agent kiểm thì bảo nó chỉ báo tên file và số dòng, không in giá trị.
Đúng khi: không ảnh chụp hay tin nhắn nào của bạn chứa chuỗi khoá.
Đổi khoá ngay khi lỡ lộ.
Khoá đã dán vào chat, lọt vào ảnh, gửi trong file hay đưa lên mạng thì coi như lộ. Vào lại trang quản lý khoá, xoá hoặc thu hồi khoá cũ (thường có nút Delete hoặc Revoke), tạo khoá mới, rồi làm lại bước 4 để thay giá trị trong .env.
Đúng khi: khoá cũ đã bị xoá trên trang dịch vụ và .env chứa khoá mới.
Lỗi hay gặp
- Dán khoá vào chat để nhờ agent cài cho nhanh. Khoá đã nằm trong lịch sử chat. Đổi khoá theo bước 6, rồi tự dán khoá mới vào .env.
- Không thấy file .env trong Finder hay File Explorer. File bắt đầu bằng dấu chấm bị ẩn. Mở bằng lệnh ở bước 4, không cần tìm bằng chuột.
- Thêm dấu cách hoặc ngoặc kép quanh khoá nên dịch vụ báo khoá sai. Mở lại .env, để dạng
TEN_BIEN=chuoikhoaliền nhau, lưu lại.