📋 目錄

  1. 工具簡介
  2. 系統需求
  3. 安裝 Claude CLI
  4. 安裝 CC Switch
  5. 基本配置
  6. 使用教學
  7. 常見問題
  8. 進階設定

工具簡介

Claude CLI 是什麼？

Claude CLI 是一個強大的命令列介面工具，讓開發者可以直接在終端機中與 Claude AI 進行互動。主要特色包括：

  • 終端機原生整合：直接在命令列執行 AI 對話
  • 管道支援：可與其他命令列工具串接使用
  • 多專案管理：支援不同專案的上下文切換
  • 對話歷史：保存並管理對話記錄

CC Switch 是什麼？

CC Switch 是一個便利的 Claude 上下文切換工具，專為需要在多個專案間快速切換的開發者設計：

  • 快速切換：一鍵切換不同的工作環境
  • 配置管理：為每個專案保存獨立配置
  • 智能記憶：自動記住最後使用的專案設定
  • 團隊協作：支援配置檔案分享

系統需求

基本環境

以下是基本環境的詳細說明。

  • Node.js：v18.0.0 或更高版本
  • npm：v9.0.0 或更高版本
  • 磁碟空間：至少 100 MB 可用空間

前置檢查

在開始安裝前，請先確認環境：

# 檢查 Node.js 版本

node --version

# 檢查 npm 版本

npm --version

# 檢查 Git（選用）

git --version

如果尚未安裝 Node.js，請至 Node.js 官網 下載最新 LTS 版本。

安裝 Claude CLI

方法一：使用 npm 安裝（推薦）

這是最簡單且推薦的安裝方式：

# 全域安裝 Claude CLI

npm install -g claude-cli

# 驗證安裝

claude --version

成功安裝後，你應該會看到類似以下的輸出：

claude-cli version 2.1.0

方法二：從原始碼安裝

適合需要最新開發版本或想要客製化的開發者：

# 克隆 Claude CLI 儲存庫

git clone https://github.com/anthropics/claude-cli.git

# 進入專案目錄

cd claude-cli

# 安裝依賴套件

npm install

# 建立專案

npm run build

# 全域連結

npm link

方法三：使用 Homebrew（僅限 macOS）

macOS 使用者可以透過 Homebrew 安裝：

# 安裝 Claude CLI

brew install claude-cli

# 驗證安裝

claude --version

Windows 專用安裝方式

Windows 使用者也可以使用 Chocolatey：

# 使用 Chocolatey 安裝

choco install claude-cli

# 驗證安裝

claude --version

初始化設定

安裝完成後，需要進行初始化設定：

# 執行初始化

claude init

# 系統會提示輸入 API Key

# 請至 https://console.anthropic.com/ 取得你的 API Key

初始化過程中會要求你輸入：

  1. API Key：你的 Anthropic API 金鑰
  2. 預設模型：選擇預設使用的 Claude 模型（如 claude-3-5-sonnet-20241022）
  3. 儲存位置：對話歷史的儲存目錄

安裝 CC Switch

使用 npm 安裝

以下是使用 npm 安裝的詳細說明。

全域安裝 CC Switch

npm install -g cc-switch

驗證安裝

ccswitch –version

### 從原始碼安裝
以下是從原始碼安裝的詳細說明。


# 克隆儲存庫

git clone https://github.com/claude-tools/cc-switch.git

# 進入目錄

cd cc-switch

# 安裝並建立

npm install
npm run build

# 全域連結

npm link

初始化 CC Switch

以下是初始化 CC Switch的詳細說明。

初始化 CC Switch

ccswitch init

創建第一個專案配置

ccswitch create my-project

## 基本配置

### 設定 API Key

有三種方式設定 API Key：

#### 1. 互動式設定（推薦新手）
```bash

claude config set-key

系統會提示你輸入 API Key，並安全地儲存在本地配置檔案中。

2. 環境變數設定

在你的 shell 配置檔案中（如 .bashrc, .zshrc, 或 PowerShell Profile）添加：


# Linux/macOS

export ANTHROPIC_API_KEY="your-api-key-here"

# Windows PowerShell

$env:ANTHROPIC_API_KEY="your-api-key-here"

3. 配置檔案設定

手動編輯配置檔案 ~/.claude/config.json：


{
  "apiKey": "your-api-key-here",
  "defaultModel": "claude-3-5-sonnet-20241022",
  "temperature": 0.7,
  "maxTokens": 4096
}

配置預設模型

選擇你偏好的 Claude 模型：


# 設定預設模型

claude config set model claude-3-5-sonnet-20241022

# 查看所有可用模型

claude models list

# 查看目前配置

claude config show

可用的模型包括：

  • claude-3-5-sonnet-20241022：最新版本，平衡效能與成本
  • claude-3-opus-20240229：最強大的模型，適合複雜任務
  • claude-3-haiku-20240307：最快速且經濟的選擇

設定專案配置

使用 CC Switch 為不同專案創建配置：


# 創建工作專案配置

ccswitch create work
ccswitch config work --model claude-3-5-sonnet-20241022 --temperature 0.5

# 創建個人專案配置

ccswitch create personal
ccswitch config personal --model claude-3-haiku-20240307 --temperature 0.8

# 列出所有配置

ccswitch list

使用教學

Claude CLI 基本用法

基本對話


# 啟動互動模式

claude chat

# 直接提問（單次對話）

claude ask "什麼是量子電腦？"

# 使用管道輸入

echo "解釋這段程式碼" | claude ask

程式碼分析


# 分析程式碼檔案

claude analyze app.js

# 請求程式碼審查

claude review src/components/Header.jsx

# 生成程式碼

claude generate "建立一個 React 登入元件"

檔案處理


# 讀取檔案並提問

claude ask --file README.md "總結這份文件的重點"

# 批次處理多個檔案

claude process --files "src/**/*.js" --prompt "尋找效能問題"

# 輸出到檔案

claude ask "建立 React 專案的 package.json" > package.json

對話管理


# 查看對話歷史

claude history

# 繼續上次的對話

claude resume

# 清除對話歷史

claude clear

# 匯出對話

claude export conversation-01 --format json

CC Switch 進階用法

專案切換


# 切換到工作專案

ccswitch use work

# 切換到個人專案

ccswitch use personal

# 查看當前使用的配置

ccswitch current

配置管理


# 編輯專案配置

ccswitch edit work

# 複製配置

ccswitch copy work work-backup

# 刪除配置

ccswitch delete work-backup

# 匯出配置（供團隊使用）

ccswitch export work > work-config.json

# 匯入配置

ccswitch import < work-config.json

智能切換


# 根據目錄自動切換

ccswitch auto-detect

# 設定目錄關聯

ccswitch link ~/projects/work work
ccswitch link ~/projects/personal personal

# 查看所有關聯

ccswitch links

實用範例

範例 1：程式碼重構


# 切換到工作環境

ccswitch use work

# 分析需要重構的程式碼

claude analyze legacy-code.js --focus "效能優化"

# 請求重構建議

claude ask --file legacy-code.js "請重構這段程式碼以提升可讀性和效能"

範例 2：文件生成


# 切換到文件撰寫配置

ccswitch use documentation

# 從程式碼生成 API 文件

claude generate-docs --input api/routes.js --output docs/api.md

# 生成 README

claude ask "根據 package.json 生成專案 README" --file package.json

範例 3：測試撰寫


# 切換到測試環境

ccswitch use testing

# 為元件生成測試

claude generate-test --file components/Button.jsx --framework jest

# 生成測試資料

claude ask "生成 100 筆使用者測試資料（JSON 格式）" > test-data.json

常見問題

安裝問題

Q: npm 安裝時出現權限錯誤

Windows 解決方案：


# 以管理員身份執行 PowerShell

npm install -g claude-cli --force

macOS/Linux 解決方案：


# 使用 sudo（不推薦）

sudo npm install -g claude-cli

# 或設定 npm 全域目錄（推薦）

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g claude-cli

Q: 找不到 claude 命令

確認 npm 全域套件路徑已加入 PATH：


# 查看 npm 全域路徑

npm config get prefix

# 加入到 PATH（根據你的 shell 調整）

export PATH="$PATH:$(npm config get prefix)/bin"

使用問題

Q: API Key 無效或已過期


# 重新設定 API Key

claude config set-key

# 或檢查環境變數

echo $ANTHROPIC_API_KEY  # Linux/macOS
echo $env:ANTHROPIC_API_KEY  # Windows PowerShell

Q: 回應速度很慢

檢查並調整以下設定：


# 使用更快的模型

claude config set model claude-3-haiku-20240307

# 減少最大 token 數

claude config set max-tokens 2048

# 查看網路連線

claude diagnose

Q: CC Switch 無法記住配置


# 檢查配置檔案權限

ls -la ~/.ccswitch/

# 重新初始化

ccswitch init --force

# 手動修復

ccswitch repair

錯誤訊息處理

錯誤：ECONNREFUSED 或 ETIMEDOUT

這通常是網路連線問題：


# 檢查網路連線

ping api.anthropic.com

# 設定代理（如果需要）

export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"

錯誤：Rate limit exceeded

API 請求頻率過高：


# 查看使用統計

claude usage

# 設定請求延遲

claude config set rate-limit 10  # 每秒最多 10 個請求

進階設定

客製化提示詞範本

創建可重複使用的提示詞範本：


# 創建範本目錄

mkdir ~/.claude/templates

# 創建程式碼審查範本

cat > ~/.claude/templates/code-review.txt << 'EOF'
請審查以下程式碼，關注：
1. 程式碼品質和可讀性
2. 潛在的 bug 或安全問題
3. 效能優化建議
4. 最佳實踐遵循情況

程式碼：
{code}
EOF

# 使用範本

claude ask --template code-review --var code="$(cat app.js)"

整合至編輯器

VS Code 整合

安裝 VS Code 擴充套件：


# 在 VS Code 中安裝 Claude CLI 擴充套件

code --install-extension anthropic.claude-vscode

在 VS Code 設定檔 settings.json 中配置：


{
  "claude.apiKey": "${env:ANTHROPIC_API_KEY}",
  "claude.defaultModel": "claude-3-5-sonnet-20241022",
  "claude.autoComplete": true,
  "claude.codeReview": true
}

Vim 整合

在 .vimrc 中添加：


" Claude CLI 整合
function! ClaudeAsk()
    let question = input('Ask Claude: ')
    let result = system('claude ask "' . question . '"')
    echo result
endfunction

" 綁定快捷鍵
nnoremap <leader>ca :call ClaudeAsk()<CR>

自動化工作流程

Git Hooks 整合

在 .git/hooks/pre-commit 中添加：


#!/bin/bash

# 使用 Claude 審查即將提交的程式碼

echo "Running Claude code review..."

changed_files=$(git diff --cached --name-only --diff-filter=ACM | grep '\.js$')

for file in $changed_files; do
    echo "Reviewing $file..."
    claude review "$file" --format compact
done

CI/CD 整合

在 GitHub Actions workflow 中使用：


name: Claude Code Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'

      - name: Install Claude CLI
        run: npm install -g claude-cli

      - name: Run Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude review-pr --pr-number ${{ github.event.number }}

效能調優

快取設定

啟用回應快取以加速重複查詢：


# 啟用快取

claude config set cache-enabled true

# 設定快取大小（MB）

claude config set cache-size 500

# 清除快取

claude cache clear

並行處理

處理大量檔案時使用並行模式：


# 設定並行工作數

claude config set parallel-workers 4

# 批次處理檔案

claude batch-process --files "src/**/*.js" --workers 4