小編精選 - 技術文章翻譯 · 05月03日

關於 Claude Code 的一些想法

這次，將由 Mynavi 出版發行一本名為 《提升開發效率！Claude Code 實用入門》 的書籍。

［Amazon 在這裡］https://www.amazon.co.jp/o/ASIN/4839990204/mynavibooks-22/

至於我為什麼要寫這本書，答案很簡單：因為我希望讓更多人使用 Claude Code。就是這麼回事。

如果你看看 Twitter（X）等社群媒體，幾乎每天都能看到新的用法介紹，但像是「裝上 MCP」「寫 Skill」「並排多個子代理」之類的說法滿天飛，對於剛開始接觸的人來說，根本不知道在說什麼。那些是 在已經會用 Claude Code 之後 才會碰到的話題。

現在整理出來的 Claude Code 資訊太難了！

所以這本書，我是以 從最基礎開始，簡單說明 Claude Code 用法 的方式來寫的。其實，這背後也有一個想法：我希望不只是工程師，連非工程師的人也能使用 Claude Code。

我盡量把內容寫得簡單易懂，因此如果你正想開始使用 Claude Code，還請務必讀讀看。

安裝在自己電腦上的代理型工具

詳細內容讀書就會明白，不過先說結論：Claude Code 是一種安裝在自己電腦上的 代理型工具。這是它最大的特色，只要抓住這一點，就能理解 Claude Code 為什麼會流行！

像 ChatGPT 這種聊天型工具，基本上無法真正進行正式的程式開發。 因為你得在瀏覽器裡一直複製貼上。
如果只是要產出程式碼片段還可以，但要人類把全部內容手動複製貼上，實在不現實吧。一般來說，系統的原始碼不會只有一個檔案，而是由很多檔案組成。要把這些全部附加到聊天型工具中處理，不只麻煩，容量上也很吃力。

相對地，Claude Code 是代理型工具。它安裝在自己的電腦上，會統整處理放在特定資料夾底下的原始碼。 它會讀取整份原始碼中需要的部分，並且可以修改所有檔案，也能建立新檔案。如果你的開發情境本來就是多檔案架構，那除了代理型工具之外，幾乎沒有別的選擇。

▲聊天型與代理型的差異

也可以執行命令

Claude Code 不只是能產生程式碼，還可以在已安裝的電腦上執行命令。最容易想到的當然是「建置」或「部署」，但除此之外，它還能執行很多種命令。

這對各種 自動化 很有幫助。

前面提到希望 本書也能讓非工程師閱讀，原因就在這裡。

例如，當你面對「有很多 PDF 檔案，想把它們轉成文字」「想把音訊檔轉成文字」這類情境時，使用 Claude Code，就可以做到「安裝可讀取 PDF 的軟體（函式庫）並執行轉文字」「安裝音訊轉文字工具並執行」這些事。Claude Code 本身就是生成式 AI，因此還能把這些轉換後的文字進一步「改寫得更容易閱讀」，而且可以一氣呵成完成。

此外，本書也用整整一章來解說：若搭配可自動化瀏覽器的 Playwright，就能實現 「瀏覽器自動駕駛」。如此一來，前陣子流行的「RPA（Robotic Process Automation，機器人流程自動化）」那類工作，就能不用寫程式，直接用自然語言來操作。

也就是說，你只要下達像是 「連到 A 網站，點擊 B 按鈕，擷取畫面上顯示的金額表，然後輸出到 price.txt」 這樣的指令，就能辦到。

Claude Code 之所以在商務領域也能派上用場，正是因為它具備這類能力。Claude Code 不只是工程師專用工具。

使用容器來消除不安

使用 Claude Code 時，需要特別注意安全性。

如前所述，Claude Code 是安裝在自己電腦上使用的工具，而且它不只會改寫自己電腦上的檔案，還會執行命令。

因此，有時也可能發生「刪掉電腦上的重要檔案」「把電腦中保存的個人資訊上傳到網際網路」「在電腦上安裝可疑軟體」這類情況。

所以我認為，直接把 Claude Code 安裝在自己的電腦上是有風險的。

這時就輪到 容器技術 登場了。透過在隔離的容器環境中執行，即使 Claude Code 做出可疑動作，影響也能侷限在那個容器裡。由於 Claude Code 無法存取容器外部，只要不要把個人資訊等資料放進容器裡，就不必擔心資料外洩。

容器技術具體來說像 Docker 之類，但 Docker 對初學者而言並不容易。因此本書採用的是 DevContainer 這個機制。

DevContainer 是一種可從 Visual Studio Code 之類的開發工具自動啟動容器的機制。只要寫好 devcontainer.json 這個檔案、放到資料夾裡，再用 Visual Studio Code 開啟，就會自動啟動容器，因此就算是第一次接觸的人，也能相對容易地使用。

本書從「只要準備好 Visual Studio Code + Docker Desktop + DevContainer 的環境，就能讓任何人輕鬆又安全地使用 Claude Code」這個環境開始。

當然，也有人會覺得安裝 Docker Desktop 很困難，或根本無法準備這樣的環境。對這些人來說，不使用容器、直接安裝到自己的電腦上也沒問題。在那種情況下，仍然可以做出與本書相同的操作與解說內容。

不過，直接安裝在自己電腦上的做法，心理上並不舒服。Claude Code 每做一件事，都會向人類確認「這個操作可以進行嗎」，所以你必須準確地回答。抱著「萬一答錯導致問題發生怎麼辦」的心情來工作，壓力其實很大。但如果是容器環境，即使真的做錯而造成大問題，也不會影響到自己的電腦。

為了消除這種不安，我非常推薦在容器環境中使用 Claude Code。

▲使用 Visual Studio Code + DevContainer 來操作 Claude Code 的樣子

說到底還是設計與測試

把話題拉回開發本身，本書最終的主題，就是第 10 章標題所說的 「睡覺的時候程式碼就完成！目標是打造究極自動化程式開發環境」。

這件事其實很簡單：先建立測試，只要測試通過就算合格！在那之前，就一直讓 Claude Code 持續進行開發。為了做到這點，先準備好完善的設計文件並交給它非常重要（否則開發途中容易崩壞，最後無法完成），而建立測試也同樣重要。
（關於這部分，官方文件「Claude Code 的運作原理」中提到的「agentic 迴圈」說明得很詳細。本書也有相關解說；理解 agentic 迴圈，可以說是理解 Claude Code 的第一步。）

雖然用文字講很簡單，但設計和測試如果全部都由人來做，其實很辛苦。

因此本書會說明：如何先做出大致的規格，再與 Claude Code 一起討論並完成設計；以及如何從設計自動生成測試項目，甚至連測試程式碼也一起自動產生。

我甚至還介紹了如何製作附有螢幕截圖證據的測試結果，所以我想這對 SIer 的工作也會非常有幫助！

▲附證據的測試實例

MCP、Skill 和子代理，說到底真的需要嗎？

順帶一提，前面提到的 MCP、Skill、子代理，這些到底需不需要？我的看法是：「有當然方便，但它們屬於進階用法」。

讀完本書你就會明白，MCP 是外部連動系統，Skill 是副程式，子代理則像是執行緒（平行處理）。

它們確實可以增加可做的事情，但我坦白說，這些應該是在理解 Claude Code 之後再來考慮就好。

因為即使不用這些，也照樣能實現。Claude Code 就算沒有另外安裝這些，也能「自動寫出實現它的程式碼並執行」。只是要做出來需要時間（也就是成本），所以如果事先加上現成的功能，就能省下為此寫程式的時間，概念就是這樣。

正如前面所說，MCP、Skill、子代理的本質，就是「把別人做的（或自己做的）功能擴充整合進來」。沒有也能想辦法辦到，但有的話會更方便。

不過，一旦習慣使用 MCP、Skill、子代理之後，確實會有「沒有這些的效率差很多」的感受，所以本書後半也有提到；從這個角度來看，我也能理解為什麼這類話題會在 Twitter（X）上成為熱門。

然而，它們不可能成為主軸。因為哪些工具好用，因人而異。不能說「裝了這個，Claude Code 就無敵了」，所以我認為比較適合把它理解成過去程式開發環境中的那種 「這個函式庫超強！」 的感覺。

本書將於 5 月 19 日發售，但會先行販售

本書預定於 5 月 19 日發售，目前已經開始預購。

如果你等不及 5 月 19 日，那其實也有先行販售。

5 月 10 日的「技術書同人誌博覽會」（技書博） 這個技術同人誌活動，會在大田區產業廣場 PiO 舉辦，屆時 Mynavi 出版也會設攤，並進行 先行販售。

※技術書同人誌博覽會是與在池袋舉辦、知名的技術同人誌活動「技術書典」不同的主辦母體。請注意不要向技術書典詢問相關事項。

我（大澤文孝）也會在名為 「モウフカブール」 的社團攤位參展。雖然這只能說是盡力而為，無法保證，但如果活動當天你來向我打招呼，我也可以簽名。若你有機會來現場，非常歡迎在會場見面！

※モウフカブール販售的是由我，以及同樣是技術寫作者的小笠原種高（撰寫 AWS 書籍與 Docker 書籍等）所創作的同人誌。目標是讓你今天還不懂、到明天、後天左右就能理解，因此以 500 日圓販售的「明後日系列」。新刊主題是「加密・認證」與「AI・機器學習」。此外還有稍微進階一些的「和解せよ系列」等作品，也歡迎到會場看看。

※參加免費，但請完成 Connpass 報名，並以「一般參加者」身分註冊。https://gishohaku.connpass.com/event/372013/

我對 Claude Code 還有一些想法，之後也會持續充實相關文章。敬請期待！

原文出處：https://qiita.com/sour23/items/e95f490b6533227fe73c