logo

Claude Code 配置指南

CC Switch 下載地址

亞太地區加速地址來自第三方 GitHub Proxy。下載後請確認項目名和版本號與上方 GitHub 官方地址一致。

安裝步驟

1. 安裝 Node.js

訪問 Node.js 官網，建議下載左側的 LTS 版本，它是長期支持版，更加穩定。

2. 安裝 Git

訪問 Git 官網，頁面會自動推薦適合你操作系統的版本，點擊按鈕即可下載。

3. 安裝 Claude Code

打開 cmd 命令行，通過 npm 安裝 claude-code：

npm install -g @anthropic-ai/claude-code

配置步驟

1. 打開 cc switch

啟動 cc switch 應用程序。

打開cc switch

2. 點擊右上角加號

在界面右上角找到並點擊加號按鈕，添加新的供應商配置。

點擊加號

3. 填寫配置信息

  • 供應商名稱：隨意填寫（例如：LLMoxy）
  • API Key：填入您的站點令牌秘鑰
  • 請求地址： https://llmoxy.com
  • 主模型： claude-opus-4-6

填寫配置信息

4. 命令行啟動 Claude Code

在命令行中啟動 Claude Code。

命令行啟動

5. 切換模型

進入後輸入 /model切換到剛剛設定的模型名稱。

切換模型

6. 開始使用

回車確定選中後即可開始正常使用 Claude Code。

開始使用

手動配置（命令行）

以下是不使用 CC-Switch 的替代方案，適合習慣命令行操作的用戶。

環境變量告訴 Claude Code 去哪裡調用 AI 服務、使用哪個密鑰。需要配置：

  • ANTHROPIC_BASE_URL — LLMoxy 網關地址
  • ANTHROPIC_AUTH_TOKEN — 你的 LLMoxy API Key

TIP Claude Code 使用 Anthropic 兼容接口，地址 不帶 /v1。

以下命令將配置永久保存到用戶級環境變量，重啟不丟失。

設置網關地址：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://llmoxy.com","User")

設置 API Key（請替換佔位符）：

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","你的LLMoxy API Key","User")

關閉 PowerShell，重新打開一個新窗口，然後驗證：

echo $env:ANTHROPIC_BASE_URL

應顯示： https://llmoxy.com

macOS 默認使用 Zsh，寫入 Zsh 配置文件即可永久生效。

~/.zshrc是 macOS 的 Shell 配置文件，每次打開終端都會自動加載。下面的命令會自動創建（如果不存在）並追加配置，直接複製粘貼到終端運行即可。

寫入環境變量配置（請替換 API Key）：

{
echo ''
echo '# LLMoxy'
echo 'export ANTHROPIC_BASE_URL="https://llmoxy.com"'
echo 'export ANTHROPIC_AUTH_TOKEN="你的LLMoxy API Key"'
} >> ~/.zshrc

立即生效：

source ~/.zshrc

驗證：

echo "$ANTHROPIC_BASE_URL"

應顯示： https://llmoxy.com

根據你使用的 Shell 寫入對應的配置文件。

不確定自己用的是哪個 Shell？運行 echo $SHELL，看到 /bin/bash就是 Bash，看到 /bin/zsh就是 Zsh。

~/.bashrc（Bash）和 ~/.zshrc（Zsh）是 Shell 配置文件，每次打開終端都會自動加載。下面的命令會自動創建（如果不存在）並追加配置，直接複製粘貼運行即可。

Bash 用戶 （大部分 Linux 默認）：

{
echo ''
echo '# LLMoxy'
echo 'export ANTHROPIC_BASE_URL="https://llmoxy.com"'
echo 'export ANTHROPIC_AUTH_TOKEN="你的LLMoxy API Key"'
} >> ~/.bashrc

Zsh 用戶 ：

{
echo ''
echo '# LLMoxy'
echo 'export ANTHROPIC_BASE_URL="https://llmoxy.com"'
echo 'export ANTHROPIC_AUTH_TOKEN="你的LLMoxy API Key"'
} >> ~/.zshrc

使配置生效：

source ~/.bashrc # Bash 用戶
# 或
source ~/.zshrc # Zsh 用戶

驗證：

echo "$ANTHROPIC_BASE_URL"

應顯示： https://llmoxy.com

你 必須 將 你的LLMoxy API Key替換為從 LLMoxy 控制台 複製的真實 Key。

啟動並驗證

進入你的項目目錄，啟動 Claude Code：

claude

可選：先做一次環境檢查：

claude doctor

如果能正常對話，說明已成功接入 LLMoxy。

常見問題

npm install -g提示權限錯誤

以管理員身份運行 PowerShell，然後重試。

不要 使用 sudo npm install -g強行安裝。通過 Homebrew 重新安裝 Node.js（參考 Node.js 安裝教程），Homebrew 安裝的 Node.js 不需要 sudo 權限。

不要 使用 sudo npm install -g。推薦使用 nvm 管理 Node.js，或修改 npm 全局目錄權限：

npm config set prefix ~/.npm-global

然後將 ~/.npm-global/bin加入 PATH。

環境變量未生效

SetEnvironmentVariable(...,"User")需要 重新打開終端 才能加載。仍然不顯示則嘗試註銷 Windows 或重啟。

執行 source ~/.zshrc或關閉終端重新打開一個新窗口，再驗證： echo "$ANTHROPIC_BASE_URL"

確認執行了 source ~/.bashrc（或 ~/.zshrc），或關閉終端重新打開，再驗證： echo "$ANTHROPIC_BASE_URL"

提示 "claude command not found"

  1. 確認 Node.js 已正確安裝： node -v
  2. 重啟終端
  3. 仍然不行則重新安裝 Claude Code

遠程服務器連接超時（Linux）

  • 檢查服務器是否能訪問外網： curl -I https://llmoxy.com
  • 如需代理，配置 HTTPS_PROXY 環境變量
亞太地區加速存取教學
Claude Code Fable 5 設定指南