克勞德程式碼入門教學：30分鐘內啟動你的第一個AI代理

你肯定聽過 Claude Code。你肯定看過那些截圖、爆款演示視頻，還有那些“我周末就發布了一款產品”的推文。現在你是不是在想，這到底是不是真的？ 克勞德程式碼入門教程 實際上確實存在這樣一本書——它是為運營商和個體經營者寫的，而不是為前谷歌工程師寫的。.

這裡是。.

我目前在生產環境中運行著十多個自主AI業務容器。 Claude Code是其中大多數容器背後的引擎。本教學將一步步引導您了解Claude Code是什麼、如何安裝以及如何運行您的第一個智慧任務—無需任何開發背景。教程結束時，您將成功安裝並執行Claude Code。讓我們開始吧！.

什麼是 Claude Code？為什麼非開發人員也應該關注它？

Claude Code 是由 Anthropic 公司（Claude 的開發公司）開發的命令列 AI 代理。與 ChatGPT 或常規的 Claude.ai 介面（使用者輸入訊息並閱讀回應）不同，Claude Code 的工作原理是：使用者直接輸入訊息，然後透過命令列輸入訊息。 行為. 它會讀取你的檔案、編寫程式碼、執行命令、修復錯誤，並循環執行直到任務完成——所有這些都在你自己的機器上，使用你自己的檔案。.

不妨這樣理解：你不是向人工智慧提問，而是給它一個初級開發人員的任務。你指定一個資料夾，然後說「審核這段程式碼庫是否有安全性問題」或「編寫一個 Python 腳本，從這個 API 取得資料並將其格式化為 CSV 檔案」。它會完成工作，向你展示它的工作內容，並在執行任何不可逆操作之前徵求你的意見。.

對於非開發人員來說，這一點意義重大。您無需了解 Python、JavaScript 或 Bash 即可有效使用 Claude Code。您只需要知道自己想要什麼。您需要描述結果，而不是語法。這是一種完全不同的技能——而且您可能已經掌握了。.

克勞德·科德實際上做了什麼：

• 讀取和編輯項目資料夾中的文件
• 執行 shell 命令（安裝軟體包、啟動伺服器、查詢 API）
• 搜尋網路和程式碼庫以獲取上下文信息
• 迭代式運行－如果某個步驟失敗，它會找出原因並再嘗試。
• 在執行任何破壞性操作（刪除檔案、推送到生產環境）之前，都會先徵求許可。

若要深入了解智慧AI在實際操作環境中能做什麼，請閱讀我的完整文章。 克勞德代碼操作員指南 — 它涵蓋了你需要具備的思考模式，以便從每次訓練中獲得最大利益。.

開始之前：執行 Claude 程式碼實際需要什麼

好消息：門檻比你想像的還要低。以下是真實名單。.

硬性要求

• 具有 API 存取權限的 Claude 帳戶 — 您需要一個 Anthropic 帳戶和一個 API 金鑰。如果您一直在使用 Claude.ai，則您已經擁有帳戶；您只需新增 API 存取權限即可。 console.anthropic.com. 在輕度至中度使用情況下，每月預算約為 $5–20。.
• 已安裝 Node.js — Claude Code 透過 npm（Node 的套件管理器）運作。如果您從未聽說過 Node.js，沒關係——安裝它只需三分鐘。您可以從 nodejs.org 下載。.
• 終端 — 在 Mac 上，可以使用內建的終端應用程式。在 Windows 上，可以使用 PowerShell 或安裝 WSL（適用於 Linux 的 Windows 子系統）。在 Linux 上，你應該知道該怎麼做。.

錦上添花（但非必要）

• 一個可供使用的程式碼專案（Claude Code 可以處理任何資料夾——即使只有幾個文字檔案的資料夾）
• 可以使用 VS Code 或任何文字編輯器來檢視 Claude 所寫的內容。
• 基本熟練地在終端機視窗中輸入命令

你不需要什麼

你做 不是 無需懂編程。你不需要電腦科學學位或十年開發經驗。 Claude Code 專為可以用簡單英語描述的任務而設計。代理程序負責具體的實現。.

如果你仍然對終端感到畏懼，那正是你需要培養的技能。花30分鐘閱讀一份終端入門指南－Anthropic 的文檔裡就包含一份－你就能掌握所需的一切。.

如何安裝 Claude Code：新手入門逐步指南

這是大多數教學都會略過的部分。讓我們正確地完成它。.

步驟 1：安裝 Node.js

前往 nodejs.org 下載 LTS 版本（長期支援版，即穩定版）。運行安裝程式。安裝完成後，打開終端機並輸入：

node --version

你應該會看到類似這樣的內容 v22.0.0. 如果顯示了版本號，則表示 Node.js 已安裝。繼續下一步。.

步驟 2：透過 npm 安裝 Claude Code

在終端機中運作：

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

這 -g 該標誌會將其全域安裝，因此您可以從任何資料夾運行它。這需要 30-60 秒。您可能會看到大量文字滾動顯示—這是正常現象。.

步驟 3：設定您的 API 金鑰

Claude Code 需要您的 Anthropic API 金鑰才能與 Claude 通訊。請從此處取得您的密鑰。 console.anthropic.com → API 金鑰. 然後在你的終端機中：

export ANTHROPIC_API_KEY="sk-ant-your-key-here""

為了使其永久生效，無需每次都進行設置，請將其添加到您的 shell 配置檔案中（~/.zshrc 在 Mac 上或 ~/.bashrc 在 Linux 系統上）：

echo 'export ANTHROPIC_API_KEY="sk-ant-your-key-here"' >> ~/.zshrc source ~/.zshrc

步驟 4：首次運行 Claude 程式碼

導航至任意項目資料夾。即使只有一個文字檔案的資料夾也適用於測試：

cd ~/Desktop/my-project claude

Claude Code 會在您的終端機中啟動一個互動式會話。輸入您的第一個任務。可以很簡單：

列出此資料夾中的所有文件，並簡要說明每個文件的功能。.

看看它是如何運作的。這是你第一次的智能體人工智慧會話。.

你的第一個 Claude Code 教學演練：來自我的建置日誌的真實任務

理論不值錢。這是我上週交給 Claude Code 的實際任務，它是我 JonOps 自動化堆疊的一部分。.

任務： 我有一個資料夾，裡面有 47 張產品圖片，檔案名稱都很普通，例如： image001.jpg. 我需要描述性的檔案名稱和替代文字以優化搜尋引擎排名。手動重命名會花費數小時。所以我把這項工作交給了 Claude Code。.

我給出的確切提示是：

請查看 /products 資料夾中的圖片。針對每張圖片，根據圖片內容產生一個描述性的、對搜尋引擎友善的檔案名稱。將文件名稱映射關係寫入一個 CSV 文件，文件包含以下列：original_filename、new_filename 和 alt_text。暫時不要重命名任何文件——只需先建立映射文件，以便我進行審核。.

發生了什麼事： Claude Code 利用其視覺識別功能分析每張圖片，產生描述性名稱，並創建了一個包含全部 47 行資料的簡潔 CSV 檔案。我審核了該文件，做了兩處小修改，然後讓 Claude 套用重新命名。八分鐘內完成。.

這才是人工智慧如何改變工作方式的真實寫照。它不僅僅是“人工智慧幫我寫郵件”，而是人工智慧能夠端到端地處理多步驟的生產任務。.

要學習的模式

注意提示是如何組織的：它描述了… 目標, ，設定一個 約束 （暫不重命名），並要求一個 可審查的工件 首先，這是智能體工作流程模式。你不是讓克勞德·科德盲目地完成任務——你是在建立一個回饋循環。.

我在一份報告中詳細分析了這種模式在實際生產週中的運作方式。 週一建置日誌. 如果你想了解完整的操作員工作流程，這篇文章值得一讀。.

克勞德代碼命令，每個初學者都應該知道

一旦你進入 Claude Code 會話（你已經輸入了 克勞德 在你的終端機中），以下是剛開始使用時最重要的命令和快捷鍵。.

會話命令

• /幫助 — 列出所有可用的斜線指令和快捷方式
• /清除 — 清除對話情境（切換任務時很有用）
• /出口 或者 Ctrl+C — 克勞德代碼退出
• /袖珍的 — 壓縮對話歷史記錄，以便在處理長時間任務時釋放上下文訊息

權限管理

預設情況下，Claude Code 會在執行 shell 命令或修改檔案之前詢問。您可以調整此設定：

• 按回車鍵 — 批准並執行擬議行動
• 輸入“否”或“跳過” — 拒絕而不結束會話
• 克勞德——危險地跳過權限 — 自動批准所有內容（僅適用於封閉的、低風險的工作流程）

傳遞文件和上下文

# 啟動一個會話，並指定上下文中的檔案 claude --add-file path/to/yourfile.txt # 啟動一個專注於特定任務的會話 claude "審核此程式碼庫的安全漏洞並輸出 Markdown 報告""

非互動式（無頭）模式

這就是自動化功能的強大之處。您可以將 Claude Code 作為腳本運行：

claude --print "寫一個 Python 函數，讀取 CSV 檔案並輸出 JSON 檔案" --output-format json

這 --列印 此標誌以非互動方式運行任務並將輸出輸出到標準輸出 (stdout)。這樣，您可以將 Claude Code 的輸出透過管道傳遞給 shell 腳本、cron 作業和自動化工作流程。我就是這樣將其整合到 JonOps 技術堆疊中的——Claude Code 按計劃運行，無人值守，執行實際工作。這正是我們所需要的。 自主人工智慧代理 由……構成。.

使用 Claude Code 建立您的第一個自動化腳本

這裡有一個實用的入門自動化流程，你可以在 30 分鐘內建立完成。這是我實際使用的模式。.

目標： 一個簡單的腳本，讀取任務文字文件，將任務逐一傳遞給 Claude Code，並儲存輸出結果。.

步驟 1：建立任務文件

建立一個名為 任務.txt 每行一個任務：

請撰寫一篇100字以內的手工陶瓷馬克杯產品描述，內容需符合搜尋引擎優化（SEO）要求。請為一篇關於人工智慧自動化技巧的簡報撰寫主題。請用重點總結本週人工智慧產業的三大要點。

步驟 2：建立自動化腳本

建立一個名為 運行任務腳本:

#!/bin/bash mkdir -p outputs while IFS= read -r task; do echo "正在執行任務：$task" RESULT=$(claude --print "$task" 2>/dev/null) FILENAME="outputs/$task" 2>/dev/null) FILENAME="outputs/$task" 2>/dev/null) FILENAME="outputs/$t 12>/T4Sf TP4441 -FFILENAME=" 'a-zA-Z0-9-' | cut -c1-40).txt" echo "$RESULT" > "$FILENAME" echo "已儲存至 $FILENAME" done < tasks.txt echo "所有任務已完成。"

步驟三：運行它

chmod +x run-tasks.sh ./run-tasks.sh

Claude Code 會處理每個任務，將輸出儲存到文件，然後繼續處理下一個任務。這是一個批次 AI 處理腳本。建造它只花了 10 分鐘。可按計劃運行。設定完成後，每次運行無需人工幹預。.

如果你想看看規模化之後是什麼樣子——多個 Claude Code 代理、Airtable 用於跟踪、定時 cron 運行——請查看我的文章。 我如何使用 Claude Code 批量更新數百種 WooCommerce 產品的替代文本. 同樣的原理，應用於生產規模。.

更進一步：將 Claude 程式碼加入 Cron 排程任務中

腳本運行穩定後，您可以使用 cron（Mac/Linux 系統）或任務排程器（Windows 系統）設定腳本自動執行。以下是一個基本的 cron 條目範例，用於設定腳本每天早上 7 點運行：

# 編輯你的 crontab 檔案：crontab -e # 加入以下行（每天早上 7 點運行 run-tasks.sh）：0 7 * * * /bin/bash /path/to/your/run-tasks.sh >> /path/to/your/outputs/log.txt 2>&1

就是這樣。 Claude Code 按計劃運行，將輸出寫入文件，並記錄所有錯誤。你醒來就能看到工作完成。這是我運行的每個自治系統的核心模式——簡單的 shell 腳本，由 cron 定時任務驅動，在無頭模式下運行的 Claude Code 提供支援。.

以下幾點確保了 Claude Code 定時運行的可靠性：

• 始終將標準輸出和標準錯誤輸出記錄到檔案中（ 2>&1 重定向）以便您可以審核發生了什麼
• 在您的 Anthropic 控制台中設定消費上限，以免帳單上出現意外的超額消費。
• 將輸出寫入帶有日期戳記的檔案名稱（output-$(date +%Y-%m-%d).txt這樣你就可以追蹤隨時間發生的變化
• 在安排整個任務清單之前，先用一個任務進行測試。

從「手動執行 Claude Code」到「Claude Code 在我睡覺時運行」的轉變只有三個步驟：編寫腳本，使其無頭運行（--列印），然後新增一條 cron 指令。這就是實現任何規模自主運作的全部秘訣。.

關於 Claude Code 的常見問題解答（面向初學者）

Claude Code是免費的嗎？

不——Claude Code 使用您的 Anthropic API 金鑰，並按令牌（大致按單字）收費。個人日常使用每月消耗 $5-20 個代幣。高強度自動化工作流程每月消耗 $50-200 個令牌。 API 存取沒有固定訂閱，您只需為實際使用量付費。請合理安排預算，並在 Anthropic 控制台中設定 API 消費限額。.

我需要懂程式設計才能使用Claude Code嗎？

使用 Claude Code 完成大多數任務無需任何程式設計知識。但您需要熟悉終端機（命令列）。如果您以前從未使用過終端，請先花 30 分鐘閱讀一份基礎指南——這是唯一的障礙，但完全可以在一個下午學會。.

Claude Code 與直接在瀏覽器中使用 Claude.ai 有何不同？

Claude.ai（網頁介面）是一個對話工具。您輸入內容，它會做出回應，您的文件或系統不會發生任何變化。 Claude Code 是一個智能體——它可以讀寫檔案、運行命令、呼叫 API 並自主執行多步驟任務。它在您的實際環境中運行，而不是在沙箱環境中運行。.

Claude Code 在實際專案中使用安全嗎？

是的，只要謹慎操作即可。預設情況下，Claude Code 會在執行 shell 命令或修改檔案之前請求權限。未經明確批准，它不會刪除文件或推送到生產環境。為了在實際專案中最大限度地確保安全：請先在專案資料夾的副本中進行操作，在批准之前檢查每個操作，並且永遠不要直接執行命令。 --dangerously-skip-permissions 在生產系統中。.

Claude Code 與其他 AI 編碼工具（例如 GitHub Copilot）有什麼不同？

GitHub Copilot 和類似的工具會在你輸入程式碼時自動補全程式碼——它們是開發者編寫程式碼的助手。 Claude Code 是個智能體，它可以自主執行你用簡單語言描述的任務。 Copilot 幫助開發者更快地編寫程式碼；而 Claude Code 則執行完全不需要你成為開發者的任務。.

我可以在Windows系統上使用Claude Code嗎？

是的。 Claude Code 可以在 Windows 系統上運行，透過 PowerShell 或——最好是——WSL（Windows 子系統 Linux 版）來實現。 WSL 為 Windows 提供了一個真正的 Linux shell，這使得運行 shell 腳本和自動化任務更加流暢。如果您使用的是 Windows 系統並且計劃進行大量的自動化工作，請先安裝 WSL。.

接下來該開發什麼：營運方的說明

如果你已經完整地學習了這篇 Claude Code 入門教程，那麼你現在已經安裝了 Claude Code，運行了你的第一個任務，並且了解了實現自動化所需的非交互模式。這就是基礎。.

接下來我會按順序建造以下東西：

1. 內容審核腳本 — 讓 Claude Code 指向一個包含部落格文章的資料夾，並檢查是否有 SEO 問題、缺少的元描述以及內容單薄等問題。只需運行一個腳本，每月運行一次。.
2. 電子郵件撰寫工作流程 — 輸入簡短資訊（主題、重點、受眾），讓它產生完整的電子郵件草稿並儲存到文件中。審核、編輯、發送。.
3. 數據到報告的管道 — 將 CRM 或分析工具中的 CSV 匯出檔案交給 Claude Code，讓它以簡單易懂的英文寫出關鍵趨勢的摘要。.

這些任務都遵循相同的模式：用簡單易懂的語言描述任務，Claude 完成任務，你審核結果。任務的複雜程度會逐步增加——但核心工作流程始終不變。.

如果你想看看持續推進這項技術最終會走向何方——基於 Claude Code 代理、定時任務和實時生產系統運行的完全自主的業務——這就是本網站的全部內容。從…開始 操作指南 當你準備好深入探索時。.