Claude Code 概述

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

Claude Code 是一個智能編碼工具，它存在於您的終端機中，能夠理解您的程式碼庫，並通過自然語言命令幫助您更快地編寫程式碼。通過直接整合到您的開發環境中，Claude Code 簡化了您的工作流程，無需額外的伺服器或複雜的設置。

Claude Code 的主要功能包括：

• 編輯檔案並修復程式碼庫中的錯誤
• 回答關於程式碼架構和邏輯的問題
• 執行並修復測試、程式碼檢查和其他命令
• 搜尋 git 歷史記錄、解決合併衝突，以及創建提交和 PR

​

開始之前

​

檢查系統要求

• 作業系統：macOS 10.15+、Ubuntu 20.04+/Debian 10+ 或通過 WSL 的 Windows
• 硬體：最低 4GB RAM
• 軟體：
  • Node.js 18+
  • git 2.23+ (選用)
  • GitHub 或 GitLab CLI 用於 PR 工作流程 (選用)
  • ripgrep (rg) 用於增強檔案搜尋 (選用)
• 網路：需要網際網路連接以進行身份驗證和 AI 處理
• 地區：僅在支援的國家可用

​

安裝和認證

​

核心功能和工作流程

Claude Code 直接在您的終端機中運行，理解您的專案上下文並採取實際行動。無需手動將檔案添加到上下文中 - Claude 會根據需要探索您的程式碼庫。Claude Code 預設使用 claude-3-7-sonnet-20250219。

​

安全性和隱私設計

您的程式碼安全至關重要。Claude Code 的架構確保：

• 直接 API 連接：您的查詢直接發送到 Anthropic 的 API，無需中間伺服器
• 在您工作的地方工作：直接在您的終端機中運行
• 理解上下文：保持對整個專案結構的認知
• 採取行動：執行實際操作，如編輯檔案和創建提交

​

從問題到解決方案只需幾秒鐘

# 詢問關於您程式碼庫的問題
claude
> 我們的身份驗證系統是如何運作的？

# 用一個命令創建提交
claude commit

# 修復多個檔案中的問題
claude "修復身份驗證模組中的類型錯誤"

​

初始化您的專案

對於首次使用者，我們建議：

1. 使用 claude 啟動 Claude Code
2. 嘗試一個簡單的命令，如 summarize this project
3. 使用 /init 生成 CLAUDE.md 專案指南
4. 要求 Claude 將生成的 CLAUDE.md 檔案提交到您的儲存庫

​

使用 Claude Code 完成常見任務

Claude Code 直接在您的終端機中運行，理解您的專案上下文並採取實際行動。無需手動將檔案添加到上下文中 - Claude 會根據需要探索您的程式碼庫。

​

理解不熟悉的程式碼

> 支付處理系統做什麼？
> 找出在哪裡檢查用戶權限
> 解釋快取層是如何工作的

​

自動化 Git 操作

> 提交我的更改
> 創建一個 pr
> 哪個提交在十二月添加了 markdown 測試？
> 在 main 分支上重新基底並解決任何合併衝突

​

智能編輯程式碼

> 為註冊表單添加輸入驗證
> 重構記錄器以使用新的 API
> 修復工作佇列中的競爭條件

​

測試和除錯您的程式碼

> 運行身份驗證模組的測試並修復失敗
> 尋找並修復安全漏洞
> 解釋為什麼這個測試失敗

​

鼓勵深入思考

對於複雜的問題，明確要求 Claude 更深入地思考：

> 思考我們應該如何架構新的支付服務
> 深入思考我們身份驗證流程中的邊緣情況

Claude Code 會顯示 Claude (3.7 Sonnet) 何時在使用延伸思考。您可以主動提示 Claude “思考”或”深入思考”以處理更需要規劃的任務。我們建議您先告訴 Claude 您的任務，讓它從您的專案中收集上下文。然後，要求它”思考”以制定計劃。

​

自動化 CI 和基礎設施工作流程

Claude Code 提供非互動模式以供無頭執行。這在非互動環境下特別有用，如腳本、管道和 Github Actions。

使用 --print (-p) 以非互動模式運行 Claude。在此模式下，您可以設置 ANTHROPIC_API_KEY 環境變數以提供自定義 API 金鑰。

非互動模式在您預先配置 Claude 允許使用的命令集時特別有用：

export ANTHROPIC_API_KEY=sk_...
claude -p "使用最新更改更新 README" --allowedTools "Bash(git diff:*)" "Bash(git log:*)" Edit

​

使用命令控制 Claude Code

​

CLI 命令

CLI 標誌：

• --print：以非互動模式打印回應
• --verbose：啟用詳細日誌記錄
• --dangerously-skip-permissions：跳過權限提示（僅在沒有網際網路的 Docker 容器中）

​

斜線命令

在會話中控制 Claude 的行為：

​

管理權限和安全性

Claude Code 使用分層權限系統來平衡功能和安全性：

​

Claude 可用的工具

Claude Code 可以使用一組強大的工具來幫助它理解和修改您的程式碼庫：

​

防止提示注入

提示注入是攻擊者試圖通過插入惡意文本來覆蓋或操縱 AI 助手指令的技術。Claude Code 包含多項防範這些攻擊的保護措施：

• 權限系統：敏感操作需要明確批准
• 上下文感知分析：通過分析完整請求來檢測潛在有害的指令
• 輸入淨化：通過處理用戶輸入防止命令注入
• 命令黑名單：阻止從網路獲取任意內容的危險命令，如 curl 和 wget

處理不信任內容的最佳實踐：

1. 在批准前審查建議的命令
2. 避免直接將不信任的內容管道傳輸給 Claude
3. 驗證對關鍵檔案的建議更改
4. 使用 /bug 報告可疑行為

​

配置網路訪問

Claude Code 需要訪問：

• api.anthropic.com
• statsig.anthropic.com
• sentry.io

在容器化環境中使用 Claude Code 時，將這些 URL 加入白名單。

​

配置 Claude Code

通過在終端機中運行 claude config，或在使用互動式 REPL 時使用 /config 命令來配置 Claude Code。

​

配置選項

Claude Code 支援全局和專案級配置。

要管理您的配置，使用以下命令：

• 列出設置：claude config list
• 查看設置：claude config get <key>
• 更改設置：claude config set <key> <value>
• 向設置添加（對於列表）：claude config add <key> <value>
• 從設置移除（對於列表）：claude config remove <key> <value>

預設情況下，config 更改您的專案配置。要管理您的全局配置，使用 --global（或 -g）標誌。

​

全局配置

要設置全局配置，使用 claude config set -g <key> <value>：

​

自動更新器權限選項

當 Claude Code 檢測到它沒有足夠的權限來寫入您的全局 npm 前綴目錄（自動更新所需）時，您會看到一個警告，指向此文檔頁面。有關自動更新器問題的詳細解決方案，請參見疑難排解指南。

​

推薦：創建新的用戶可寫 npm 前綴

# 首先，保存現有全局套件列表以供後續遷移
npm list -g --depth=0 > ~/npm-global-packages.txt

# 創建全局套件目錄
mkdir -p ~/.npm-global

# 配置 npm 使用新的目錄路徑
npm config set prefix ~/.npm-global

# 注意：根據您的 shell 將 ~/.bashrc 替換為 ~/.zshrc、~/.profile 或其他適當的檔案
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# 應用新的 PATH 設置
source ~/.bashrc

# 現在在新位置重新安裝 Claude Code
npm install -g @anthropic-ai/claude-code

# 可選：在新位置重新安裝您之前的全局套件
# 查看 ~/npm-global-packages.txt 並安裝您想保留的套件
# npm install -g package1 package2 package3...

為什麼我們推薦這個選項：

• 避免修改系統目錄權限
• 為您的全局 npm 套件創建一個乾淨、專用的位置
• 遵循安全最佳實踐

由於 Claude Code 正在積極開發中，我們建議使用上述推薦選項設置自動更新。

​

禁用自動更新器

如果您更願意禁用自動更新器而不是修復權限，您可以使用：

claude config set -g autoUpdaterStatus disabled

​

專案配置

使用 claude config set <key> <value>（不帶 -g 標誌）管理專案配置：

例如：

# 允許 npm test 在沒有批准的情況下運行
claude config add allowedTools "Bash(npm test)"

# 允許 npm test 及其任何子命令在沒有批准的情況下運行
claude config add allowedTools "Bash(npm test:*)"

# 指示 Claude 忽略 node_modules
claude config add ignorePatterns node_modules
claude config add ignorePatterns "node_modules/**"

​

優化您的終端機設置

當您的終端機正確配置時，Claude Code 運行效果最佳。請遵循這些指南來優化您的體驗。

支援的 shell：

• Bash
• Zsh
• Fish

​

主題和外觀

Claude 無法控制您終端機的主題。這由您的終端機應用程式處理。您可以在入門過程中或通過 /config 命令隨時將 Claude Code 的主題與您的終端機匹配

​

換行

您有幾個選項可以在 Claude Code 中輸入換行：

• 快速轉義：輸入 \ 後跟 Enter 以創建換行
• 鍵盤快捷鍵：在正確配置的情況下按 Option+Enter（Meta+Enter）

要在您的終端機中設置 Option+Enter：

對於 Mac Terminal.app：

1. 打開設置 → 描述檔 → 鍵盤
2. 勾選”使用 Option 作為 Meta 鍵”

對於 iTerm2 和 VSCode 終端機：

1. 打開設置 → 描述檔 → 按鍵
2. 在常規下，將左/右 Option 鍵設置為”Esc+”

iTerm2 和 VSCode 用戶提示：在 Claude Code 中運行 /terminal-setup 以自動配置 Shift+Enter 作為更直觀的替代方案。

​

通知設置

通過適當的通知配置，永不錯過 Claude 完成任務的時機：

終端機鈴聲通知

啟用任務完成時的聲音提醒：

claude config set --global preferredNotifChannel terminal_bell

對於 macOS 用戶：別忘了在系統設置 → 通知 → [您的終端機應用程式] 中啟用通知權限。

iTerm 2 系統通知

對於 iTerm 2 任務完成提醒：

1. 打開 iTerm 2 偏好設置
2. 導航到描述檔 → 終端機
3. 啟用”靜音鈴聲”和”閒置時發送通知”
4. 設置您偏好的通知延遲

請注意，這些通知是 iTerm 2 特有的，在預設的 macOS 終端機中不可用。

​

處理大量輸入

當處理大量程式碼或長指令時：

• 避免直接貼上：Claude Code 可能難以處理非常長的貼上內容
• 使用基於檔案的工作流程：將內容寫入檔案並要求 Claude 讀取
• 注意 VS Code 限制：VS Code 終端機特別容易截斷長貼上內容

通過配置這些設置，您將創建一個更流暢、更高效的 Claude Code 工作流程。

​

有效管理成本

Claude Code 為每次互動消耗令牌。典型使用成本每位開發者每天在 $5-10 之間，但在密集使用期間可能超過每小時 $100。

​

追蹤您的成本

• 使用 /cost 查看當前會話使用情況
• 查看退出時顯示的成本摘要
• 在 Anthropic Console 中檢查歷史使用情況
• 設置支出限制

​

減少令牌使用

• 壓縮對話： 當上下文變大時使用 /compact
• 寫具體查詢： 避免觸發不必要掃描的模糊請求
• 分解複雜任務： 將大型任務分解為重點互動
• 在任務之間清除歷史： 使用 /clear 重置上下文

成本可能因以下因素而顯著變化：

• 被分析的程式碼庫大小
• 查詢的複雜性
• 被搜尋或修改的檔案數量
• 對話歷史長度
• 壓縮對話的頻率

​

使用第三方 API

​

連接到 Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1

如果您想覆蓋預設模型，可以傳入 ANTHROPIC_MODEL 環境變數（預設使用 Claude 3.7 Sonnet）：

ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

如果您想通過代理訪問 Claude Code，可以使用 ANTHROPIC_BEDROCK_BASE_URL 環境變數：

ANTHROPIC_BEDROCK_BASE_URL='https://your-proxy-url'

如果您沒有啟用提示快取，還要設置：

DISABLE_PROMPT_CACHING=1

需要標準 AWS SDK 憑證（例如，~/.aws/credentials 或相關環境變數如 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY）。要設置 AWS 憑證，運行：

aws configure

聯繫 Amazon Bedrock 以獲取提示快取，以降低成本並提高速率限制。

​

連接到 Google Vertex AI

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

如果您想覆蓋預設模型，可以傳入 ANTHROPIC_MODEL 環境變數（預設使用 Claude 3.7 Sonnet）：

ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

如果您想通過代理訪問 Claude Code，可以使用 ANTHROPIC_VERTEX_BASE_URL 環境變數：

ANTHROPIC_VERTEX_BASE_URL='https://your-proxy-url'

如果您沒有啟用提示快取，還要設置：

DISABLE_PROMPT_CACHING=1

需要通過 google-auth-library 配置的標準 GCP 憑證。要設置 GCP 憑證，運行：

gcloud auth application-default login

為獲得最佳體驗，請聯繫 Google 以獲取更高的速率限制。

​

開發容器參考實現

Claude Code 為需要一致、安全環境的團隊提供開發容器配置。這個預配置的 devcontainer 設置 與 VS Code 的 Remote - Containers 擴展和類似工具無縫協作。

容器的增強安全措施（隔離和防火牆規則）允許您運行 claude --dangerously-skip-permissions 以繞過權限提示進行無人值守操作。我們已包含一個參考實現，您可以根據需要進行自定義。

​

主要功能

• 生產就緒的 Node.js：基於 Node.js 20，具有基本開發依賴
• 安全設計：自定義防火牆僅限制對必要服務的網路訪問
• 開發者友好工具：包括 git、具有生產力增強功能的 ZSH、fzf 等
• 無縫 VS Code 整合：預配置的擴展和優化設置
• 會話持久性：在容器重啟之間保留命令歷史和配置
• 到處都能工作：兼容 macOS、Windows 和 Linux 開發環境

​

4 步開始使用

1. 安裝 VS Code 和 Remote - Containers 擴展
2. 克隆 Claude Code 參考實現 儲存庫
3. 在 VS Code 中打開儲存庫
4. 當提示時，點擊”在容器中重新打開”（或使用命令面板：Cmd+Shift+P → “Remote-Containers: Reopen in Container”）

​

配置細分

devcontainer 設置由三個主要組件組成：

• devcontainer.json：控制容器設置、擴展和卷掛載
• Dockerfile：定義容器映像和已安裝工具
• init-firewall.sh：建立網路安全規則

​

安全功能

容器通過其防火牆配置實現多層安全方法：

• 精確訪問控制：僅限制對白名單域名的出站連接（npm 註冊表、GitHub、Anthropic API 等）
• 預設拒絕策略：阻止所有其他外部網路訪問
• 啟動驗證：在容器初始化時驗證防火牆規則
• 隔離：創建與您的主系統分離的安全開發環境

​

自定義選項

devcontainer 配置設計為可適應您的需求：

• 根據您的工作流程添加或移除 VS Code 擴展
• 為不同的硬體環境修改資源分配
• 調整網路訪問權限
• 自定義 shell 配置和開發者工具

​

下一步

​

許可和數據使用

Claude Code 作為測試版研究預覽版根據 Anthropic 的商業服務條款提供。

​

我們如何使用您的數據

我們致力於完全透明地說明我們如何使用您的數據。我們可能會使用反饋來改進我們的產品和服務，但我們不會使用您來自 Claude Code 的反饋來訓練生成模型。考慮到其潛在的敏感性，我們只將用戶反饋記錄保存 30 天。

​

反饋記錄

如果您選擇向我們發送關於 Claude Code 的反饋，例如您的使用記錄，Anthropic 可能會使用該反饋來調試相關問題並改進 Claude Code 的功能（例如，減少類似錯誤在未來發生的風險）。我們不會使用此反饋來訓練生成模型。

​

隱私保護措施

我們已實施多項保護措施來保護您的數據，包括敏感信息的有限保留期、對用戶會話數據的受限訪問，以及明確禁止使用反饋進行模型訓練的政策。

有關完整詳情，請查看我們的商業服務條款和隱私政策。

​

許可

© Anthropic PBC。保留所有權利。使用受 Anthropic 的商業服務條款約束。