Claude Code 概述

安裝 NodeJS 18+，然後執行：

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 的架構確保：

• 直接 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 操作

> commit my changes
> create a pr
> 哪個提交在十二月添加了 markdown 測試？
> rebase on main and resolve any merge conflicts

​

智能編輯程式碼

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

​

測試和調試您的程式碼

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

​

鼓勵更深入的思考

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

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

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

​

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

Claude Code 提供非互動模式，用於無頭執行。這對於在非互動上下文中運行 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:*)" Write --disallowedTools ...

​

使用命令控制 Claude Code

​

CLI 命令

CLI 標誌：

• --print (-p)：在非互動模式下打印回應
• --json：在 --print 模式下返回 JSON 輸出，適用於腳本和自動化
• --verbose：啟用詳細日誌記錄，顯示完整的逐輪輸出（在打印和互動模式下都有助於調試）
• --dangerously-skip-permissions：跳過權限提示

​

斜線命令

在會話中控制 Claude 的行為：

​

管理 Claude 的記憶

Claude Code 可以在會話之間記住您的偏好，如風格指南和工作流程中的常用命令。

​

確定記憶類型

Claude Code 提供三個記憶位置，每個位置服務於不同的目的：

所有記憶檔案在啟動時都會自動加載到 Claude Code 的上下文中。

​

Claude 如何查找記憶

Claude Code 遞歸讀取記憶：從當前工作目錄開始，Claude Code 遞歸向上到 / 並讀取它找到的任何 CLAUDE.md 或 CLAUDE.local.md 檔案。這在處理大型存儲庫時特別方便，當您在 foo/bar/ 中運行 Claude Code，並且在 foo/CLAUDE.md 和 foo/bar/CLAUDE.md 中都有記憶時。

​

使用 # 快捷方式快速添加記憶

添加記憶的最快方法是以 # 字符開始您的輸入：

# 始終使用描述性變數名稱

系統會提示您選擇要將此記憶存儲在哪個記憶檔案中。

​

使用 /memory 直接編輯記憶

在會話期間使用 /memory 斜線命令在系統編輯器中打開任何記憶檔案，以進行更廣泛的添加或組織。

​

記憶最佳實踐

• 具體明確：“使用 2 空格縮進”比”正確格式化程式碼”更好。
• 使用結構來組織：將每個單獨的記憶格式化為項目符號，並在描述性的 markdown 標題下對相關記憶進行分組。
• 定期審查：隨著專案的發展更新記憶，確保 Claude 始終使用最新的信息和上下文。

​

管理權限和安全性

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

​

Claude 可用的工具

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

權限規則可以使用 /allowed-tools 或在權限設置中配置。

​

防止提示注入

提示注入是攻擊者試圖通過插入惡意文本來覆蓋或操縱 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 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/**"

有關 allowedTools 規則格式，請參閱權限。

​

優化您的終端機設置

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 終端機特別容易截斷長粘貼

​

Vim 模式

Claude Code 支持一部分 Vim 鍵綁定，可以通過 /vim 啟用或通過 /config 配置。

支持的子集包括：

• 模式切換：Esc（到 NORMAL），i/I，a/A，o/O（到 INSERT）
• 導航：h/j/k/l，w/e/b，0/$/^，gg/G
• 編輯：x，dw/de/db/dd/D，cw/ce/cb/cc/C，.（重複）

​

有效管理成本

Claude Code 為每次互動消耗令牌。平均成本為每位開發者每天 $6，90% 的用戶每日成本保持在 $12 以下。

​

跟踪您的成本

• 使用 /cost 查看當前會話使用情況
• Anthropic Console 用戶：
  • 在 Anthropic Console 中查看歷史使用情況（需要 Admin 或 Billing 角色）
  • 為 Claude Code 工作區設置工作區支出限制（需要 Admin 角色）
• Max 計劃用戶：使用包含在您的 Max 計劃訂閱中

​

減少令牌使用

• 壓縮對話：

  • Claude 在上下文超過 95% 容量時默認使用自動壓縮

  • 切換自動壓縮：運行 /config 並導航到”Auto-compact enabled”

  • 當上下文變大時手動使用 /compact

  • 添加自定義指令：/compact Focus on code samples and API usage

  • 通過添加到 CLAUDE.md 自定義壓縮：

    # Summary instructions
    
    When you are using compact, please focus on test output and code changes
    

• 編寫具體查詢： 避免模糊請求，這會觸發不必要的掃描

• 分解複雜任務： 將大型任務分解為專注的互動

• 在任務之間清除歷史記錄： 使用 /clear 重置上下文

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

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

​

模型配置

默認情況下，Claude Code 使用 claude-opus-4-20250514。您可以使用以下環境變數覆蓋此設置：

# Anthropic API
ANTHROPIC_MODEL='claude-opus-4-20250514'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku-20241022'

# Amazon Bedrock
ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Google Vertex AI
ANTHROPIC_MODEL='claude-opus-4@20250514'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku@20241022'

您也可以使用全局配置設置這些變數：

# 配置 Anthropic API
claude config set --global env '{"ANTHROPIC_MODEL": "claude-opus-4-20250514"}'

# 配置 Bedrock
claude config set --global env '{"CLAUDE_CODE_USE_BEDROCK": "true", "ANTHROPIC_MODEL": "us.anthropic.claude-opus-4-20250514-v1:0"}'

# 配置 Vertex AI
claude config set --global env '{"CLAUDE_CODE_USE_VERTEX": "true", "ANTHROPIC_MODEL": "claude-opus-4@20250514"}'

​

與第三方 API 一起使用

​

連接到 Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1

如果您想通過代理訪問 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

如果您想通過代理訪問 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 與 LLM 代理（如 LiteLLM）時，您可以使用以下環境變數和配置控制身份驗證行為。請注意，您可以將這些與 Bedrock 和 Vertex 特定設置混合使用。

​

環境變數

• ANTHROPIC_AUTH_TOKEN：Authorization 和 Proxy-Authorization 標頭的自定義值（您在此處設置的值將以 Bearer 為前綴）
• ANTHROPIC_CUSTOM_HEADERS：您想添加到請求的自定義標頭（採用 Name: Value 格式）
• HTTP_PROXY：設置 HTTP 代理 URL
• HTTPS_PROXY：設置 HTTPS 代理 URL

如果您更喜歡通過檔案而不是環境變數進行配置，可以將這些變數添加到全局 Claude 配置中的 env 對象（在 ~/.claude.json 中）。

​

全局配置選項

• apiKeyHelper：獲取 API 密鑰的自定義 shell 腳本（在啟動時調用一次，並在每個會話期間緩存）

​

開發容器參考實現

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 作為 Beta 研究預覽版根據 Anthropic 的商業服務條款提供。

​

我們如何使用您的數據

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

​

反饋記錄

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

​

隱私保護措施

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

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

​

許可

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