Skip to main content

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

即使您從未使用過終端機，也可以使用 Claude Code。本指南將引導您開啟終端機、安裝 Claude Code 以及進行首次互動。
不想使用終端機？Claude Code 桌面應用程式可讓您完全跳過終端機。下載 macOS 或 Windows 版本，然後查看桌面快速入門以開始使用。

​
macOS 和 Linux

按照以下步驟從 macOS 或 Linux 終端機安裝並啟動 Claude Code。Claude Code 需要 macOS 13.0 或更新版本。請查看系統需求以了解支援的 Linux 發行版。
1

開啟終端機

macOS：按 Cmd + Space 開啟 Spotlight 搜尋，輸入 Terminal，然後按 Enter。Linux：開啟您的終端機應用程式。在大多數發行版上，按 Ctrl + Alt + T 或在應用程式選單中搜尋’Terminal’。一個視窗將出現，顯示閃爍的游標。這就是您的終端機，您可以在此輸入命令。
2

安裝 Claude Code

複製此行，將其貼到您的終端機中（macOS 上按 Cmd + V，Linux 上按 Ctrl + Shift + V），然後按 Enter：
curl -fsSL https://claude.ai/install.sh | bash
這會從 claude.ai 下載並執行 Claude Code 安裝程式。您會看到文字滾動。完成後，您會看到「Claude Code successfully installed!」訊息。如果您看到錯誤，請查看下方的疑難排解部分。
3

啟動 Claude Code

輸入 claude 並按 Enter：
claude
系統會提示您使用 Claude 帳戶登入。按照螢幕上的指示進行。瀏覽器視窗將開啟供您登入。
4

開始使用 Claude Code

登入後，您可以開始詢問 Claude 有關您的程式碼或任何其他事項的問題。Claude Code 完全以文字形式執行。您輸入訊息並按 Enter 發送。以下是一些需要了解的事項：
  • 您無法在終端機中點擊任何內容。使用箭頭鍵移動。
  • 按 Esc 中斷 Claude（如果它正在執行）。
  • 輸入 exit 或按 Ctrl + D 以離開 Claude Code。
  • 輸入 /help 以查看可用命令。

​
Windows

按照以下步驟在 Windows 上選擇性地安裝 Git for Windows、設定 PowerShell 並啟動 Claude Code。Claude Code 需要 Windows 10 版本 1809 或更新版本。請查看系統需求以了解完整詳細資訊。
1

安裝 Git for Windows（選擇性）

Git for Windows 提供 Git Bash，可啟用 Bash 工具。沒有它，Claude Code 會改用 PowerShell。您不需要自己學習 Git。如果您還沒有安裝：
  1. 前往 git-scm.com/downloads/win 並下載安裝程式
  2. 執行安裝程式。在每個畫面上點擊 Next 以接受預設值。安裝程式有許多畫面，但您不需要變更任何內容。
  3. 如果它要求您選擇編輯器，保持預設值並點擊 Next。
  4. 當您看到’Adjusting your PATH environment’時，保持建議的選項被選中。
已經有 Git？您可以跳過此步驟。如果您不確定，無論如何安裝它。重新安裝不會造成問題。
2

開啟 PowerShell

PowerShell 是 Windows 內建的終端機，用於輸入命令。它預先安裝在每台 Windows 電腦上。按 Win + X 並從選單中選擇 Windows PowerShell（或 Terminal）。一個帶有閃爍游標的視窗將出現。這是您輸入命令的地方。
Windows 有兩個命令列程式：PowerShell 和 CMD。它們看起來相似但使用不同的命令。確保您在 PowerShell 中進行下一步。判斷您在哪一個的方法：
  • PowerShell：在每行的開始顯示 PS C:\Users\YourName>
  • CMD：顯示 C:\Users\YourName>，沒有 PS
3

安裝 Claude Code

複製此行，使用 Ctrl + V 或右鍵點擊將其貼到 PowerShell 中，然後按 Enter：
irm https://claude.ai/install.ps1 | iex
這會下載並執行 Claude Code 安裝程式。irm 會擷取檔案，iex 會執行它。您會看到文字滾動。完成後，您會看到’Claude Code successfully installed!’訊息。如果您看到錯誤，請查看下方的疑難排解部分。
如果您在 CMD 而不是 PowerShell 中，請使用此命令：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
4

啟動 Claude Code

關閉 PowerShell 並開啟新的 PowerShell 視窗，以便它識別新安裝的 claude 命令。然後輸入：
claude
系統會提示您使用 Claude 帳戶登入。按照螢幕上的指示進行。瀏覽器視窗將開啟供您登入。
5

開始使用 Claude Code

登入後，您可以開始詢問 Claude 有關您的程式碼或任何其他事項的問題。Claude Code 完全以文字形式執行。您輸入訊息並按 Enter 發送。以下是一些需要了解的事項：
  • 您無法在終端機中點擊任何內容。使用箭頭鍵移動。
  • 按 Esc 中斷 Claude（如果它正在執行）。
  • 輸入 exit 或按 Ctrl + D 以離開 Claude Code。
  • 輸入 /help 以查看可用命令。

​
接下來呢？

一旦您看到 Claude Code 歡迎畫面，您就可以開始了。您不需要知道如何編寫程式碼。用簡單的英文描述您想要的內容，Claude 會為您編寫程式碼。

​
建立一些東西

Claude 可以根據描述建立專案： 
make me a simple webpage that says hello world
Claude 為您建立檔案。雙擊 HTML 檔案以在瀏覽器中開啟它。

​
使用電腦上的檔案

Claude 可以讀取和組織您已有的檔案： 
look at the screenshots on my Desktop and rename them based on what's in each image

​
提出問題

Claude 可以解釋事物、幫助您學習或規劃專案： 
I want to build a personal budget tracker. What would I need?
如果您還沒有專案，沒關係。Claude 可以幫助您開始一個新專案。

​
使用 Claude Code 的其他方式

您不必使用終端機。Claude Code 也可在以下位置使用：

​
深入了解

​
疑難排解

​
macOS 和 Linux 疑難排解

如果您在 macOS 或 Linux 上安裝時遇到問題，請檢查這些常見問題：
如果在安裝後看到 command not found: claude，您的終端機需要重新載入其設定。關閉終端機視窗並開啟新視窗，然後再試一次 claude。如果仍然不起作用，請將安裝目錄新增到您的 PATH。為您的 shell 執行命令：
# Zsh (macOS 預設)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Bash (Linux 預設)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
然後再試一次 claude。如需更多詳細資訊，請參閱修復您的 PATH。
如果您看到 bash: line 1: syntax error near unexpected token '<' 或終端機中出現 HTML 程式碼（如 <!DOCTYPE html>），安裝 URL 傳回的是網頁而不是安裝程式指令碼。如果頁面顯示’App unavailable in region’，Claude Code 在您的國家/地區不可用。請參閱支援的國家/地區。否則，請嘗試再次執行命令。如果持續發生，請改用 Homebrew 安裝：
brew install --cask claude-code
如果您看到 dyld: cannot load、dyld: Symbol not found 或 built for Mac OS X 13.0，您的 macOS 版本可能比 Claude Code 支援的版本更舊。開啟 Apple 選單並選擇「About This Mac」以檢查您的版本。如果它比 13.0 更舊，請透過軟體更新更新 macOS。請參閱 macOS 疑難排解指南以了解更多詳細資訊。
如需其他錯誤，請參閱完整的安裝疑難排解指南。

​
Windows 疑難排解

如果您在 Windows 上安裝時遇到問題，請檢查這些常見問題：
您在 CMD 中，而不是 PowerShell。關閉此視窗並改為開啟 PowerShell（Win + X 然後選擇 Windows PowerShell）。或者，使用 CMD 安裝命令：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
這通常發生在較舊的 Windows 10 系統上。先執行此行，然後重試安裝：
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex
找不到 PowerShell 或 Git Bash。Claude Code 需要至少一個 shell。
  1. 確保 powershell.exe 在您的 PATH 上。其預設位置是 C:\Windows\System32\WindowsPowerShell\v1.0\。或者，安裝 PowerShell 7，它提供 pwsh。
  2. 如果您寧願使用 Git Bash，請安裝 Git for Windows，按照 Windows 部分的第一步。
  3. 如果已安裝 Git 但 Claude Code 找不到它，請告訴它在哪裡查找： 
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
    然後再次執行 claude。如果您的 Git 安裝在其他地方，請透過執行以下命令找到路徑： 
    Get-Command git | Select-Object Source
    在該路徑中查找 Git\bin 資料夾並改用它。
要使其永久化，以便您不必每次都設定它，請參閱設定 Git Bash 路徑。
重新啟動您的電腦並再試一次。這通常會解決問題。如果重新啟動沒有幫助，請執行這些命令以將 Claude Code 新增到您的 PATH：
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
關閉 PowerShell，開啟新視窗，然後再試一次 claude。請參閱驗證您的 PATH以了解更多詳細資訊。
如需其他錯誤，請參閱完整的安裝疑難排解指南。