你的「嘴唇」總是有一圈黑黑的嗎?那你就要特別小心了!!


 

用 Claude Code 打造一鍵部署神器

Custom Command × Vercel 雲端部署 實戰教學

從 0 開始建立你的第一個客製化指令

串接 Vercel 帳號、自動部署、一鍵更新上線

根據教學影片《【Custom Command】一鍵完成 Vercel 雲端部署》整理製作


 

前言:這本書要帶你做什麼

在使用 Claude Code 的過程中,我們常常會重複請 AI 做同一件事,例如「把專案部署到 Vercel 上」。每次都要重新打一長串指令、講解需求,非常花時間。Claude Code 提供了一個很好用的功能,叫做「Custom Command(客製化指令)」,可以把一整套操作流程寫成一個檔案,之後只要打一個簡單的斜線指令,例如 /deploy_vercel,Claude Code 就會照著你事先寫好的步驟自動執行。

這本書會用一個實際案例,帶著你從零開始,一步一步建立屬於自己的 /deploy_vercel 指令,並且完成以下事情:

●     認識 Custom Command 的檔案結構與命名規則

●     讓 Claude Code 幫你自動寫出指令內容

●     完成 Vercel 帳號的登入與授權

●     執行第一次部署,並在瀏覽器中查看成果

●     驗證客製化指令能重複使用、一鍵重新部署

●     修改專案內容後,用同一個指令快速更新上線版本

●     深入解析指令檔案的內部結構,了解 Claude Code 是怎麼「看懂」你的需求的

範例中使用的專案是一個很簡單的網頁遊戲「Treasure Hunt Game(尋寶箱遊戲)」,玩家點擊寶箱後會隨機出現獎勵或扣分。我們會把這個專案部署到 Vercel,這是一個非常受歡迎、操作直觀的雲端部署平台,很適合快速把網站或應用程式發布到正式環境(production)。

小提醒

跟著本書操作前,請先確認電腦上已經安裝 Claude Code,並且擁有一個可以部署的專案。

畫面中出現的網址、部署連結每次執行都會不同,屬於正常現象,不用擔心跟書上不完全一樣。

Part 1 認識 Custom Command 與 Vercel

打開 Claude Code 之後,你可以打「/」叫出所有可用的指令清單。除了 /init、/context、/compact 這些內建指令之外,清單最下面還有一個特別的項目:/custom(Custom Commands,客製化指令)。這正是本書的主角——它讓你可以「教」Claude Code 一套固定的工作流程,之後隨時一鍵重複執行。

在正式動手之前,我們先花一點時間認識這次的部署目的地:Vercel。

Vercel 提供了非常直觀、簡單的部署方式:只要一個指令 npx vercel,就能把本機的專案發布到網路上,讓任何人都能透過網址瀏覽。這也是為什麼它很適合拿來當作我們第一個 Custom Command 練習範例——步驟少、成果立即可見。

Part 2 建立你的第一個 Custom Command

接下來,我們要動手建立指令檔案本身。首先開啟 VS Code,打開要部署的專案(本例中是尋寶箱遊戲的專案資料夾),並且把 Claude Code 的面板移動到編輯器下方,方便同時看到程式碼與對話內容。

2.1 建立 commands 資料夾

Claude Code 的客製化指令,是存放在專案根目錄底下的 .claude/commands 這個資料夾裡。如果你的專案還沒有這個資料夾,只要手動建立即可:先建立 .claude 資料夾,再往下建立一層 commands(複數)資料夾。

2.2 建立指令檔案,並注意命名規則

在 commands 資料夾裡新增一個 Markdown 檔案,這裡命名為 deploy_vercel.md。這一步有一個非常重要的規則:檔案名稱就是之後你要打的指令名稱。換句話說,只要檔案叫 deploy_vercel.md,之後在 Claude Code 裡輸入 /deploy_vercel,就會執行這個檔案裡描述的所有步驟。

 

Part 3 讓 Claude Code 幫你寫出指令內容

檔案建立好了,但裡面還是空的。與其自己手動寫規則,不如直接用對話的方式,讓 Claude Code 幫你生成內容。我們只要用一般的白話文,描述「這個指令應該做什麼」,Claude Code 就會把這段描述整理成結構化的指令檔案。

在終端機輸入以下的需求說明:

接著補上一個很實用的細節需求:部署完成之後,希望 Claude Code 回報一個可以直接瀏覽的網址,這樣才能立刻檢查成果。

按下 Enter 之後,Claude Code 會開始規劃並撰寫這個指令檔案。它會先列出待辦事項(To-do List),例如「建立 deploy_vercel.md 指令檔」「部署專案到 Vercel」「提供上線網址」,然後把內容寫進檔案,並詢問你是否要套用這次修改。

確認套用之後,Claude Code 會立刻開始照著剛寫好的指令內容,實際執行部署流程。因為這是第一次在這台電腦上使用 Vercel,它會先偵測到還沒登入,於是主動啟動登入流程(npx vercel login),並在終端機顯示一個授權網址。

Part 4 連接你的 Vercel 帳號

Vercel CLI 使用的是「裝置授權(Device Authorization)」流程:終端機會產生一組專屬代碼與連結,你只要在瀏覽器打開這個連結,用習慣的帳號(例如 Google)登入或註冊 Vercel,並確認要授權這台裝置使用你的帳號即可,完全不需要在終端機裡輸入密碼。

授權成功後,網頁會顯示「Authorization successful」,這時候就可以回到 VS Code,讓 Claude Code 繼續接下來的部署工作。

Part 5 完成第一次部署與測試

回到 VS Code 後,可以看到專案根目錄多了一個 .vercel 資料夾,裡面的 project.json 記錄了這個專案在 Vercel 上的 Project ID、所屬團隊等設定資訊——這些是 Vercel 用來辨識「這是同一個專案」的依據,之後每次重新部署,都會更新同一個專案,而不是每次都建立新專案。

Claude Code 接下來會自動嘗試建置(build)並部署專案。如果過程中遇到問題,它也會自己想辦法排除。例如這次示範中,Vercel 預期輸出資料夾是 dist,但專案實際的建置輸出資料夾是 build,導致第一次部署失敗;Claude Code 偵測到這個錯誤訊息後,自動建立了一個 vercel.json 設定檔來修正輸出路徑,然後重新部署,最終順利完成。

部署成功後,終端機會顯示一個 Live URL(上線網址)。點擊這個連結,瀏覽器就會開啟部署後的網站——這正是我們一開始要求 Claude Code 完成之後要回報的網址。實際點擊寶箱測試,遊戲也確實正常運作。

到這邊為止,我們已經成功地「請 Claude Code 部署了一次專案」。但這堂課真正的重點還沒登場——我們的目標,並不是每次都用一大段話請 Claude Code 手動做這件事,而是要把整個流程收斂成一個指令,之後想部署的時候,只要打 /deploy_vercel 就好。

Part 6 見證一鍵指令的威力:重新啟動並執行

為了驗證這個指令是不是真的「可重複使用」,我們先在終端機輸入 exit 離開 Claude Code,清空畫面(clear),再重新啟動一次 Claude Code。這一次,打「/」叫出指令清單時,就能看到清單裡多了一個全新的項目:/deploy_vercel——這就是我們剛剛建立的客製化指令,跟系統內建的指令並列在同一份清單裡。

直接執行它,不需要再重新描述一次需求,Claude Code 會照著 deploy_vercel.md 裡寫好的步驟,一步一步自動執行部署。

這正是 Custom Command 的價值所在:把「build → 部署 → 回報網址」這一整串步驟,濃縮進一個指令名稱裡。以後不管是誰、什麼時候要部署這個專案,都不用再重新解釋一次需求。

Part 7 修改專案後,一鍵重新部署

接下來做一個更貼近實際情境的測試:修改專案內容之後,看看指令是否真的能幫我們快速更新上線版本。這次的需求是:把寶箱遊戲中「找到寶藏」的獎勵金額,從 100 元改成 150 元。

回到 VS Code,直接跟 Claude Code 說明這個修改需求:

Claude Code 會自動在整個專案中搜尋跟「100」這個數字有關的程式碼與文字,並且逐一修改。這次總共更動了 4 個地方:遊戲計分邏輯、畫面上顯示的規則說明文字、開寶箱後的結果顯示、以及說明文件裡的敘述——確保所有地方的數字都同步更新,不會有些地方寫 100、有些地方寫 150 的不一致情形。

修改完成後,完全不需要重新學一次部署方式,只要再打一次 /deploy_vercel,Claude Code 就會用同樣的流程,把最新版本重新部署到 Vercel。

部署完成後,終端機清楚回報:這次的部署已經更新了現有的專案,並且說明「玩家現在找到寶藏會得到 150 元,而不是原本的 100 元」。點開新的網址驗證,畫面上的數字也確實變成了 150。

Part 8 深入解析 deploy_vercel.md:為什麼 Claude Code 看得懂?

最後,我們回頭仔細看看 Claude Code 一開始自動幫我們寫出來的 deploy_vercel.md 到底寫了什麼,為什麼短短一個檔案,就能讓 Claude Code 每次都精準執行同一套流程。整份檔案大致可以拆成四個區塊:

完整檔案內容

# Deploy to Vercel
 
This command deploys the treasure hunting game to Vercel for public access.
 
## Usage
```bash
npx vercel --prod
```
 
## Prerequisites
- Vercel CLI installed globally: `npm install -g vercel`
- Vercel account setup
- Project built for production: `npm run build`
 
## Steps
1. Build the project for production
2. Deploy to Vercel with production flag
3. Configure environment variables if needed
 
## Notes
- First deployment will require Vercel login and project setup
- Subsequent deployments will update the existing project
- The command will output the live URL upon successful deployment

逐段拆解

●     Usage(用法):說明這個指令實際上會執行什麼指令,這裡是 npx vercel --prod,代表要用正式環境(production)模式部署。

●     Prerequisites(前置條件):列出執行前需要具備的條件,例如要先全域安裝 Vercel CLI、要有 Vercel 帳號、專案要先能夠成功建置。

●     Steps(步驟):也就是我們在待辦清單中看到的三個步驟——建置專案、部署到 Vercel、視需要設定環境變數。

●     Notes(備註):提醒 Claude Code 一些額外的執行細節,例如第一次部署需要登入與專案設定、之後的部署會更新既有專案、完成後要回報上線網址。

換句話說,Custom Command 的核心概念,就是把「你會怎麼跟一個新同事解釋這件事該怎麼做」,寫成一份簡短但結構清楚的說明文件。你可以把任何想要重複執行的工作流程,用一樣的方式整理進一個 Markdown 檔案裡,變成專屬於你的指令。

結語與你的挑戰

透過這次的練習,我們從無到有,建立了一個可以一鍵把專案部署到 Vercel 的 Custom Command,並且實際驗證了它可以重複使用、也能在專案更新後快速重新部署。這只是 Custom Command 眾多應用場景中的一個例子——只要是你會重複執行的工作流程,都可以用同樣的方法,變成一個屬於自己的指令。

在結束這個單元之前,這裡有一個挑戰題,留給你自己動手試試看:

歡迎跟著本書的步驟親自操作一遍,親身體會 Custom Command 帶來的效率提升。






jesse

早安少女組成軍20周年 盼歷代團員「回娘家」 春節親子遊 來去卡通頻道運動會

張貼留言

較新的 較舊