mirror of
https://github.com/tiennm99/ccs.git
synced 2026-07-16 12:15:57 +00:00
kaitranntt
02f299686f
- 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)
164 lines
3.4 KiB
Markdown
164 lines
3.4 KiB
Markdown
# 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
|
|
|
|
```json
|
|
{
|
|
"profiles": {
|
|
"glm": "~/.ccs/glm.settings.json",
|
|
"default": "~/.claude/settings.json"
|
|
}
|
|
}
|
|
```
|
|
|
|
### Cài Đặt Nâng Cao (Nhiều Profile)
|
|
|
|
```json
|
|
{
|
|
"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`
|
|
|
|
```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
|
|
|
|
1. CCS đọc tên profile từ dòng lệnh (mặc định là "default")
|
|
2. Tìm đường dẫn file settings trong `~/.ccs/config.json`
|
|
3. 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:
|
|
```bash
|
|
export CCS_CONFIG=~/my-custom-config.json
|
|
ccs glm
|
|
```
|
|
|
|
### NO_COLOR
|
|
|
|
Tắt output màu trên terminal:
|
|
```bash
|
|
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`):
|
|
```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 `~`:
|
|
|
|
```json
|
|
{
|
|
"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](https://docs.claude.com/en/docs/claude-code/installation).
|
|
|
|
## 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`:
|
|
```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:
|
|
```json
|
|
{
|
|
"profiles": {
|
|
"default": "~/.claude/settings.json"
|
|
}
|
|
}
|
|
``` |