Claude Code 部署指南

覆蓋安裝、初始化、代理串接、常見錯誤和完整部署路徑。

請先參考官方文件docs.claude.com

📋 前置要求
請先完成 Node.js 環境安裝，確保 Node.js 18+ 已正確安裝。

⚡ 首次安裝必讀：跳過初始化錯誤

使用轉接管道時，Claude Code 首次啟動會出現以下錯誤：

圖片展示的是Claude Code首次啟動時出現的錯誤資訊。畫面背景為黑色，文字以紅色和白色呈現。錯誤內容顯示“Welcome to Claude Code”後，緊接著是“Unable to connect to Anthropic services”及“Failed to connect to api.anthropic.com: ERR_BAD_REQUEST”，並提示檢查網際網路連線和網路設定。最後還註明Claude Code可能不在你的國家可用，並給出官網連結。該圖片與文件中首次安裝Claude Code時出現的錯誤情況相關，直觀呈現了錯誤內容。圖片展示的是Claude Code首次啟動時出現的錯誤資訊

Welcome to Claude Code
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

這是因為 Claude Code 首次啟動會嘗試連線官方 API 進行初始化確認，轉接管道無法透過此步驟。安裝完成後、首次啟動前，請先執行以下任一方法跳過：

方法一：使用 CC-Switch 跳過（推薦）

請從 CC-Switch 下載頁 取得適合 macOS 或 Windows 的最新版安裝套件。 開啟 CC-Switch 設定工具，進入 設定 → 通用，開啟 「跳過 Claude Code 初次安裝確認」 選項即可。

圖片展示的是CC-Switch設定工具中設定頁面的“通用”頁籤。頁面上有多個設定選項，其中“跳過Claude Code初次安裝確認”選項被紅色框突出顯示，其開關狀態為開啟。該圖片與文件中“方法一：使用CC-Switch跳過（推薦）”的內容相關，用於說明在安裝完成後、首次啟動前，透過開啟CC-Switch設定工具，進入設定→通用，開啟該選項即可跳過Claude Code初次安裝確認的操作步驟。圖片展示的是CC-Switch設定工具中設定頁面的“通用”頁籤

方法二：手動修改設定檔

在使用者主目錄下找到 ~/.claude.json 檔案，在末尾新增 "hasCompletedOnboarding": true 欄位：

⚠️ 注意 JSON 格式
新增欄位前，需要在上一個欄位末尾補一個英文逗號，否則 JSON 格式錯誤會導致 Claude Code 無法啟動。
{
"installMethod": "unknown",
"autoUpdates": true,
"firstStartTime": "2025-07-14T06:11:03.877Z",
"userID": "xxxx",
"projects": {
"/home/your-user": {
"allowedTools": [],
"history": [],
"mcpContextUris": [],
"mcpServers": {},
"enabledMcpjsonServers": [],
"disabledMcpjsonServers": [],
"hasTrustDialogAccepted": false,
"projectOnboardingSeenCount": 0,
"hasClaudeMdExternalIncludesApproved": false,
"hasClaudeMdExternalIncludesWarningShown": false
}
},
"hasCompletedOnboarding": true
}

修改儲存後，重新執行 claude 即可正常使用。

參考來源：Claude Code 跳過初始化確認

🚀 使用 CC-Switch 快速設定（推薦）

如果您已安裝 CC-Switch 快速設定工具，可以透過圖形介面輕鬆管理 Claude Code 的設定，無需手動編輯設定檔和環境變數。

CC-Switch 優勢

  • 圖形化介面，操作簡單直觀
  • 一鍵切換不同供應商設定
  • 自動管理環境變數和設定檔
  • 支援設定備份與恢復
  • 無需重新啟動終端機即可切換設定

設定步驟

  1. 啟動 CC-Switch 並新增 Claude Code 設定

圖片展示的是CC-Switch應用程式中新增新設定的介面。介面上方有“Claude供應商”和“統一供應商”頁籤，目前選中“Claude供應商”。下方有“預設供應商”和“自訂設定”兩個區域，其中“自訂設定”被紅色框突出顯示。該圖片對應文件中“啟動CC-Switch並新增Claude Code設定”步驟，直觀呈現了在CC-Switch中新增Claude Code設定時選擇自訂設定的介面位置，輔助使用者理解操作流程。圖片展示的是CC-Switch應用程式中新增新設定的介面

  • 開啟 CC-Switch 應用程式
  • 點選頂部的「Claude」標籤頁
  • 點選右上角橘色「+」按鈕新增新設定

圖片展示的是CC-Switch應用程式中新增新設定的介面。介面中“API Key”處顯示為密文，提示為客服提供的以“sk”開頭的key；“請求位址”處顯示為“https://gpt-agent.cc”，並有黃色提示框說明填寫相容Claude API的服務端點位址，不要以斜槓結尾。該圖片與文件中“填寫供應商設定資訊”步驟相關，直觀呈現了API Key和請求位址的填寫範例，幫助使用者了解設定填寫的具體內容。圖片展示的是CC-Switch應用程式中新增新設定的介面

  1. 填寫供應商設定資訊
  • 供應商名稱：自訂名稱（如"guizhou"）
  • API Base URL：輸入 https://api.llm-token.cn
  • API Key：貼上您從平台取得的 Claude 專用令牌key
  • 模型選擇：根據需求選擇可用的 Claude 模型
  • 點選「儲存」按鈕
💡 提示
  • 可以新增多個不同的供應商設定（如官方、貴州☁️等）
  • CC-Switch 會自動修改 ~/.claude/settings.json 設定檔
  • 切換設定後，關閉並重新啟動 Claude Code 即可生效
  1. 啟用設定並使用
  • 在設定清單中找到剛建立的「gptagent」設定
  • 點選設定右側的「目前使用」按鈕（或直接點選設定卡片）
  • 設定會被標記為「目前使用」狀態（綠色標籤）
  • 重新啟動 Claude Code，新設定即可生效
  1. 系統匣快速切換

CC-Switch 支援透過系統匣快速切換設定：

  • 右鍵點選系統匣中的 CC-Switch 圖示
  • 在選單中選擇 Claude 分類
  • 直接選擇要切換到的設定
  • 設定立即生效，無需開啟主介面
⚠️ 注意事項
  • 切換設定後需要重新啟動 Claude Code 才能生效
  • 可以在 CC-Switch 中測試 API 端點速度，選擇最佳設定

設定上無法聊天？

試試這樣，實在不行聯絡客服

圖片展示了CC Switch介面，上方有“CC Switch”標題及多個圖示。其中，左側“貴州雲算力”選項被紅色箭頭指向，其右側顯示網址“https://gpt-agent.cc/”，並有“查詢失敗”的提示。該圖片與文件中“設定上無法聊天？試試這樣，實在不行聯絡客服”內容相關，可能是用於說明在CC Switch設定上遇到問題時，可點選該選項查看或聯絡客服解決。圖片展示了CC Switch介面，上方有“CC Switch”標題及多個圖示

圖片展示了CC Switch的設定介面，處於“代理”頁籤下。介面中“本機代理”狀態顯示為“執行中”，並有藍色箭頭指向該狀態。此外，還有“自動故障轉移”“整流器”“全域出站代理”等設定選項。該圖片與文件中“設定上無法聊天？試試這樣，實在不行聯絡客服”的內容相關，可能是用於指導使用者檢查CC Switch代理服務狀態，以排查設定問題。圖片展示了CC Switch的設定介面，處於“代理”頁籤下

圖片展示的是Claude Code部署指南中設定頁面的“程式碼”頁籤內容。頁面上方有“回傳主頁”“關於”等選項。關鍵資訊包括：在主流語言版本本機代理中，可選擇主流語言版本的模型進行本機部署開發；代理開啟開關已開啟；程式碼部分，Claude模型已開啟，Codex和Gemini模型未開啟；還有API位址、API金鑰、應用日誌記錄等設定項，其中應用日誌記錄開關已開啟。該圖與文件中設定上無法聊天的解決方法相關，直觀呈現了設定頁面的設定情況。圖片展示的是Claude Code部署指南中設定頁面的“程式碼”頁籤內容

⌨️ 手動指令列設定

如果您不使用 CC-Switch，也可以透過指令列手動設定 Claude Code。

🖥️ Windows 平台

系統要求

Windows 10、11

安裝步驟

方法一：Native Install（推薦）

使用 PowerShell：

irm https://claude.ai/install.ps1 | iex

使用 CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

方法二：NPM 安裝（不推薦）

⚠️ 不建議使用 npm 安裝
npm 管道更新滯後，安裝的版本通常較舊，建議優先使用上方的 Native 方式。
npm install -g @anthropic-ai/claude-code

驗證安裝：

claude --version

設定環境變數

如果是 PowerShell：

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.llm-token.cn", "User")

如果是 CMD：

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.llm-token.cn"
💡 提示
請注意將 sk-xxx 替換為你自己的專屬key！ 設定好後，重新啟動終端機以讓環境變數生效。
  • 啟動Claude

在終端機，進入（cd 目錄）到專案目錄或在任意目錄，輸入指令 claude 即可啟動使用。

🍏 macOS 平台

系統要求

MacOS 10.15 (Catalina) 或更高版本

安裝步驟

方法一：Homebrew（推薦）

brew install --cask claude-code

方法二：Curl Script

curl -fsSL https://claude.ai/install.sh | bash

方法三：NPM 安裝（不推薦）

⚠️ 不建議使用 npm 安裝
npm 管道更新滯後，安裝的版本通常較舊，建議優先使用上方的 Native 方式。
npm install -g @anthropic-ai/claude-code

驗證安裝

claude -v

正常情況應該輸出類似於：1.0.108 (Claude Code)

設定環境變數

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.zshrc
source ~/.zshrc
💡 提示
請注意將 sk-xxx 替換為你自己的專屬key！

重新啟動終端機並啟動Claude

重新啟動終端機後，進入（cd 目錄）到專案目錄或在任意目錄，輸入指令 claude 即可啟動使用。

🐧 Linux 平台

系統要求

Linux發行版 (Ubuntu 18.04+, CentOS 7+, Debian 9+等)

安裝步驟

方法一：Curl Script（推薦）

curl -fsSL https://claude.ai/install.sh | bash

方法二：NPM 安裝（不推薦）

⚠️ 不建議使用 npm 安裝
npm 管道更新滯後，安裝的版本通常較舊，建議優先使用上方的 Native 方式。
npm install -g @anthropic-ai/claude-code

驗證安裝

claude -v

設定環境變數

Ubuntu/Debian（Bash）

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.bashrc
source ~/.bashrc

Fedora/CentOS（Zsh）

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.llm-token.cn"' >> ~/.zshrc
source ~/.zshrc
💡 提示
請注意將 sk-xxx 替換為你自己的專屬key！

重新啟動終端機並啟動Claude

重新啟動終端機後，進入（cd 目錄）到專案目錄或在任意目錄，輸入指令 claude 即可啟動使用。

常見問題

提示找不到指令？

  • 確認 Claude Code 已正確安裝
  • 檢查 PATH 環境變數
  • 重新啟動終端機視窗

連線失敗？

  • 檢查網路連線
  • 確認 API Key 正確
  • 檢查餘額是否充足

Cherry Studio 設定教學

用截圖說明自訂供應商、Base URL 和 API Key 的填寫位置。

Codex 部署指南

講清 CLI 工具安裝、API 串接和開發環境設定。

本頁章節

⚡ 首次安裝必讀：跳過初始化錯誤方法一：使用 CC-Switch 跳過（推薦）方法二：手動修改設定檔🚀 使用 CC-Switch 快速設定（推薦）CC-Switch 優勢設定步驟設定上無法聊天？⌨️ 手動指令列設定🖥️ Windows 平台系統要求安裝步驟設定環境變數🍏 macOS 平台系統要求安裝步驟驗證安裝設定環境變數重新啟動終端機並啟動Claude🐧 Linux 平台系統要求安裝步驟驗證安裝設定環境變數重新啟動終端機並啟動Claude常見問題提示找不到指令？連線失敗？