mirror of https://github.com/tiennm99/ccs.git synced 2026-07-16 10:16:49 +00:00

Files

T

kaitranntt 02f299686f feat(installer): add auto PATH config for v2.2.0

- Auto shell detection (bash/zsh/fish) with PATH setup
- Unified ~/.local/bin install (no sudo required)
- ANSI colors with TTY detection, NO_COLOR support
- Security: fix shell injection, error handling
- Replace emojis with ASCII symbols
- Update 16 files: core(6), en-docs(6), vi-docs(4)

2025-11-03 01:32:37 -05:00

3.4 KiB

Raw Blame History

Hướng Dẫn Cấu Hình CCS

Cấu Hình Tự Động

Installer tự động tạo config và mẫu profile trong quá trình cài đặt:

macOS / Linux: ~/.ccs/config.json

Windows: %USERPROFILE%\.ccs\config.json

Định Dạng Cấu Hình

Cài Đặt Cơ Bản

{
  "profiles": {
    "glm": "~/.ccs/glm.settings.json",
    "default": "~/.claude/settings.json"
  }
}

Cài Đặt Nâng Cao (Nhiều Profile)

{
  "profiles": {
    "glm": "~/.ccs/glm.settings.json",
    "haiku": "~/.ccs/haiku.settings.json",
    "custom": "~/.ccs/custom.settings.json",
    "default": "~/.claude/settings.json"
  }
}

Cấu Hình Profile

Ví Dụ Profile GLM

Vị trí: ~/.ccs/glm.settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your_glm_api_key",
    "ANTHROPIC_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.6"
  }
}

Profile Claude (Mặc Định)

Sử dụng ~/.claude/settings.json (config Claude CLI hiện tại của bạn)
CCS không bao giờ sửa file này (tiếp cận không xâm phạm)

Cách Hoạt Động Cấu Hình

CCS đọc tên profile từ dòng lệnh (mặc định là "default")
Tìm đường dẫn file settings trong ~/.ccs/config.json
Thực thi claude --settings <file> [remaining-args]

Không có magic. Không sửa file. Chuyển giao thuần túy. Hoạt động giống nhau trên tất cả nền tảng.

Biến Môi Trường

CCS_CONFIG

Ghi đè vị trí config mặc định:

export CCS_CONFIG=~/my-custom-config.json
ccs glm

NO_COLOR

Tắt output màu trên terminal:

export NO_COLOR=1
ccs glm

Trường Hợp Sử Dụng:

CI/CD pipelines
Log files
Terminal không hỗ trợ màu
Tùy chọn trợ năng

Khi NO_COLOR được đặt, CCS sử dụng output ASCII thuần không có mã màu ANSI.

Lưu Ý Tùy Theo Nền Tảng

Cấu Hình Windows

Windows dùng cấu trúc file và phương pháp giống như Linux/macOS.

Định dạng config (~/.ccs/config.json):

{
  "profiles": {
    "glm": "~/.ccs/glm.settings.json",
    "default": "~/.claude/settings.json"
  }
}

Cấu Hình macOS / Linux

Sử dụng đường dẫn file settings với mở rộng ~:

{
  "profiles": {
    "glm": "~/.ccs/glm.settings.json",
    "default": "~/.claude/settings.json"
  }
}

Mỗi profile trỏ đến một file settings JSON của Claude. Tạo file settings theo tài liệu Claude CLI.

Vấn Đề Cấu Hình

Không tìm thấy profile

Error: Profile 'foo' not found in ~/.ccs/config.json

Fix: Thêm profile vào ~/.ccs/config.json:

{
  "profiles": {
    "foo": "~/.ccs/foo.settings.json"
  }
}

Thiếu file settings

Error: Settings file not found: ~/.ccs/foo.settings.json

Fix: Tạo file settings hoặc sửa đường dẫn trong config.

Thiếu profile mặc định

Error: Profile 'default' not found in ~/.ccs/config.json

Fix: Thêm profile "default" hoặc luôn chỉ định tên profile:

{
  "profiles": {
    "default": "~/.claude/settings.json"
  }
}

3.4 KiB Raw Blame History