Free Claude Code(FCC)企業技術白皮書與導入手冊 文件版本:v3.0(2026-09) 對應上游版本:Alishahryar1/free-claude-code v6.1.4(53,800+ Stars/8,600+ Forks) 適用對象:資深工程師 / 架構師 / DevOps / 平台工程 / AI 開發團隊 / 技術決策者 授權條款:MIT License 文件定位:企業級 AI 輔助開發平台之技術評估、導入、維運與治理手冊 語言:繁體中文 最後更新:2026 年 9 月 8 日
免責與商標聲明 Free Claude Code(以下簡稱 FCC)為獨立開源專案,與 Anthropic 無隸屬關係,亦未取得 Anthropic 背書。Claude 與 Claude Code 為 Anthropic 之商標;Codex 為 OpenAI 之商標;其餘產品名稱歸各自權利人所有。
本手冊所述之各 Provider 免費額度、速率限制與服務條款,均由各 Provider 自行制定並可能隨時變更。企業導入前,務必自行確認各 Provider 之服務條款(ToS)是否允許貴組織的使用情境(特別是商業用途、團隊共用與自動化呼叫)。本文件僅供技術參考,不構成法律意見。
目錄 概述(Overview) 1.1 FCC 是什麼 1.2 核心價值主張 1.3 與 Claude Code 官方訂閱的差異 1.4 適用場景與不適用場景 1.5 版本演進與重大變更 1.6 架構定位圖 系統整體架構(Architecture) 2.1 高階架構圖 2.2 分層架構與原始碼結構 2.3 Request Flow:Anthropic Messages 路徑 2.4 Request Flow:OpenAI Responses 路徑 2.5 模型路由與階層繼承 2.6 Fallback Chain 自動故障轉移 2.7 Reasoning 推理強度控制 2.8 Token 最佳化機制 2.9 擴充點(Extension Points) 安裝與環境建置(Installation) 3.1 系統需求 3.2 安裝方式決策 3.3 方式一:官方安裝腳本(推薦) 3.4 方式二:原始碼安裝(稽核 / 開發) 3.5 啟動 FCC 服務 3.6 首次設定(以 NVIDIA NIM 為例) 3.7 啟動 Coding Agent 3.8 安裝驗證 3.9 檔案與目錄配置 3.10 更新與解除安裝 3.11 環境建置流程圖 核心設定(Configuration) 4.1 設定來源與優先權 4.2 Admin UI 設定面板 4.3 模型設定:MODEL、階層與 Fallback 4.4 Reasoning 設定 4.5 Proxy 認證與服務連線 4.6 速率限制與逾時 4.7 請求最佳化開關 4.8 Web Tools 設定 4.9 企業 Proxy(Per-Provider) 4.10 Messaging 與語音設定 4.11 日誌與診斷設定 4.12 環境變數完整速查表 Provider 生態系(50 家供應商) 5.1 Provider 分類全覽 5.2 完整 Provider 目錄 5.3 認證模式:API Key 與 Connected Account 5.4 免費額度優先組合 5.5 重點 Provider 詳解 5.6 訂閱制 Provider 與合規注意事項 5.7 企業雲 Provider 5.8 本地 Provider 5.9 Provider 選型決策矩陣 5.10 混合 Provider 路由策略 Coding Agent 與客戶端整合(Clients) 6.1 十大 Coding Agent 總覽 6.2 Claude Code 整合 6.3 Codex 整合(CLI / App / VS Code) 6.4 其餘 Agent 啟動方式 6.5 VS Code 整合 6.6 JetBrains ACP 整合 6.7 瀏覽器 Code Sessions 6.8 Discord / Telegram 遠端協作 6.9 語音輸入(Voice Notes) 6.10 客戶端疑難排解 開發實戰(AI Development Use Cases) 7.1 Web Application 開發 7.2 舊系統逆向工程 7.3 Framework 升級 7.4 多模型協作模式 SSDLC(安全開發流程) 8.1 AI 輔助 SSDLC 整體流程 8.2 Threat Modeling(威脅建模) 8.3 Code Review(AI 安全審查) 8.4 Security Scan 整合 8.5 SSDLC 自動化流程 團隊導入策略(Team Adoption) 9.1 導入階段規劃 9.2 開發流程設計 9.3 Prompt Template 管理 9.4 AI Agent Team 設計 9.5 治理與濫用防制 維運與監控(Operations) 10.1 日誌架構 10.2 Token 與成本監控 10.3 成本控管策略 10.4 速率限制設計 10.5 健康檢查與可觀測性 品質驗證:測試與 Smoke Testing 11.1 兩層測試策略 11.2 Hermetic 測試 11.3 Live Smoke Testing 11.4 Smoke Target 對照表 11.5 Smoke 模型覆寫 11.6 實務執行範例 升級、擴展與高可用(Upgrade & Scaling) 12.1 升級策略 12.2 新增自訂 Provider 12.3 水平擴展 12.4 高可用設計 12.5 Dev / Stage / Prod 環境設計 安全、隱私與合規(Security & Compliance) 13.1 威脅模型 13.2 Proxy 認證強化 13.3 憑證與金鑰管理 13.4 資料外流與駐留風險 13.5 Prompt Injection 與供應鏈風險 13.6 服務條款與授權合規 13.7 安全基線設定檔 CI/CD 整合 14.1 GitHub Actions 範例 14.2 CI/CD 整合架構 14.3 自建 Runner 注意事項 開發與貢獻指南(Development & Contributing) 15.1 開發環境設定 15.2 本地 CI 流程 15.3 程式碼規範 15.4 架構原則 15.5 版本控管規則 15.6 貢獻規則 常見問題(FAQ) 最佳實務(Best Practices) 17.1 架構設計 17.2 Prompt Engineering 17.3 成本最佳化 17.4 安全性 17.5 反模式清單 範例 Prompt 集 18.1 通用開發 Prompt 18.2 Code Review Prompt 18.3 逆向工程 Prompt 18.4 升級評估 Prompt 18.5 多模型交叉驗證 Prompt 18.6 FCC 環境診斷 Prompt 導入檢查清單(Checklist) 19.1 安裝與環境 19.2 客戶端連線 19.3 模型與路由 19.4 安全 19.5 合規 19.6 團隊導入 19.7 維運 19.8 開發貢獻 附錄(Appendix) 20.1 環境變數全表 20.2 CLI 指令速查 20.3 API 端點速查 20.4 名詞對照表 20.5 參考資源 1. 概述(Overview) 1.1 FCC 是什麼 Free Claude Code(FCC)是一套以 Python 3.14 + FastAPI 建構的本機 AI 閘道(Local AI Gateway)。它在開發者機器上啟動一個代理伺服器,同時對外提供兩種業界標準協議端點:
...