Quản lý khóa API

Hướng dẫn này cho bạn biết mỗi thông tin xác thực mà Control Center dùng được lưu ở đâu và cách thay đổi nó.

Không có gì được lưu trên máy bạn đang gõ. Mọi thông tin xác thực đều nằm trên máy chủ; việc thông tin nào đáp ứng một yêu cầu cụ thể phụ thuộc vào có con người đứng sau yêu cầu đó hay không.

Thông tin xác thực	Nơi lưu	Ai dùng
Thông tin xác thực forge / phiếu của bạn	Tệp secret 0600 của máy chủ, khóa theo id người dùng của bạn	Mọi thứ bạn yêu cầu: bề mặt PR, các lượt chạy agent, hình ảnh của bạn
Danh tính ứng dụng của máy chủ	Cùng tệp đó, cộng thêm `server_settings` cho các phần không phải secret	Công việc không do con người yêu cầu: webhook, polling PR, đồng bộ phiếu
Khóa nhà cung cấp mô hình và token OAuth	Kho thông tin xác thực riêng của máy chủ	Adapter tích hợp sẵn, cho mọi không gian làm việc trên bản cài đặt
Token bot Slack	`<dataDir>/<workspaceId>/chat_credentials/` trên máy chủ	Cầu chat cho không gian làm việc đó
Thông tin xác thực của CLI bên ngoài	Bất cứ thứ gì CLI đó dùng	Claude Code, trên máy chạy máy chủ

Hai thông tin xác thực GitHub, và chúng trả lời những câu hỏi khác nhau

Của bạn, từ việc đăng nhập (luồng thiết bị) hoặc dán một token. Đó là thứ mà mọi yêu cầu được thực hiện thay mặt bạn dùng, nên một bình luận đăng cho bạn sẽ mang tên bạn. Thành viên khác không thể đọc nó, và họ tự kết nối thông tin xác thực của riêng mình
Của máy chủ, từ GitHub App mà người vận hành đã đăng ký. Nó đáp ứng mọi thứ không có người gọi — nhờ đó quyền truy cập forge không biến mất khi một người rời đi hoặc xoay vòng token

Cái của bạn được đặt trong thẻ Lưu trữ mã tại Cài đặt → Không gian làm việc → Hồ sơ & danh tính; còn của máy chủ trong Ứng dụng nhà cung cấp tại Cài đặt → Máy chủ → Đăng nhập một lần. Xem Thiết lập tích hợp GitHub và Tạo GitHub App.

Đặt khóa nhà cung cấp mô hình

Adapter tích hợp sẵn tự xác thực với các nhà cung cấp và những thông tin xác thực đó nằm trên máy chủ.

Vào Cài đặt → Máy chủ → Nhà cung cấp mô hình
Cuộn tới Nhà cung cấp & mô hình
Kết nối nhà cung cấp — OAuth qua trình duyệt cho OpenAI, Codex, Cursor và Kimi Code; khóa API cho Anthropic và các nhà cung cấp còn lại

Xem Quản lý adapter và mô hình để có danh sách đầy đủ và cách thêm một endpoint tùy chỉnh.

Những thông tin xác thực này là toàn cục theo máy chủ: một khóa phục vụ mọi không gian làm việc trên bản cài đặt. Token OAuth được làm mới trước khi hết hạn.

Các CLI adapter bên ngoài giữ thông tin xác thực riêng, trong cấu hình riêng của chúng, trên máy chạy máy chủ — Control Center không quản lý chúng. Hãy xác thực Claude Code theo cách tài liệu của chính nó hướng dẫn, trên máy mà cc_server chạy.

Hộp thoại Biến môi trường của từng adapter trông như một chỗ để đặt khóa cho một trong số chúng, nhưng không phải vậy: nó ghi vào thiết bị của bạn, trong khi máy chủ đọc bản sao của riêng nó và không có gì nối hai bên lại. Xem Quản lý adapter và mô hình.

Kết nối một nhà cung cấp phiếu

Thẻ Phiếu tại Cài đặt → Không gian làm việc → Chung chứa cả hai nửa của một quyết định: phiếu của bạn nằm ở nhà cung cấp nào, và thông tin xác thực cho nó. Chọn Cục bộ sẽ ẩn dòng thông tin xác thực — phiếu cục bộ nằm trong cơ sở dữ liệu riêng của máy chủ này và không có gì để xác thực.

Khóa của bạn được lưu trên máy chủ gắn với id người dùng của bạn, giống như khóa forge. Máy chủ giữ khóa Linear riêng của nó một cách tách biệt (Ứng dụng nhà cung cấp), và đó là thứ mà việc đồng bộ phiếu dùng khi không có con người yêu cầu. Không có khóa phiếu nào được chèn vào sandbox của agent; agent ghi phiếu qua các công cụ của Control Center, vốn hỏi quy tắc Ghi vào tracker bên ngoài. Xem Thiết lập tích hợp Linear.

Xoay vòng hoặc thu hồi

Thông tin xác thực GitHub của bạn: nhấn Ngắt kết nối, rồi đăng nhập lại hoặc dán token mới. Hãy thu hồi token cũ trên GitHub
Ứng dụng của máy chủ: tạo một khóa riêng tư hoặc client secret mới trên trang GitHub của ứng dụng, dán vào Ứng dụng nhà cung cấp và nhấn Kiểm thử
Một nhà cung cấp mô hình: trên dòng của nó, đăng xuất (OAuth) hoặc gỡ khóa, rồi kết nối lại
Slack: dán lại các token trong hộp thoại kết nối. Xem Thiết lập tích hợp Slack

Xử lý sự cố

Danh sách PR trống nhưng token của tôi vẫn hoạt động trong `curl`

Kiểm tra phụ đề của dòng Lưu trữ mã. Nếu nó nêu một nguồn khác (“qua ứng dụng của máy chủ này”, “từ môi trường”), thì thông tin xác thực bạn đang kiểm tra không phải là cái đang đáp ứng — cái của bạn đã không được lưu.

Token được chấp nhận nhưng các yêu cầu sau đó thất bại

Token được kiểm tra ngay khi được lưu, nên dòng đó nêu tên tài khoản đứng sau nó — nhưng chỉ tài khoản, không phải các scope. Một token có quá ít scope sẽ kết nối được rồi sau đó thất bại ở từng yêu cầu riêng lẻ. Hãy kiểm tra các scope và thời điểm hết hạn:

curl -H "Authorization: token YOUR_TOKEN" https://api.github.com/user