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

Claude Code 的主要功能包括：

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

研究預覽版

Code 目前處於測試版研究預覽階段。我們正在收集開發者對 AI 協作偏好的反饋，了解哪些工作流程最能從 AI 協助中受益，以及如何改善代理體驗。

這個早期版本將根據用戶反饋不斷演進。我們計劃在未來幾週內提升工具執行的可靠性、支援長時間運行的命令、終端機渲染，以及 Claude 對其自身能力的認知。

回報錯誤可以直接使用 /bug 命令或通過我們的 GitHub 儲存庫。

​
核心功能和工作流程

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

​
安全性和隱私設計

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

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

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

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

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

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

​
開始之前

​
檢查系統要求

  • 作業系統：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 處理

​
安裝和認證

1

安裝 Claude Code

在終端機中運行：npm install -g @anthropic-ai/claude-code

2

導航到你的專案

cd your-project-directory
3

啟動 Claude Code

運行 claude 以啟動
4

完成認證

按照一次性 OAuth 流程使用你的 Console 帳戶。你需要在 console.anthropic.com 上有活躍的計費。

​
初始化你的專案

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

  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

​
CLI 命令

命令描述範例
claude啟動互動式 REPL$ claude
claude "query"以初始提示啟動 REPL$ claude "explain this project"
claude -p "query"運行一次性查詢，然後退出$ claude -p "explain this function"
cat file | claude -p "query"處理管道內容$ cat logs.txt | claude -p "explain"
claude config配置設定$ claude config set --global theme dark
claude update更新到最新版本$ claude update
claude mcp配置模型上下文協議伺服器$ claude mcp add pyright_lsp

CLI 標誌：

  • --print：不進入互動模式直接輸出回應
  • --verbose：啟用詳細日誌記錄
  • --dangerously-skip-permissions：跳過權限提示（僅在沒有網路的 Docker 容器中）

​
斜線命令

在會話中控制 Claude 的行為：

命令用途
/bug回報錯誤（將對話發送給 Anthropic）
/clear清除對話歷史
/compact壓縮對話以節省上下文空間
/config查看/修改配置
/cost顯示代幣使用統計
/doctor檢查你的 Claude Code 安裝狀況
/help獲取使用幫助
/init使用 CLAUDE.md 指南初始化專案
/login切換 Anthropic 帳戶
/logout登出你的 Anthropic 帳戶
/pr_comments查看拉取請求評論
/review請求程式碼審查
/terminal-setup安裝 Shift+Enter 換行鍵綁定（僅限 iTerm2 和 VSCode）

​
管理權限和安全性

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

工具類型範例需要批准”是的，不要再詢問”行為
唯讀檔案讀取、LS、Grep否不適用
Bash 命令Shell 執行是對專案目錄和命令永久有效
檔案修改編輯/寫入檔案是直到會話結束

​
Claude 可用的工具

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

工具描述需要權限
AgentTool運行子代理來處理複雜的多步驟任務否
BashTool在你的環境中執行 shell 命令是
GlobTool基於模式匹配尋找檔案否
GrepTool在檔案內容中搜尋模式否
LSTool列出檔案和目錄否
FileReadTool讀取檔案內容否
FileEditTool對特定檔案進行針對性編輯是
FileWriteTool創建或覆寫檔案是
NotebookReadTool讀取和顯示 Jupyter 筆記本內容否
NotebookEditTool修改 Jupyter 筆記本單元格是

​
防止提示注入

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

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

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

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

雖然這些保護措施顯著降低了風險，但沒有系統能完全免疫所有攻擊。在使用任何 AI 工具時都要保持良好的安全實踐。

​
配置網路訪問

Claude Code 需要訪問：

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

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

​
優化你的終端機設置和配置環境

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

支援的 shell：

  • Bash
  • Zsh（目前不支援 Fish shell）

​
主題和外觀

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='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

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

DISABLE_PROMPT_CACHING=1

需要標準 AWS SDK 憑證（例如，~/.aws/credentials 或相關環境變數如 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY）。聯繫 Amazon Bedrock 以獲取提示快取，以降低成本並提高速率限制。

​
連接到 Google Vertex AI

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

Vertex AI 上的 Claude Code 目前只支援 us-east5 區域。確保你的專案在這個特定區域有配額分配。

需要通過 google-auth-library 配置標準 GCP 憑證。為獲得最佳體驗，請聯繫 Google 以提高速率限制。

​
開發容器參考實現

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

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

雖然 devcontainer 提供了實質性的保護，但沒有系統能完全免疫所有攻擊。始終保持良好的安全實踐並監控 Claude 的活動。

​
主要功能

  • 生產就緒的 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: 在容器中重新打開”）

​
配置細分

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

​
安全功能

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

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

​
自定義選項

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

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

​
下一步

Claude Code 教程

常見任務的分步指南

參考實現

克隆我們的開發容器參考實現。

​
許可和數據使用

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

​
我們如何使用你的數據

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

​
反饋記錄

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

​
隱私保護措施

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

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

​
許可

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

Was this page helpful?

嵌入向量Claude Code 教學