身為 Mac 使用者,你是不是也曾羨慕別人擁有如 GitHub Copilot 般強大的 AI 程式助手,但又不想每個月負擔高昂的訂閱費用?或者是,你正在處理公司機密的專案,對將程式碼上傳到雲端有著深深的資安疑慮?很多非軟體背景的朋友一聽到「本地端架設 AI」就覺得是工程師專屬的黑魔法,甚至被「終端機」、「命令列」這些名詞嚇退。別怕!這篇超詳盡教學就是為你量身打造的。只要你手邊有一台搭載 M 系列晶片 (M1/M2/M3/M4) 的 Mac,我們將一步步帶你避開所有常見的新手坑,輕鬆建構專屬於你的神級 AI 助手,讓你的工作效率瞬間翻倍!

 

 

1. 觀念先修:我們要裝的東西到底是什麼?

在開始動手之前,我們先用最白話的方式理解接下來要做的三個步驟,這樣你在操作時才不會滿頭問號:

  • 第一步是裝「引擎」 (Ollama): 你可以把它想像成 AI 的心臟或馬達。它平時會在 Mac 背景默默運作,負責把硬體的效能榨出來給 AI 用。
  • 第二步是裝「大腦」 (模型 / Models): 引擎本身沒有知識,我們需要下載不同的模型。就像你可以給引擎裝上「數學天才」的大腦,或是「程式高手」的大腦。
  • 第三步是裝「方向盤與儀表板」 (Continue 擴充功能): 有了引擎和大腦,我們還需要一個好操作的介面來跟它講話,而 VS Code 裡面的 Continue 套件就是我們最棒的操作面板。

2. 階段一:安裝「AI 引擎」— Ollama (防呆圖文版)

要讓 AI 在本地跑起來,目前社群中最受推崇的就是 Ollama。它將複雜的環境配置簡化,就像裝一個普通軟體一樣簡單。

步驟 1:下載並拖入應用程式

請打開瀏覽器前往 Ollama 官方網站,點擊首頁大大的 "Download" 按鈕,選擇 macOS 版本下載。你會得到一個 Ollama-darwin.zip 的壓縮檔。解壓縮後,你會看到一隻可愛的羊駝圖示。⚠️ 新手常犯錯誤: 請不要直接在下載資料夾點擊它!請務必先將這隻小羊駝拖拉到你的「應用程式 (Applications)」資料夾中,再從應用程式裡打開它。

步驟 2:授權並啟動

點擊兩下打開 Ollama,Mac 會跳出安全提示詢問「是否打開從網路下載的程式」,請放心點擊「打開」。接著,Ollama 的安裝視窗會跳出來,提示需要安裝命令列工具 (Command Line tool),請點擊 "Install" 並輸入你的 Mac 開機密碼授權。安裝完成後,請抬頭看你 Mac 螢幕最上方的選單列(電池、Wi-Fi 圖示那邊),如果出現了一個小羊駝圖示,恭喜你,AI 引擎已經成功在背景啟動了!

3. 階段二:下載專屬的「AI 大腦」模型

引擎啟動後,我們要來下載裝載知識的模型了。這裡我們會需要用到 Mac 內建的「終端機 (Terminal)」。別害怕,我們只需要複製貼上兩行字而已!

如何打開終端機?

按下鍵盤上的 Cmd (⌘) + 空白鍵,這會叫出 Mac 的 Spotlight 搜尋列。在裡面打上 Terminal終端機,然後按下 Enter 鍵。這時會跳出一個黑底或白底的視窗,這就是終端機了。

下載對話大腦 (負責聊天與解惑)

我們推薦使用 Meta 最新的強大開源模型 Llama 3.1。請在終端機的游標處,複製並貼上以下這行指令,然後按 Enter:

ollama run llama3.1

這時畫面會出現進度條,開始下載大約 4.7 GB 的檔案,這會花一點時間,請耐心等候。下載完成後,終端機的游標會變成 >>>,這表示你已經進入對話模式了!你可以打個 "你好" 測試一下,看它會不會回你。測試完後,輸入 /bye 並按 Enter 即可退出。

下載補全小腦 (負責在你寫程式時自動補完)

對話模型太大,不適合用來做「即時打字補全」。因此我們要下載另一個非常輕巧、反應極快的模型,專門負責預測你下一步要打的程式碼。請在終端機貼上這行指令並按 Enter:

ollama pull qwen2.5-coder:1.5b

這個模型大約只有 1 GB,下載速度會快很多。看到 success 字樣就代表完成了!你可以直接點擊終端機左上角的紅燈關閉視窗。

4. 階段三:安裝「AI 介面」— VS Code 與 Continue

現在我們要來到寫程式的主戰場:VS Code。如果你還沒有安裝,請先前往 VS Code 官網下載並安裝。

步驟 1:安裝 Continue 擴充功能

打開 VS Code,看看左邊有一整排圖示(活動列)。點擊長得像四個方塊的「延伸模組 (Extensions)」圖示。在上方出現的搜尋框中輸入 Continue。找到開發者標示為 Continue 的官方套件(圖示通常是一個藍色箭頭或 C 字樣),點擊 "Install (安裝)"。

步驟 2:初次設定對話面板

安裝好之後,左邊那排圖示會多出一個 Continue 的專屬圖示,點擊它展開面板。如果是第一次打開,它會跳出歡迎畫面,問你要選擇哪個 AI 提供者 (Provider)。
1. 請毫不猶豫地選擇 Ollama
2. 接著它會問你要使用什麼模型,如果選單裡有看到你剛才下載的 Llama 3.1,直接點選它即可。沒有的話也可以略過,晚點再選。
3. 面板順利打開後,看最下方的對話輸入框,輸入框的上方會有一個下拉選單,這就是讓你切換「目前講話對象」的地方。請確認這裡選的是 Llama 3.1
現在,你可以在對話框輸入:「請幫我用 HTML 寫一個有紅色按鈕的網頁」,看看它是不是飛快地把程式碼吐出來給你!

5. 階段四:啟動「自動補全」的 Tab 鍵魔法 (含避坑指南)

這是整篇教學中最關鍵、也是新手最容易卡關的一步。我們要設定讓輕量級的 qwen2.5-coder:1.5b 默默在背後幫我們自動補全程式碼。

精準修改設定檔

1. 在 VS Code 左側的 Continue 面板中,目光移到最右下角,找到一個小小的「齒輪圖示 (Settings)」並點擊它。
2. 這會自動幫你打開一個名叫 config.json 的設定檔。這個檔案掌管了 Continue 的所有行為。
3. 在這堆程式碼中,往下尋找有沒有一段叫做 "tabAutocompleteModel" 的區塊。如果沒有,我們要自己加上去。

⚠️ 新手避坑警告: JSON 檔案的格式非常嚴格,大括號 {} 必須成雙成對,而且兩個不同的設定區塊之間,一定要用逗號 , 隔開!

請找到最外層大括號的最後一行(通常在檔案底部),在上一行的結尾補上一個逗號 ,,然後換行貼上這段程式碼:

"tabAutocompleteModel": { "title": "Qwen2.5-Coder 1.5B", "provider": "ollama", "model": "qwen2.5-coder:1.5b" }

貼完之後,請按下鍵盤 Cmd + S 存檔。如果沒有出現紅色的報錯底線,代表你成功了!

享受魔法時刻

現在,隨便打開一個空白的 .js.py 檔案。打上一行註解,例如:// function to calculate fibonacci (計算費氏數列的函式) 然後按下 Enter 換行。停頓大約 1 到 2 秒鐘,你會看到螢幕上神奇地浮現出灰色的預覽程式碼!此時,只要帥氣地按下鍵盤上的 Tab 鍵,整段程式碼就會自動填寫進去。這就是自動補全的魅力!

6. 階段五:Continue 必學的神級快捷鍵與指令

除了無腦按 Tab 鍵之外,真正的高手都會活用以下三招,讓 AI 成為你最貼心的代碼編輯器:

💡 Cmd + L (選取並提問)

遇到不懂的程式碼?用滑鼠把它反白,按下 Cmd + L。這段扣會馬上飛到左邊的對話框,你可以直接問 AI:「這段在幹嘛?」或是「幫我找出這段程式碼為什麼會報錯」。

✏️ Cmd + I (行內編輯)

這是最好用的一招!反白程式碼後按 Cmd + I,游標處會彈出一個小視窗。你可以輸入指令:「幫這個函式加上詳細註解」或「把這個元件重構成 React Hooks」。AI 會直接在原地幫你改寫,按下 Cmd + Enter 就能接受變更。

🪄 萬用指令:@ 與 /

在左側的對話框打字時,輸入 @Files 可以讓 AI 讀取你指定的檔案內容。輸入 /edit 可以讓 AI 直接幫你修改特定檔案,輸入 /explain 則是標準的解釋代碼模式。靈活運用這些指令,AI 就能掌握你的專案全貌。

7. 終極 Q&A:容量滿了?電腦變燙?疑難排解區

Q:我覺得自動補全有時候會卡卡的,反應不到半秒鐘?
A:這跟你的 Mac 記憶體 (RAM) 有關。如果你是 8GB 記憶體的機型,當你同時開著 Llama 3.1 和 Qwen 兩個模型時可能會稍微吃力。建議在不需要深度對話時,在對話框輸入 /clear 清除上下文,讓記憶體專心服務補全小腦即可。

Q:不用的時候,Ollama 會一直吃我的效能嗎?
A:不用擔心,Ollama 非常聰明,模型只有在你「呼叫它」的時候才會載入記憶體。如果你大約 5 分鐘沒有理它,它會自動從記憶體中卸載(你可以打開「活動監視器」觀察)。想徹底關閉它,只需點擊右上角選單列的羊駝圖示,選擇 Quit Ollama

Q:我下載太多模型了,硬碟快塞爆了怎麼辦?
A:清理模型超級簡單!再次打開終端機,如果你想刪除 Llama 3.1,只需輸入 ollama rm llama3.1 並按 Enter,幾秒鐘就能把空間釋放出來。輸入 ollama list 則可以查看你目前擁有哪些模型。

⚠️ 免責聲明:本教學提供之軟體安裝與終端機指令操作僅供參考,實際執行情況可能因個人電腦環境、作業系統版本(如 macOS 更新)及軟體更新而有所不同。進行任何系統設定檔修改前,建議先複製備份。AI 產出之程式碼仍須經開發者自行邏輯驗證,本教學不對任何因操作導致之資料遺失、專案錯誤或系統異常負責。
創作者介紹
創作者 小黃老師嘿技術 的頭像
小黃老師

小黃老師嘿技術

小黃老師 發表在 痞客邦 留言(0) 人氣( 105 )