๐ ็ฐไปฃๅ Claude Code ้ ็ฝฎ็ฎก็็ฅๅจ ๐
้ถ้ ็ฝฎๅฏๅจ โข ๅค็ซฏๅๆญฅ โข ๅฎๅ จๅ ๅฏ โข ไธ้ฎ้จ็ฝฒ
|
|
# ๐ฅ ไธ่กๅฝไปค๏ผ็ซๅณไฝ้ช
curl -LsSf https://astral.sh/uv/install.sh | sh && uvx qcc๐ซ ้ฆๆฌก่ฟ่ก่ชๅจๅฎๆไปฅไธ้ญๆณ
- โฌ๏ธ ่ชๅจไธ่ฝฝๆๆฐ็ๆฌ
- ๐ง ๆบ่ฝ้ๆฉๅญๅจๅ็ซฏ๏ผGitHub/ไบ็/ๆฌๅฐ๏ผ
- ๐ ๅฎๅ จ่ฎค่ฏ๏ผGitHub ่ฎพๅคๆต๏ผๆ ้ๆฌๅฐๆๅกๅจ๏ผ
- โ๏ธ ๅๅปบไบๅญๅจ๏ผๅฎๅ จๅ ๅฏ
- ๐ ๅๆญฅ้ ็ฝฎๆกฃๆก
- ๐ฏ ๆบ่ฝ้ๆฉ้ ็ฝฎ๏ผ3็ง่ถ ๆถ๏ผ
- ๐ ๅฏๅจ Claude Code
# ๐ ๏ธ ไฝฟ็จ uv๏ผๆจ่๏ผ
uv tool install qcc
# ๐ ๆไฝฟ็จ pip
pip install qccqcc fc # ๐ญ Fast Config - ๅๅ้
็ฝฎๅๅฏผgraph LR
A[๐ฏ ้ๆฉๅๅ] --> B[๐ ๆต่งๅจๆณจๅ]
B --> C[๐ ่พๅ
ฅ API Key]
C --> D[โ
็กฎ่ฎค้
็ฝฎ]
D --> E[๐ ๅฏๅจ Claude]
style A fill:#ff6b6b
style B fill:#4ecdc4
style C fill:#45b7d1
style D fill:#f9ca24
style E fill:#6c5ce7
- ๐ข Anthropic ๅฎๆน - ๅ็ Claude API
- ๐ Claude Plus - ็ฌฌไธๆนๅขๅผบๆๅก
- ๐ ๆดๅคๅๅ - ไบ็ซฏ้ ็ฝฎๅฎๆถๆดๆฐ
# ๆฌๅฐๅผๅๆต่ฏ
uvx --from . qcc # ๐ ๆบ่ฝๅฏๅจ
uvx --from . qcc fc # ๐ญ ๅๅๅฟซ้้
็ฝฎ
uvx --from . qcc init # ๐ง ๅๅงๅ่ฎพ็ฝฎ
uvx --from . qcc add work # โ ๆทปๅ ้
็ฝฎ
# ่ฟ็จๅฎ่ฃ
ไฝฟ็จ
uvx qcc # ๐ ๆบ่ฝๅฏๅจ
uvx qcc fc # ๐ญ ๅๅๅฟซ้้
็ฝฎ
uvx qcc init # ๐ง ๅๅงๅ่ฎพ็ฝฎ
uvx qcc add work # โ ๆทปๅ ้
็ฝฎ |
# ๆฌๅฐๅผๅๆต่ฏ
uvx --from . qcc list # ๐ ๆฅ็ๆๆ้
็ฝฎ
uvx --from . qcc use work # ๐ฏ ไฝฟ็จๆๅฎ้
็ฝฎ
uvx --from . qcc status # ๐ ็ณป็ป็ถๆ
uvx --from . qcc sync # ๐ ๆๅจๅๆญฅ
# ่ฟ็จๅฎ่ฃ
ไฝฟ็จ
uvx qcc list # ๐ ๆฅ็ๆๆ้
็ฝฎ
uvx qcc use work # ๐ฏ ไฝฟ็จๆๅฎ้
็ฝฎ
uvx qcc status # ๐ ็ณป็ป็ถๆ
uvx qcc sync # ๐ ๆๅจๅๆญฅ |
# ๆฌๅฐๅผๅๆต่ฏ
uvx --from . qcc default work # โญ ่ฎพ็ฝฎ้ป่ฎค้
็ฝฎ
uvx --from . qcc config # โ๏ธ ้
็ฝฎ็ฎก็๏ผๆดๆนๅญๅจๆนๅผ๏ผ
uvx --from . qcc remove old # ๐๏ธ ๅ ้ค้
็ฝฎ
uvx --from . qcc uninstall # ๐งน ๆธ
็ๆฌๅฐๆฐๆฎ๏ผไฟ็ไบ็ซฏ๏ผ
# ่ฟ็จๅฎ่ฃ
ไฝฟ็จ
uvx qcc default work # โญ ่ฎพ็ฝฎ้ป่ฎค้
็ฝฎ
uvx qcc config # โ๏ธ ้
็ฝฎ็ฎก็๏ผๆดๆนๅญๅจๆนๅผ๏ผ
uvx qcc remove old # ๐๏ธ ๅ ้ค้
็ฝฎ
uvx qcc uninstall # ๐งน ๆธ
็ๆฌๅฐๆฐๆฎ๏ผไฟ็ไบ็ซฏ๏ผ# ็ไบงๆจกๅผ๏ผๆจ่ๆฅๅธธไฝฟ็จ๏ผ
uvx qcc web start # ๅฏๅจ Web UI
uvx qcc web status # ๆฅ็็ถๆ
uvx qcc web stop # ๅๆญข๏ผ่ชๅจๆธ
็ไปฃ็ๅ้
็ฝฎ๏ผ
# ๅผๅๆจกๅผ๏ผๆจ่ไปฃ็ ๅผๅ๏ผ
uvx qcc web start --dev # ๅๅ็ซฏ็ญ้่ฝฝ
uvx qcc web stop --keep-proxy # ไฟๆไปฃ็่ฟ่ก
uvx qcc web stop --keep-config # ไฟๆ้
็ฝฎไธ่ฟๅ็นๆง๏ผ
- ๐จ ็ฐไปฃๅ React + TypeScript ็้ข
- โก ไธ้ฎๅฏๅจ๏ผ่ชๅจๆๅปบ
- ๐ฅ ๅผๅๆจกๅผๆฏๆๅๅ็ซฏ็ญ้่ฝฝ
- ๐งน ๅๆญขๆถ่ชๅจๆธ ็๏ผไปฃ็ + ้ ็ฝฎ๏ผ
- ๐ ๅฎๆถ็ๆงๅ็ฎก็
# ๆฌๅฐๅผๅๆต่ฏ
uvx --from . qcc endpoint add <config> # โ ๆทปๅ endpoint
uvx --from . qcc endpoint list <config> # ๐ ๆฅ็ endpoints
uvx --from . qcc endpoint remove <config> <id> # ๐๏ธ ๅ ้ค endpoint
# ่ฟ็จๅฎ่ฃ
ไฝฟ็จ
uvx qcc endpoint add production # โ ๆทปๅ endpoint
uvx qcc endpoint list production # ๐ ๆฅ็ endpoints
uvx qcc endpoint remove production 1 # ๐๏ธ ๅ ้ค endpoint# ๆฌๅฐๅผๅๆต่ฏ
uvx --from . qcc priority set <config> <level> # โ๏ธ ่ฎพ็ฝฎไผๅ
็บง
uvx --from . qcc priority list # ๐ ๆฅ็ไผๅ
็บง
uvx --from . qcc priority switch <config> # ๐ ๆๅจๅๆข
uvx --from . qcc priority history # ๐ ๅๆขๅๅฒ
# ่ฟ็จๅฎ่ฃ
ไฝฟ็จ
uvx qcc priority set production primary # โ๏ธ ่ฎพ็ฝฎไธป้
็ฝฎ
uvx qcc priority set backup secondary # โ๏ธ ่ฎพ็ฝฎๆฌก้
็ฝฎ
uvx qcc priority list # ๐ ๆฅ็ไผๅ
็บง |
# ๆฌๅฐๅผๅๆต่ฏ
uvx --from . qcc health test # ๐งช ๆง่กๅฅๅบทๆต่ฏ
uvx --from . qcc health status # ๐ ๆฅ็ๅฅๅบท็ถๆ
uvx --from . qcc health metrics # ๐ ๆฅ็ๆง่ฝๆๆ
# ่ฟ็จๅฎ่ฃ
ไฝฟ็จ
uvx qcc health test -v # ๐งช ่ฏฆ็ปๆต่ฏ
uvx qcc health status # ๐ ๅฅๅบท็ถๆ
uvx qcc health metrics # ๐ ๆง่ฝๆๆ # ๆฌๅฐๅผๅๆต่ฏ
uvx --from . qcc proxy start # โถ๏ธ ๅฏๅจไปฃ็
uvx --from . qcc proxy stop # โน๏ธ ๅๆญขไปฃ็
uvx --from . qcc proxy status # ๐ ๆฅ็็ถๆ
uvx --from . qcc proxy logs # ๐ ๆฅ็ๆฅๅฟ
# ่ฟ็จๅฎ่ฃ
ไฝฟ็จ
uvx qcc proxy start # โถ๏ธ ๅฏๅจไปฃ็ๆๅก
uvx qcc proxy status # ๐ ๆฅ็ไปฃ็็ถๆ
uvx qcc queue status # ๐ ๆฅ็ๅคฑ่ดฅ้ๅ |
| ๐ GitHub | โ๏ธ ไบ็ๅๆญฅ | ๐ ๆฌๅฐๅญๅจ |
|---|---|---|
| ๐ ๅ จๅนณๅฐ้็จ | ๐ฑ ๅนณๅฐ็นๅฎ | ๐ ๅฎๅ จ็งๆ |
| ๐ก๏ธ ่ฎพๅคๆต่ฎค่ฏ | ๐ ๆไปถๅๆญฅ | ๐พ ๆฌๅฐ็ผๅญ |
| ๐ ้ๅคๅฏ็จ | โก ๅฟซ้ๅๆญฅ | ๐ซ ๆ ้็ฝ็ป |
- ๐ ๅฎๅ จ่ฎค่ฏ๏ผ่ฎพๅคๆต๏ผๆ ้ๆฌๅฐๆๅกๅจ
- ๐ ๅ จๅนณๅฐ๏ผWindowsใmacOSใLinux ้็จ
- ๐ ๆฐๆฎไธปๆ๏ผๅญๅจๅจไฝ ็ GitHub ่ดฆๆท
- ๐ macOS๏ผ่ชๅจๆฃๆต iCloud Drive
- ๐ช Windows๏ผ่ชๅจๆฃๆต OneDrive
- ๐ง Linux๏ผ่ชๅจๆฃๆต Dropbox
- ๐ ๅฎๅ จ็งๆ๏ผๆ ไบ็ซฏๅๆญฅ
- ๐ ๆฌๅฐๅญๅจ๏ผ
~/.fastcc/ - ๐ ๆ้ๅฏๅจ๏ผๆ ็ฝ็ปไพ่ต
graph TD
A[๐ ็จๆทๆฐๆฎ] --> B[๐ ็ซฏๅฐ็ซฏๅ ๅฏ]
B --> C[โ๏ธ ็จๆท่ชๆๅญๅจ]
C --> D[๐ก๏ธ ้ถไฟกไปปๆถๆ]
E[๐ซ ๆ ไธญๅฟๅๆฐๆฎๅบ] --> F[๐ ๆฌๅฐๆไปถๆ้ 600]
F --> G[๐ OAuth ่ฎพๅคๆต]
G --> H[โ
ๅฎๅ
จๅฎๅ
จ]
style A fill:#ff6b6b
style B fill:#4ecdc4
style C fill:#45b7d1
style D fill:#6c5ce7
style E fill:#f9ca24
style F fill:#26de81
style G fill:#fd79a8
style H fill:#00b894
๐๏ธ QCC ๆจกๅๅๆถๆ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ฎ CLI Interface (Click) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ ๐ง Core Logic โ
โ โโโ ๐ ConfigManager โ
โ โโโ ๐ค ConfigProfile โ
โ โโโ ๐ฏ PriorityManager (v0.4.0) โ
โ โโโ ๐ FailoverManager (v0.4.0) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ ๐ Proxy Services (v0.4.0 ๆฐๅข) โ
โ โโโ ๐ ProxyServer โ
โ โโโ โ๏ธ LoadBalancer โ
โ โโโ ๐ HealthMonitor โ
โ โโโ ๐ FailureQueue โ
โ โโโ ๐ WeightAdjuster โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ ๐ญ Providers โ
โ โโโ ๐ ProvidersManager โ
โ โโโ ๐ Browser Integration โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ ๐พ Storage Backends โ
โ โโโ ๐ GitHub (OAuth/Simple) โ
โ โโโ โ๏ธ Cloud Files โ
โ โโโ ๐ Local Storage โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ ๐ Security & Utils โ
โ โโโ ๐ Cryptography โ
โ โโโ ๐ OAuth Authentication โ
โ โโโ ๐จ UI Components โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
- ๐ ๆไปถๅ๏ผๅญๅจๅ็ซฏๅฏๆฉๅฑ
- ๐ก๏ธ ๅฎๅ จ็ฌฌไธ๏ผ็ซฏๅฐ็ซฏๅ ๅฏ๏ผ็จๆทๆฐๆฎ่ชไธป
- ๐จ ็จๆทๅๅฅฝ๏ผๆบ่ฝ้ป่ฎค๏ผๆๅฐไบคไบ
- ๐ ็ฐไปฃๅ๏ผๆฏๆ uvx๏ผ้ถๅฎ่ฃ ไฝ้ช
# ๐ ๅฟซ้ๆญๅปบๅผๅ็ฏๅข
git clone https://github.com/lghguge520/qcc.git
cd qcc
# ๐ฆ ๅๅปบ่ๆ็ฏๅข๏ผๅฟ
้กปไฝฟ็จ virtualenv๏ผๅฝๅไธบ venv๏ผ
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# ๐ฅ ๅฎ่ฃ
ๅผๅไพ่ต
pip install -e ".[dev]"
# ๐งช ่ฟ่กๅผๅ็ๆฌ
python -m fastcc.cli --help# โ ๏ธ ้่ฆ๏ผๅฟ
้กปๅ
ๆต่ฏๅๅๅธ๏ผไฝฟ็จ uvx ่ฟ่กๆต่ฏ
uvx --from . qcc --help # ไฝฟ็จ uvx ๆต่ฏๆฌๅฐๅ
๏ผๆจ่๏ผ
# ๐ฌ ่ฟ่กๅๅ
ๆต่ฏ
pytest tests/ -v
# ๐ฏ ๅไธชๆต่ฏๆไปถ
pytest tests/test_providers.py -v # ๅๅ้
็ฝฎๆต่ฏ
pytest tests/test_fc_command.py -v # FC ๅฝไปคๆต่ฏ
pytest tests/test_simplified_fc.py -v # ็ฎๅๆต็จๆต่ฏ# โ ๏ธ ๅๅธๅๅฟ
้กปๅฎๆๆต่ฏ
# 1๏ธโฃ ไฝฟ็จ uvx ๆต่ฏ
uvx --from . qcc --help
# 2๏ธโฃ ๆๅปบๅ
pip install build twine
python -m build
# 3๏ธโฃ ๅๅธๅฐ PyPI
python -m twine upload dist/*| ๐ ๆไปถ | ๐ ไฝ็ฝฎ | ๐ ่ฏดๆ |
|---|---|---|
| ๐พ ๆฌๅฐ็ผๅญ | ~/.fastcc/cache.json ๆ ~/.qcc/ |
้ ็ฝฎๆกฃๆก็ผๅญ |
| ๐ GitHub Token | ~/.fastcc/github_token.json |
่ฎค่ฏไปค็ |
| โ๏ธ Claude ่ฎพ็ฝฎ | ~/.claude/settings.json |
Claude Code ้ ็ฝฎ |
| ๐ ไปฃ็ๆฅๅฟ | ~/.qcc/proxy.log |
ไปฃ็ๆๅกๅจๆฅๅฟ (v0.4.0+) |
| ๐ ๅฅๅบทๆๆ | ~/.qcc/health_metrics.json |
ๅฅๅบทๆฃๆตๆฐๆฎ (v0.4.0+) |
| ๐ ๅคฑ่ดฅ้ๅ | ~/.qcc/failure_queue.json |
ๅคฑ่ดฅ่ฏทๆฑ้ๅ (v0.4.0+) |
| ๐ Python | ๐ฆ ไพ่ต | ๐ฅ๏ธ ๅนณๅฐ |
|---|---|---|
| 3.9+ | click, requests, cryptography, rich, httpx, fastapi, uvicorn | Windows, macOS, Linux |
๐ ๆฌข่ฟ่ดก็ฎ๏ผ ๐
CC BY-NC 4.0 (็ฅ่ฏๅ ฑไบซ็ฝฒๅ-้ๅไธๆงไฝฟ็จ 4.0 ๅฝ้ ่ฎธๅฏๅ่ฎฎ)
- โ ๅ ่ฎธ: ๅคๅถใๅๅใไฟฎๆนๆฌ้กน็ฎ
- โ ๅ ่ฎธ: ไธชไบบๅญฆไน ใ็ ็ฉถไฝฟ็จ
- โ ๅ ่ฎธ: ๅผๆบ้กน็ฎไธญไฝฟ็จ
โ ๏ธ ่ฆๆฑ: ไฝฟ็จๆถๅฟ ้กป็ฝฒๅ- โ ็ฆๆญข: ๅไธไฝฟ็จ๏ผๅฆ้ๅไธๆๆ่ฏท่็ณป๏ผ
่ฏฆ่ง LICENSE ๆไปถใ
- ๐ CLI ๅฝไปคๅ่ - ๆๆๅฏ็จๅฝไปค็ๅฎๆดๅ่๏ผๅบไบๅฝๅๅฎ็ฐ๏ผ
v0.6.1 (2025-10-19) - Bug ไฟฎๅค็ๆฌ:
- ๐ v0.6.1 ๅๅธ่ฏดๆ - ไฟฎๅค่ชๅฎไน็ซฏๅฃๆถๅ็ซฏ API ๅฐๅไธๅน้ ้ฎ้ข
v0.6.0 (2025-10-19) - ้ๅคงๆง่ฝไผๅ:
- ๐ v0.6.0 ๅๅธ่ฏดๆ - httpx ่ฟ็งปใๆญ่ทฏๅจใไผ่ฏไบฒๅๆงใ้่ฏฏๅ็ฑปๅจ
- ๆ ธๅฟๆน่ฟ: ๆง่ฝๆๅ 33%๏ผ่็นๅๆข้ๅบฆๆๅ 80%๏ผ่ฏฏๅค็้ไฝ 80%
- ๆฐ็นๆง: ๆญ่ทฏๅจๆจกๅผใไผ่ฏไบฒๅๆงใๆบ่ฝ้่ฏฏๅ็ฑปใ่ฟๆฅๆฑ ไผๅ
ๆณไบ่งฃๆดๅคๅ ณไบ v0.5.0 Web UI ็่ฏฆ็ปไฟกๆฏ๏ผๆฅ็ๅฎๆดๆๆกฃ๏ผ
- ๐ ๅฟซ้ๅผๅง - Web UI ๅฎ่ฃ ๅไฝฟ็จๆๅ
- โก ไธ้ฎๅฏๅจ - ๅผๅๆจกๅผๅ็ไบงๆจกๅผ่ฏฆ่งฃ
- ๐งน ่ชๅจๆธ ็ - ๅๆญขๆถ็่ชๅจๆธ ็ๅ่ฝ
- ๐ง ๅผๅๆจกๅผ - ๅๅ็ซฏ็ญ้่ฝฝๆต่ฏๆๆกฃ
ๅฟซ้ๅ่:
- ๐ ๅฟซ้ๅ่ๅก็ - ๅธธ็จๅฝไปค้ๆฅ
ๆณไบ่งฃๆดๅคๅ ณไบ v0.4.0 ไปฃ็ๆๅก็่ฏฆ็ปไฟกๆฏ๏ผๆฅ็ๅฎๆดๆๆกฃ๏ผ
- ๐ ๅผๅ่ฎกๅ - ๅฎๆด็ๆๆฏ่ฎพ่ฎกๅๅฎ็ฐๆนๆก
- โ ๅฎๆๆฅๅ - ๅผๅๅฎๆๆ ๅตๅไฝฟ็จๆๅ
- ๐ ไฝฟ็จ็คบไพ - ่ฏฆ็ป็ไฝฟ็จๅบๆฏๅ็คบไพ
- ๐งช ๆต่ฏๆๅ - ๆต่ฏๆนๆณๅ้ช่ฏๆญฅ้ชค
ๆ ธๅฟๅ่ฝๆๆกฃ:
ๆณจๆ: docs/tasks ไธญ็ๆๆกฃๆ่ฟฐ็ๆฏ่ฎพ่ฎก่งๅ๏ผ้จๅๅ่ฝๅฏ่ฝไธๅฝๅๅฎ็ฐๆๅทฎๅผใ่ฏทไปฅ CLI ๅฝไปคๅ่ ไธบๅใ
ๆดๅคๆๆกฃ่ฏทๆฅ็ docs/tasks ็ฎๅฝใ