Claude Code

Claude Code 教學 — 將 Anthropic 的終端程式設計助手串接至 New API。支援程式碼理解、多檔案編輯，整合 VS Code 與 JetBrains IDE。

專案介紹

直接在你的終端中釋放 Claude 的強大能力。瞬間搜尋百萬行程式碼庫。將耗時數小時的工作流程化為一條命令。你的工具、你的工作流程、你的程式碼庫，都能以思考速度進化。

官方首頁：https://www.anthropic.com/claude-code

效果示範

首次安裝指南

如果你已經完成安裝，可以直接跳轉到串接 MoleAPI 部分，快速進行設定與使用。

先看安裝路線

Claude Code 目前優先推薦使用官方原生安裝程式，而不是舊版 npm install -g 方式。

Windows：建議直接在 PowerShell 中執行官方安裝腳本，不需要先安裝 Node.js 或 npm
macOS / Linux：建議在終端中使用 curl | bash 原生安裝
如果本文未涵蓋你的系統細節、升級、解除安裝或疑難排解問題，可繼續查閱官方文件：
- 英文安裝文件：https://code.claude.com/docs/en/setup
- 官方中文概述：https://code.claude.com/docs/zh-TW/overview

Windows 圖文指引

1. 前置需求：安裝 Git for Windows

根據官方說明，Claude Code 在 Windows 上需要 Git for Windows，實際使用時可從 PowerShell、CMD 或 Git Bash 啟動；其中命令執行底層會使用 Git Bash。

下載並安裝 Git for Windows

造訪 https://git-scm.com/downloads/win
點擊 Download for Windows
下載完成後執行安裝程式
大多數情況下保留預設選項即可

Windows 端建議優先使用 PowerShell 執行安裝命令。官方目前優先推薦原生安裝程式，不需要預先安裝 Node.js、npm，一般也不需要以系統管理員身分執行 PowerShell。

安裝完成後，可在 PowerShell 中執行以下命令確認 Git 已可使用：

git --version

2. 使用 PowerShell 原生安裝 Claude Code

這是目前最推薦的安裝方式，直接使用官方原生安裝腳本，不依賴 Node.js / npm。

開啟 PowerShell，執行：

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

3. 使用 CMD 安裝 Claude Code

如果你更習慣 CMD，也可以直接使用官方提供的安裝腳本：

開啟 CMD，執行：

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

也可以使用：

winget install Anthropic.ClaudeCode

但對於 Windows 使用者，本文仍建議優先採用上面的 PowerShell 原生安裝流程。

Claude Code 安裝完成畫面，顯示 successfully installed、版本號與本機安裝路徑

如果安裝程式提示需要手動加入環境變數

某些環境下安裝完成後，claude 命令可能暫時還無法直接識別。如果安裝過程或終端提示你需要手動補 PATH，請把 ~/.local/bin 加入使用者環境變數。

常見處理命令如下：

[Environment]::SetEnvironmentVariable('Path', ([Environment]::GetEnvironmentVariable('Path','User') + ";$HOME\.local\bin"), 'User')

設定完成後，重新開啟終端再執行 claude --version。

4. 備用方案：Node.js / npm 安裝

如果你所在環境暫時必須使用 npm，也可以採用舊的全域安裝方式；但從官方推薦順序來看，這個方案的優先級低於前面的 PowerShell 原生安裝。

先前往 https://nodejs.org/ 下載 LTS 版本並完成安裝，然後在終端中確認：

node --version
npm --version

接著執行：

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

舊方案說明

npm 安裝方式仍可使用，但已不是官方優先推薦的安裝路徑。若沒有特殊相容性需求，更建議使用上面的 PowerShell 原生安裝命令。

安裝完成後，在 PowerShell 中執行：

claude --version
claude doctor

前者用於確認版本，後者可進一步檢查目前安裝與設定狀態。

如果 Claude Code 無法自動定位 Git Bash，可在 settings.json 中補上：

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

5. 啟動 Claude Code

安裝與設定完成後，直接執行：

claude

在某個專案目錄中使用：

cd C:\path\to\your\project
claude

如果你想切換模型，可在 Claude Code 中輸入：

/model

依提示選擇即可，通常預設選項就夠了。

提示：如果你還想把 Claude Code 切換到 Mole API，可直接跳轉閱讀下方的「串接 Mole API」章節，無需重新安裝。

macOS / Linux 圖文指引

這兩個平台的安裝方式基本一致，都是在終端中使用官方原生安裝腳本；差異主要體現在 shell 設定檔、系統相依性與權限策略上。

1. 使用原生安裝腳本安裝 Claude Code

開啟終端後執行：

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

如果終端提示需要補 PATH，可執行：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

如果你使用的是 zsh，則改為寫入 ~/.zshrc。

安裝完成後執行：

claude --version
claude doctor

2. 開始使用 Claude Code

直接啟動：

claude

在專案目錄中啟動：

cd /path/to/your/project
claude

如果你想切換模型，可輸入：

/model

按 Enter 後選擇模型，通常使用預設設定即可。

提示：如果你已經完成安裝，接下來可直接閱讀下方「串接 Mole API」章節，一鍵遷移到自訂接入點。

4. macOS / Linux 常見補充說明

如果 macOS 阻止執行，可前往「系統設定」中的安全性與隱私頁面允許該程式執行；更完整的系統相容性與解除安裝說明建議直接查看官方安裝文件。

官方文件也提到，部分 Linux 發行版可能需要額外相依套件。例如 Alpine 這類基於 musl 的系統，通常需要補裝 libgcc、libstdc++ 和 ripgrep，並依官方說明調整環境變數。

如果環境變數未生效，可依序檢查：

是否修改了正確的 shell 設定檔，如 ~/.bashrc 或 ~/.zshrc
是否已重新開啟終端，或執行了 source ~/.bashrc
是否可透過 echo $ANTHROPIC_BASE_URL 正常看到變數值

如果你需要查看更完整的系統需求、指定版本安裝、升級與解除安裝、Windows / WSL / Alpine 等特殊情境，建議繼續閱讀官方文件：https://code.claude.com/docs/en/setup 和 https://code.claude.com/docs/zh-TW/overview。

串接 Mole API

如果你已經完成 Claude Code 安裝，不需要重複安裝，直接依照下面的手動步驟設定環境變數，即可切換到 Mole API。

提示：在操作之前，請先前往 MoleAPI 的後台，取得你的 API Key。請造訪 https://home.moleapi.com/ ，登入後在個人中心或令牌管理頁面產生並複製你的專屬 key，後續在設定環境變數時會用到。

適用情境：

已經依照上文安裝好 Claude Code
之前使用的是官方預設設定，想切換到 MoleAPI
之前已經設定過其他中轉位址，想快速遷移到 MoleAPI

Windows：手動遷移到 Mole API

在 PowerShell 中執行，需要每行複製執行一次，不能一次全部複製：

[Environment]::SetEnvironmentVariable('ANTHROPIC_API_TOKEN', '', 'User')
$env:ANTHROPIC_API_TOKEN = ''

[Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.moleapi.com', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'your-moleapi-api-key', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-sonnet-4-5-20250929', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_SMALL_FAST_MODEL', 'claude-haiku-4-5-20251001', 'User')

$env:ANTHROPIC_BASE_URL = 'https://api.moleapi.com'
$env:ANTHROPIC_API_KEY = 'your-moleapi-api-key'
$env:ANTHROPIC_MODEL = 'claude-sonnet-4-5-20250929'
$env:ANTHROPIC_SMALL_FAST_MODEL = 'claude-haiku-4-5-20251001'

設定項說明：

ANTHROPIC_API_TOKEN：官方登入狀態使用的舊 token。如果你之前設定過官方 token，建議先清空，避免與第三方設定混用。
ANTHROPIC_BASE_URL：Claude Code 請求的 API 位址，這裡改為 Mole API 的接入位址。
ANTHROPIC_API_KEY：你自己的 Mole API Key，需要替換掉範例中的 your-moleapi-api-key。
ANTHROPIC_MODEL：主模型設定，通常用於大部分正式生成與複雜任務。
ANTHROPIC_SMALL_FAST_MODEL：輕量快速模型設定，通常用於更快、更便宜的輔助呼叫。

上面前半段是寫入使用者層級環境變數，重開終端後仍然生效；後半段的 $env: 是讓目前 PowerShell 工作階段立即生效。

遷移完成後，可重新開啟一個終端視窗，執行：

claude

然後依需求使用 /model 檢查模型列表是否已切換到你的接入設定。

macOS / Linux / Git Bash：手動遷移到 Mole API

下面直接給出完整範例，請依照自己使用的終端複製貼上：

export ANTHROPIC_API_TOKEN=""
export ANTHROPIC_BASE_URL="https://api.moleapi.com"
export ANTHROPIC_API_KEY="your-moleapi-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5-20251001"

如果只想讓本次終端工作階段生效，直接在終端輸入上面命令即可。

想要長期／持久生效，可以直接依照你使用的終端複製下面對應命令：

Bash 使用者，追加到 ~/.bashrc：

cat <<'EOF' >> ~/.bashrc
export ANTHROPIC_API_TOKEN=""
export ANTHROPIC_BASE_URL="https://api.moleapi.com"
export ANTHROPIC_API_KEY="your-moleapi-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5-20251001"
EOF
source ~/.bashrc

Zsh 使用者，追加到 ~/.zshrc：

cat <<'EOF' >> ~/.zshrc
export ANTHROPIC_API_TOKEN=""
export ANTHROPIC_BASE_URL="https://api.moleapi.com"
export ANTHROPIC_API_KEY="your-moleapi-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5-20251001"
EOF
source ~/.zshrc

Git Bash 使用者，通常可追加到 ~/.bashrc：

cat <<'EOF' >> ~/.bashrc
export ANTHROPIC_API_TOKEN=""
export ANTHROPIC_BASE_URL="https://api.moleapi.com"
export ANTHROPIC_API_KEY="your-moleapi-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5-20251001"
EOF
source ~/.bashrc

如果你的 Git Bash 環境較偏向讀取 ~/.bash_profile，也可以改為追加到該檔案。

Fish 使用者，追加到 ~/.config/fish/config.fish：

mkdir -p ~/.config/fish
cat <<'EOF' >> ~/.config/fish/config.fish
set -x ANTHROPIC_API_TOKEN ""
set -x ANTHROPIC_BASE_URL "https://api.moleapi.com"
set -x ANTHROPIC_API_KEY "your-moleapi-api-key"
set -x ANTHROPIC_MODEL "claude-sonnet-4-5-20250929"
set -x ANTHROPIC_SMALL_FAST_MODEL "claude-haiku-4-5-20251001"
EOF
source ~/.config/fish/config.fish

如果你不確定自己目前使用的是哪種 shell，可先執行 echo $SHELL 再選擇對應命令。

設定項說明：

ANTHROPIC_API_TOKEN：如果之前設定過官方 token，先清空它，避免和新的第三方設定衝突。
ANTHROPIC_BASE_URL：請求位址，設定為 Mole API 的介面位址。
ANTHROPIC_API_KEY：你自己的 Mole API Key。
ANTHROPIC_MODEL：主模型設定。
ANTHROPIC_SMALL_FAST_MODEL：輕量快速模型設定。

遷移完成後，執行以下命令啟動 Claude Code：

claude

如有需要，可使用 echo $ANTHROPIC_BASE_URL 檢查環境變數是否已寫入目前 shell 設定。

注意：完成遷移後，Claude Code 中的模型請求會優先走你設定的 Mole API 接入點，而不是官方預設額度。

本頁目錄