🚀 Free Claude Code：從零開始安裝與使用教學
這套工具的作用是作為一個「翻譯官」（代理伺服器）。它能讓原本只能連接 Anthropic 官方（需付費）的 Claude Code，轉而連接到其他的模型供應商（如 NVIDIA NIM、OpenRouter、DeepSeek 等），從而達到免費或更彈性的使用體驗。
📋 第一階段：準備工作（安裝必要軟體）
在開始之前，您的電腦需要安裝幾個基礎工具。請打開 PowerShell（在開始選單搜尋 PowerShell，點擊右鍵以「系統管理員身分執行」）。
1. 安裝 uv (Python 工具管理員)
請在 PowerShell 輸入以下指令並按 Enter：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
2. 安裝 Claude Code (官方 CLI)
請輸入以下指令安裝：
npm install -g @anthropic-ai/claude-code
3. 安裝 Python 3.14
輸入以下指令：
uv python install 3.14
📂 第二階段：下載與安裝 Free Claude Code
1. 複製程式碼
在 PowerShell 中進入您想存放的目錄（建議：C:\Users\alan\testFreeClaudeCode），然後輸入：
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
2. 建立設定檔與安裝
copy .env.example .env
uv sync
⚙️ 第三階段：設定金鑰 (API Key)
1. 取得金鑰
您可以選擇以下任一供應商（建議 NVIDIA NIM 通常有免費額度）：
2. 填入金鑰 (最重要的步驟)
請注意，您的電腦中有兩個設定檔，請務必修改專案資料夾內的這一個：
路徑：C:\Users\alan\testFreeClaudeCode\free-claude-code\.env
- 使用「記事本」打開上述路徑的
.env檔案。 - 找到對應供應商的行，將您的金鑰貼在引號內：
NVIDIA_NIM_API_KEY="您的金鑰"
- 同步全域設定 (選擇性，但建議執行)：為了保險起見，改完存檔後，請在 PowerShell 執行以下指令，將設定同步到全域位置：
copy C:\Users\alan\testFreeClaudeCode\free-claude-code\.env C:\Users\alan\.config\free-claude-code\.env
🏃 第四階段：啟動與運行
步驟 A：啟動代理伺服器
進入 C:\Users\alan\testFreeClaudeCode\free-claude-code 資料夾，在 PowerShell 視窗中輸入：
uv run uvicorn server:app --host 0.0.0.0 --port 8082
看到 Uvicorn running on http://0.0.0.0:8082 即代表啟動成功。請保持此視窗開啟。
步驟 B：啟動 Claude Code
開啟另一個新的 PowerShell 視窗，輸入以下指令啟動：
$env:ANTHROPIC_AUTH_TOKEN="freecc"; $env:ANTHROPIC_BASE_URL="http://localhost:8082"; $env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"; claude
🔄 第五階段：如何更換供應商 (Provider) 或更新設定
如果您之後想要更換金鑰或換成 OpenRouter，請遵循此「標準操作流程」：
- 修改專案內的 .env：
打開
C:\Users\alan\testFreeClaudeCode\free-claude-code\.env，修改金鑰。 - 執行同步指令：
copy C:\Users\alan\testFreeClaudeCode\free-claude-code\.env C:\Users\alan\.config\free-claude-code\.env - 重啟伺服器：
回到執行
uv run uvicorn的視窗，按Ctrl + C停止，再重新輸入啟動指令。 - 在 Claude Code 中選擇模型：
對話中輸入
/model即可選取新供應商的模型。
⚠️ 常見問題處理 (Troubleshooting)
1. 出現 "Auth conflict" (身分驗證衝突)
請在 PowerShell 輸入：claude /logout
2. 連接失敗 (401 Unauthorized)
這通常代表 .env 內的 ANTHROPIC_AUTH_TOKEN 與啟動指令不符。請確保兩者皆為 "freecc"。
💡 使用小技巧
- 保持更新：在專案資料夾執行
git pull即可取得作者的最新修正。