CC Switch cho Claude Code: Quản lý tài khoản, nhà cung cấp và cấu hình

CC Switch thực sự làm gì khi quản lý Claude Code

CC Switch là trình quản lý cấu hình mã nguồn mở trên máy tính dành cho các tác nhân lập trình. Các tích hợp được hỗ trợ đã mở rộng theo thời gian, vì vậy hãy kiểm tra kho mã nguồn và ghi chú phát hành hiện tại trước khi chuẩn hóa theo một danh sách cố định. Claude Code là một tích hợp chính; các phiên bản hiện tại cũng hướng đến những tác nhân lập trình dòng lệnh khác như Codex và Gemini CLI.

Đối với Claude Code, một hồ sơ nhà cung cấp thường kết hợp:

• Một điểm cuối API tương thích với Anthropic
• Một khóa API hoặc token xác thực
• Các ánh xạ mô hình hoặc giá trị môi trường liên quan đến mô hình
• Các biến môi trường bổ sung
• Các định nghĩa máy chủ MCP
• Các thiết lập Claude Code cần đi kèm hồ sơ

Điều này hữu ích khi “tài khoản” không đơn thuần là thông tin đăng nhập Anthropic. Trong các triển khai thực tế, nhà phát triển có thể luân phiên sử dụng:

• Quyền truy cập trực tiếp vào API Anthropic
• Cổng API có xác thực của một tổ chức
• Một nhà cung cấp bên thứ ba tương thích với Anthropic
• Các tài khoản thanh toán riêng cho cá nhân, môi trường tiền sản xuất và môi trường sản xuất
• Một proxy cục bộ hoặc từ xa cung cấp ngữ nghĩa yêu cầu tương thích

CC Switch tập trung các lựa chọn đó và kích hoạt cấu hình đã chọn. Công cụ này không khiến mọi điểm cuối tương thích hoạt động giống hệt nhau. Những khác biệt về tên mô hình, header xác thực, giới hạn tốc độ, bộ nhớ đệm prompt và các trường API không được hỗ trợ vẫn thuộc trách nhiệm của nhà cung cấp.

Bảng này cho thấy sự đánh đổi: CC Switch giảm lỗi thao tác, nhưng đồng thời trở thành một ứng dụng cục bộ có đặc quyền nữa.

Cài đặt và hỗ trợ nền tảng

CC Switch được phân phối qua trang GitHub Releases của dự án. Kho mã nguồn hiện mô tả khả năng hỗ trợ máy tính chạy macOS, Windows và Linux, với các bản dựng phát hành khác nhau tùy nền tảng và phiên bản. Hãy xác minh các tệp đính kèm trong bản phát hành mà bạn định triển khai; việc có mã nguồn không bảo đảm rằng mọi phiên bản hệ điều hành, kiến trúc CPU hoặc định dạng gói đều được xây dựng cho mỗi bản phát hành.

Trên macOS, dự án cung cấp quy trình sử dụng Homebrew cask:

brew tap farion1231/cc-switch
brew install --cask cc-switch

Trước khi sử dụng một tệp nhị phân đã tải xuống trong môi trường được quản lý, hãy xác minh những gì Homebrew đã cài đặt:

brew info --cask cc-switch
brew list --cask cc-switch
codesign -dv --verbose=4 "/Applications/CC Switch.app" 2>&1

Người dùng Windows và Linux nên lấy trình cài đặt hoặc gói từ các tệp được công bố trong bản phát hành. Tên gói và các kênh phân phối có thể thay đổi, vì vậy tôi tránh đưa một lệnh có thể đã lỗi thời cho winget, Scoop, .deb hoặc AppImage vào các script khởi tạo máy trạm khi chưa ghim và kiểm thử chính xác bản phát hành đó.

Để triển khai có kiểm soát:

1. Ghim một phiên bản CC Switch.
2. Ghi lại giá trị checksum dự kiến của bản phát hành.
3. Kiểm thử với cấu hình Claude Code dùng thử có thể loại bỏ.
4. Lập danh sách tất cả các tệp bị thay đổi trong quá trình kích hoạt hồ sơ.
5. Xác định quy trình nâng cấp thay vì âm thầm chạy theo bản phát hành mới nhất.

Một bản chụp trạng thái đơn giản trước khi cài đặt sẽ hữu ích:

mkdir -p /tmp/claude-config-before
cp -R ~/.claude /tmp/claude-config-before/ 2>/dev/null || true

# Install CC Switch, create a test profile, and activate it.

diff -ru /tmp/claude-config-before/.claude ~/.claude || true

Cách này phát hiện những hành vi mà tài liệu có thể bỏ sót, bao gồm việc định dạng bị viết lại, các trường bị xóa hoặc các mục MCP được hợp nhất ở phạm vi ngoài dự kiến.

Tạo và chuyển đổi hồ sơ nhà cung cấp

Một hồ sơ nên đại diện cho một ngữ cảnh bảo mật và thanh toán nhất quán. Tôi sử dụng những tên thể hiện rõ tác động, chẳng hạn như:

• anthropic-personal
• company-gateway-dev
• customer-a-restricted
• local-proxy-test

Tránh các nhãn như default-2. Khi xảy ra sự cố trong môi trường sản xuất, tên hồ sơ đang hoạt động phải trả lời được câu hỏi “yêu cầu này sẽ được gửi đến đâu?” mà không cần mở trình soạn thảo.

Một hồ sơ Claude Code sử dụng cổng tương thích với Anthropic có thể tạo ra các thiết lập về mặt khái niệm tương tự như:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai-gateway.example.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "${TOKEN_MANAGED_BY_PROFILE}",
    "ANTHROPIC_MODEL": "company-claude-default"
  },
  "permissions": {
    "defaultMode": "default"
  }
}

Các biến chính xác cần dùng phụ thuộc vào nhà cung cấp và phiên bản Claude Code. Một số dịch vụ yêu cầu ANTHROPIC_API_KEY; một số tích hợp cổng sử dụng ANTHROPIC_AUTH_TOKEN. Đừng điền cả hai chỉ để xác thực “có khả năng” hoạt động cao hơn. Hãy xác định thông tin xác thực nào được Claude Code ưu tiên, vì một giá trị cũ có mức ưu tiên cao hơn có thể khiến yêu cầu được gửi bằng sai tài khoản.

Sau khi chuyển đổi, hãy khởi chạy một tiến trình Claude Code mới :

claude

Điều thực sự xảy ra khi bạn chuyển đổi trong lúc Claude Code đang chạy rất dễ bị hiểu nhầm. Tiện ích có thể cập nhật các tệp trên đĩa, nhưng không thể thay thế một cách đáng tin cậy các giá trị môi trường mà tiến trình đang chạy đã kế thừa. Vì vậy, các phiên hiện có có thể tiếp tục sử dụng nhà cung cấp ban đầu cho đến khi được khởi động lại.

Xác minh cấu hình thực tế đang có hiệu lực mà không in ra các bí mật:

python3 - <<'PY'
import json
from pathlib import Path

path = Path.home() / ".claude" / "settings.json"
data = json.loads(path.read_text())
env = data.get("env", {})

for key, value in sorted(env.items()):
    if "KEY" in key or "TOKEN" in key or "SECRET" in key:
        value = "<redacted>"
    print(f"{key}={value}")
PY

Một lỗi thường gặp là chỉ kiểm tra xem Claude có phản hồi hay không. Một proxy tương thích có thể trả về phản hồi hợp lệ trong khi âm thầm ánh xạ mô hình bạn yêu cầu sang một mô hình khác. Hãy xác minh nhật ký yêu cầu của nhà cung cấp hoặc nhật ký kiểm toán của cổng khi danh tính mô hình là yếu tố quan trọng.

Thiết lập MCP trên nhiều tác nhân

Cấu hình MCP là nơi việc quản lý tập trung trở nên hữu ích hơn một công cụ chọn token. Nhà phát triển có thể cấu hình các máy chủ hệ thống tệp, theo dõi vấn đề, cơ sở dữ liệu và trình duyệt trên nhiều tác nhân, mỗi tác nhân có lược đồ hoặc vị trí lưu trữ riêng.

Một định nghĩa máy chủ MCP điển hình chứa một lệnh và các đối số:

{
  "mcpServers": {
    "project-files": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/alex/work/customer-a"
      ]
    }
  }
}

Hãy coi đây là cấu hình có thể thực thi. Việc kích hoạt hồ sơ có thể cho phép một tác nhân khởi chạy npx, thực thi một gói và cung cấp thư mục được chỉ định cho lớp công cụ mà mô hình có thể truy cập.

Trong thực tế, tôi tách các hồ sơ MCP theo mức độ nhạy cảm của kho mã nguồn:

• Một hồ sơ chung cung cấp quyền truy cập vào tài liệu và các công cụ ít rủi ro.
• Một hồ sơ khách hàng chỉ cung cấp quyền truy cập vào thư mục làm việc của khách hàng đó.
• Các máy chủ cơ sở dữ liệu và điều khiển môi trường sản xuất không được bật trên phạm vi toàn cục.
• Token mà máy chủ MCP sử dụng được giới hạn phạm vi độc lập với token của nhà cung cấp mô hình.

Ngoài ra, hãy so sánh kết quả do CC Switch tạo ra với lệnh MCP gốc của tác nhân nếu có. Đối với Claude Code, hãy kiểm tra các máy chủ đang hoạt động sau khi chuyển đổi:

claude mcp list

Đừng cho rằng một đối tượng MCP JSON có thể được sao chép nguyên vẹn vào mọi tác nhân lập trình. CC Switch có thể chuẩn hóa việc quản lý trong giao diện của mình, nhưng mỗi tác nhân phía sau vẫn có lược đồ, quy tắc phạm vi và hành vi vòng đời riêng.

Nơi lưu trữ thông tin xác thực

Có hai lớp lưu trữ cần kiểm toán:

1. Dữ liệu ứng dụng của CC Switch, được dùng để lưu giữ các hồ sơ.
2. Cấu hình gốc của tác nhân lập trình, được ghi hoặc cập nhật khi một hồ sơ được kích hoạt.

CC Switch sử dụng bộ nhớ lưu trữ ứng dụng cục bộ thay vì dịch vụ tài khoản được lưu trữ trên máy chủ. Đường dẫn chính xác phụ thuộc vào nền tảng và đã thay đổi trong quá trình phát triển ứng dụng, vì vậy hãy xác định đường dẫn từ bản dựng đã cài đặt thay vì dựa vào đường dẫn sao chép từ một báo cáo vấn đề cũ. Các thư mục gốc lưu dữ liệu ứng dụng phổ biến của hệ điều hành là:

macOS:   ~/Library/Application Support/
Windows: %APPDATA%
Linux:   ~/.local/share/ or an XDG data directory

Tìm kiếm mà không xuất nội dung thông tin xác thực:

find "$HOME/Library/Application Support" \
  -maxdepth 3 -iname '*cc*switch*' -print 2>/dev/null

find "${XDG_DATA_HOME:-$HOME/.local/share}" \
  -maxdepth 3 -iname '*cc*switch*' -print 2>/dev/null

Đối với Claude Code, hãy xem xét ~/.claude/, đặc biệt là settings.json, cùng với cấu hình Claude ở cấp dự án nếu có. Các tác nhân khác thường sử dụng những thư mục riêng như ~/.codex/ hoặc ~/.gemini/, nhưng tên tệp và định dạng thông tin xác thực phụ thuộc vào phiên bản tác nhân.

Đừng cho rằng “được lưu cục bộ” có nghĩa là “được mã hóa”. Trừ khi phiên bản CC Switch bạn đã cài đặt sử dụng rõ ràng kho thông tin xác thực của hệ điều hành cho bí mật liên quan, hãy coi cơ sở dữ liệu của ứng dụng và các tệp tác nhân được tạo ra là những dữ liệu mà tài khoản người dùng của bạn có thể đọc ở dạng văn bản thuần. Hãy xác nhận bằng cách kiểm tra tệp và rà soát mã nguồn trong kho lưu trữ, đồng thời cẩn thận để không dán bí mật vào terminal, phiếu hỗ trợ hoặc phiên trò chuyện.

Hệ quả bảo mật của việc truy cập token trên máy tính

CC Switch tất yếu hoạt động với quyền của tài khoản người dùng trên máy tính của bạn. Nếu tài khoản đó có thể đọc một token, phần mềm độc hại hoặc một tiến trình khác chạy dưới cùng tài khoản người dùng cũng có thể đọc được token đó. CC Switch không loại bỏ các yêu cầu về bảo mật thiết bị đầu cuối.

Các rủi ro chính gồm:

• Tập trung thông tin xác thực: Nhiều token của các nhà cung cấp có thể cùng tồn tại trong một kho hồ sơ cục bộ.
• Ghi đè cấu hình: Việc kích hoạt hồ sơ có thể thay thế hoặc hợp nhất các tệp mà tác nhân sử dụng.
• Rò rỉ qua bản sao lưu: Dữ liệu ứng dụng và các tệp dotfile có thể được đưa vào những bản sao lưu không được mã hóa.
• Kế thừa trong tiến trình: Các terminal cũ và tác nhân đang chạy có thể giữ lại thông tin xác thực trước đó.
• Thực thi MCP: Một hồ sơ có thể kích hoạt các lệnh có quyền truy cập hệ thống tệp hoặc mạng.
• Rủi ro từ chuỗi cung ứng: Việc cài đặt bản cập nhật cho phép mã mới chạy trên máy tính truy cập các token đã lưu.
• Tiết lộ qua màn hình và nhật ký: Thông tin chẩn đoán trên giao diện hoặc báo cáo lỗi có thể tiết lộ dữ liệu về điểm cuối và thông tin xác thực.

Áp dụng các biện pháp kiểm soát theo nguyên tắc đặc quyền tối thiểu cho tiện ích này:

chmod 700 ~/.claude
chmod 600 ~/.claude/settings.json

Ưu tiên token cổng có thời hạn ngắn hoặc có thể thu hồi nếu nhà cung cấp hỗ trợ. Tuyệt đối không đưa thông tin xác thực quản trị môi trường sản xuất vào một hồ sơ dùng cho tiện ích chuyển đổi. Hãy thay token sau khi ngừng sử dụng một máy; việc xóa hồ sơ không chứng minh rằng thông tin xác thực chưa từng được sao chép sang nơi khác.

Đối với triển khai trong doanh nghiệp, tôi sẽ yêu cầu:

• Các bản phát hành được cố định phiên bản và đã qua rà soát
• Mã hóa toàn bộ ổ đĩa
• Kiểm soát chặt chẽ việc xử lý bản sao lưu
• Giới hạn chi tiêu và nhật ký kiểm toán phía nhà cung cấp
• Token riêng cho từng nhà phát triển và từng môi trường
• Quy trình thu hồi được lập thành tài liệu
• Rà soát định kỳ các lệnh MCP và đường dẫn được cho phép truy cập

CC Switch phù hợp về mặt thực tiễn với các quy trình làm việc cục bộ sử dụng nhiều nhà cung cấp. Công cụ này không mặc nhiên phù hợp với những môi trường có chính sách yêu cầu bí mật được bảo vệ bằng phần cứng, thông tin xác thực tạm thời hoặc cấu hình được thực thi tập trung. Trong những trường hợp đó, cổng của doanh nghiệp cùng trình khởi chạy tích hợp trình quản lý bí mật có thể là thiết kế có cơ sở vững chắc hơn.

Những điểm thực tiễn cần ghi nhớ

• Sử dụng CC Switch khi việc chỉnh sửa thủ công lặp đi lặp lại gây ra sai sót về tài khoản, điểm cuối hoặc MCP.
• Xác nhận các gói dành cho từng nền tảng trong bản phát hành GitHub hiện tại của dự án trước khi triển khai.
• Đặt tên cho mỗi hồ sơ sao cho thể hiện được nhà cung cấp, chủ sở hữu và môi trường.
• Khởi động lại Claude Code sau khi chuyển đổi vì các tiến trình đang chạy có thể giữ lại giá trị cũ.
• Kiểm tra các tệp được tạo ra và sử dụng claude mcp list để xác minh trạng thái đang có hiệu lực.
• Coi dữ liệu cục bộ của CC Switch và cấu hình của các tác nhân sử dụng dữ liệu đó là những kho thông tin xác thực nhạy cảm.
• Giới hạn phạm vi của máy chủ MCP cẩn thận như với token API; chúng có thể thực thi lệnh và cho phép truy cập tệp.
• Cố định phiên bản phát hành, kiểm thử các thay đổi cấu hình và duy trì phương án thu hồi token.
• Không đưa thông tin xác thực môi trường sản xuất có mức ảnh hưởng lớn vào các công cụ chuyển đổi trên máy tính, trừ khi các biện pháp kiểm soát xung quanh hỗ trợ rõ ràng cho việc chấp nhận rủi ro đó.