Bỏ qua, đến phần nội dung

Biến cấu hình ​

Trang này liệt kê biến môi trường của Phillip trên máy bạn. Biến phía máy chủ của Tara, Ryoma và Bandum, cho người tự vận hành bản cài, nằm ở trang developer. Phillip không lưu token vào file cấu hình mà để trong kho bí mật của hệ điều hành.

Thứ tự ưu tiên ​

Phillip lấy giá trị từ nguồn đứng trước, không có thì xuống nguồn kế tiếp. Thứ tự là biến môi trường, rồi phillip.lock và .claude/settings.json của dự án, rồi config.json của người dùng trong thư mục dữ liệu của Phillip, cuối cùng là giá trị mặc định đóng gói sẵn.

Thư mục dữ liệu mặc định là ~/.config/phillip trên Linux và macOS (theo XDG_CONFIG_HOME nếu bạn đặt), %APPDATA%\phillip trên Windows. Muốn đổi thì đặt PHILLIP_HOME.

Tara và đăng nhập ​

BiếnMô tả
PHILLIP_TARA_URLĐịa chỉ Tara, ví dụ https://tara.phillipcli.cloud. ph tara login --url hoặc script cài sẽ lưu giá trị này
PHILLIP_TARA_TOKENToken cá nhân của Tara, dùng cho CI hoặc máy không có kho bí mật. Ghi đè token đã lưu
PHILLIP_TARA_KEYSKhóa công khai tin cậy ed25519:<base64>, cách nhau bằng dấu phẩy. Ghi đè danh sách trong cấu hình. Để trống thì chỉ kiểm sha256
PHILLIP_TARA_COMMUNITYĐặt deny để cấm cài tài nguyên cộng đồng (chưa có người duyệt), kể cả khi có --yes. Cấm này áp cho add, install và upgrade
PHILLIP_ORGSlug của tổ chức cần dùng, cho CI. Biến này ghi đè tổ chức đã lưu bởi ph login hay ph org switch mà không đổi nó, và Phillip dùng token đã lưu cho tổ chức đó. Ví dụ: acme
PHILLIP_HOMEThư mục dữ liệu của Phillip: cấu hình, bộ đệm gói, lock cục bộ

Ryoma và Bandum ​

BiếnMô tả
PHILLIP_DOCS_URLĐịa chỉ trang tài liệu mà ph docs mở. Mặc định https://phillipcli.cloud
PHILLIP_RYOMA_URLĐịa chỉ Ryoma nhận telemetry. Mặc định lấy từ cấu hình hoặc từ script cài
PHILLIP_BANDUM_URLĐịa chỉ web Bandum local, mặc định http://localhost:8070
PHILLIP_BANDUM_BINĐường dẫn tuyệt đối tới binary Bandum build sẵn. Khi đặt biến này Phillip không tải Bandum từ Tara và không kiểm chữ ký, nên chỉ dùng lúc phát triển

Kết nối GitHub và GitLab ​

BiếnMô tả
PHILLIP_SCMTên kit SCM ép dùng (ví dụ kit-scm-gitlab), thay cho việc chọn theo host của origin
PHILLIP_GITHUB_REPOowner/repo, ghi đè repo suy từ origin
PHILLIP_GITHUB_APIĐịa chỉ API của GitHub, cho GitHub Enterprise
PHILLIP_GITLAB_APIĐịa chỉ API của GitLab tự dựng, ví dụ https://gitlab.example.com/api/v4
PHILLIP_SCM_OAUTH_CLIENTSMảng JSON cấu hình OAuth cho máy chủ lạ. Thường Tara cấp sẵn, bạn chỉ ghi đè khi phát triển
PHILLIP_SCM_PLUGINĐường dẫn thư mục kit SCM chưa phát hành, để phát triển và test
GITHUB_TOKEN, GITLAB_TOKENToken trong môi trường, được ưu tiên hơn token đã lưu. Nếu đổi token mà không thấy tác dụng, hãy kiểm tra hai biến này
PHILLIP_MCP_TOKEN_CMDMảng argv JSON thay cho lệnh ph connect token --json mà máy chủ MCP của kit SCM gọi để lấy token

Kit ​

BiếnMô tả
PHILLIP_KIT_TOKENBí mật (token bot, mật khẩu SMTP, token SCM) cho ph kit check. Lệnh không nhận bí mật qua tham số dòng lệnh để khỏi lọt vào lịch sử shell

Guardrails ​

BiếnMô tả
PHILLIP_GUARDRAILS_POLICYTên gói policy tập đoàn mà hook server nạp, mặc định kit-policy-corporate. ph guardrails install ghi giá trị này vào dịch vụ
PHILLIP_GUARDRAILS_REFRESH_SECChu kỳ làm mới policy, tính bằng giây. Mặc định 900, tức 15 phút
PHILLIP_GUARDRAILS_POLICY_DIRThư mục gói policy cục bộ để soạn và thử. Biến này bỏ qua Tara nên đừng dùng khi cài thật
PHILLIP_GUARDRAILS_AUDIT_UPLOADĐặt on để gửi audit đã che về kho tập trung. Mặc định tắt, tổ chức quyết định bật thì mới đặt
PHILLIP_GUARDRAILS_DEVICE_FILEĐường dẫn file cấp máy chứa token thiết bị của tổ chức. ph guardrails install ghi file khi nhận token thiết bị và đặt biến này vào dịch vụ. Hook server chỉ dùng token khi chưa ai đăng nhập Tara hoặc đăng nhập bị từ chối, và chỉ gửi tới đúng địa chỉ Tara đã ghi trong file
PHILLIP_GUARDRAILS_DEVICE_TOKEN, PHILLIP_GUARDRAILS_DEVICE_ORGToken thiết bị (tara_dev_...) và slug tổ chức mà ph guardrails install đọc khi không có --device-token hay --device-token-file. Gói MDM dùng hai biến này để token không nằm trong danh sách tiến trình

sudo ph guardrails install thường ghi sẵn các biến này vào cấu hình dịch vụ của máy, nên bạn hiếm khi phải tự đặt.

Claude Code và kho bí mật ​

BiếnMô tả
PHILLIP_CLAUDE_BINĐường dẫn Claude Code dùng thay cho bản đi kèm, để phát triển và test
PHILLIP_KEYCHAIN_SERVICETên mục trong kho bí mật, để thử mà không đụng mục thật
PHILLIP_SECRETS_DIRLưu token thành file thay cho kho bí mật, chỉ để test
PHILLIP_DPAPI_FILETrên Windows, đây là tệp token mã hóa theo tài khoản. Phillip tự đặt khi chạy

Biến Phillip đặt khi chạy Claude Code ​

Khi bạn chạy Claude Code qua ph, Phillip tự đặt vài biến cho phiên đó, bạn không cần đặt tay.

NhómÝ nghĩa
CLAUDE_CODE_ENABLE_TELEMETRY, OTEL_*Bật telemetry gửi về Ryoma. Dữ liệu gửi đi nằm ở trang Dữ liệu thu thập
PHILLIP_TARA_URLCho Claude Code biết dùng Tara nào để lấy header xác thực cho marketplace và MCP
ANTHROPIC_MODELModel theo cấu hình của người dùng, và chỉ đặt khi dự án chưa chọn model

Không đặt bí mật vào repo

Biến chứa token, mật khẩu hay khóa phải nằm trong môi trường, kho bí mật hoặc hệ thống quản lý bí mật của tổ chức. Đừng đặt chúng trong tệp bạn sẽ commit.

Đọc thêm ​