Alook 教學：讓團隊直接找你的 Claude Code、Codex，代理仍在自己的電腦執行
Alook 讓同事直接找到你的本機代理。以手冊差異練習任務交付，確認來源、負責人、離線狀態與共享範圍。
Alook 是讓人與 AI 代理共用房間的協作工具。你原本使用的代理留在自己的電腦執行，同事可以在房間裡直接交給它工作。
一個團隊可能只有某位同事整理過程式或文件，每次大家需要查資料，都要先找他，再由他把問題轉給代理，最後把結果貼回群組。
Alook 開發者在臺灣時間 2026 年 10 月 8 日透過 X 介紹產品，希望把這段轉述縮短。代理有固定身份、收件匣與房間資格，方便其他人找到它。
官方文件支援 Claude Code、Codex、Cursor、OpenCode 和 Pi。這些代理原本就各有自己的執行方式，Alook 負責提供可以接觸它們的協作入口。
平台不提供自己的模型，也不替你把模型部署成可使用的服務。對團隊來說，這表示「大家能找到代理」和「代理在哪裡做事」，是需要一起安排的兩個問題。
我的判斷是，第一次共享代理，先拿來查一份大家都有權看的文件。確認任務、結果與負責人都清楚，再考慮讓它處理更多工作。
Alook 讓代理有固定身份，減少工作轉述
代理取得可以被稱呼的身份後，同事不用每次找擁有者轉傳需求。房間裡的人可以直接說明問題，也能在同一個地方看到交付結果。
固定身份可以理解成團隊知道要找誰做這類工作。它讓對話有可追蹤的對象，不代表代理本來的資料與工具權限自動改變。
例如你有一個熟悉專案文件的 Codex，同事想確認新版操作手冊改了什麼。Alook 可以提供共同討論的房間，工作仍由這個本機代理執行。
平台提供連線，模型與機器仍由你安排
官方把 Alook 描述為連線既有代理的工具，明確說不提供自己的模型。你本來使用哪個代理、接哪個模型，還需要依原有設定管理。
所以團隊使用成本不能只看房間是否能加入。模型使用、機器運作和維護時間，仍可能是你原本代理工作的一部分。
官方程式以 Apache 2.0 授權開源，代表可依這份授權使用程式。它不等於所有連線的模型服務都免費，也不替其他產品改變訂閱條件。
「留在本機」需要怎麼理解？
官方說代理繼續在自己的機器執行，這說明它的運作位置。代理如果原本連線雲端模型，傳給模型的資料仍要依那個服務理解。
因此別把本機代理解讀成完全沒有網路傳輸。要知道哪些資料會離開機器，必須一起看代理、模型與 Alook 的實際連線設定。
對初次嘗試的團隊，選擇不含個資的共享文件，會更容易確認流程。等看到完整結果後，再決定是否需要加入其他內容。
Alook 官方快速開始：先連線一個已可工作的代理
依 2026 年 10 月 10 日查詢的官方 GitHub 文件，可在電腦終端機執行下方命令。終端機是用文字指令操作程式的視窗。
npx @alook/app onboard
這是官方快速開始命令，用來引導連線機器、偵測可用的代理執行環境，並啟動本機 Alook。執行前，先核對套件名稱與官方來源。
文件接著提供本機瀏覽器入口 http://localhost:15210。localhost 表示目前這臺電腦，所以同事不能把這個網址貼到自己的手機，就連上你的機器。
先確認代理本身能完成一個小工作
連線前，先用原本方式讓代理讀一份測試文件，回報它看到了什麼。這能確認文件位置和執行環境，不把原有問題混入協作工具測試。
如果代理原本就無法讀取文件，先修正路徑或權限。換到共同房間不會自動讓它取得資料，也不會替你補齊缺少的工具。
連線成功後，再用同一個小任務測試房間交付。前後使用相同文件和需求，才容易看出問題發生在代理還是任務傳遞。
讓房間名稱和代理名稱對應工作用途
例如房間叫「操作手冊檢查」，代理叫「文件比對助理」。名稱不必很華麗，重點是同事知道可以交哪些工作，以及結果要交到哪裡。
代理若有多個房間資格，也不要只用「幫忙看看」當指令。要附文件位置、版本與交付對象，避免把另一個房間的上下文套進來。
你可以在房間說明放一個簡短範例。這是團隊自訂的協作方法，不是本文宣稱 Alook 已內建的權限模板或管理功能。
文件差異範例：同事直接提出問題，擁有者不再轉貼
下面是假設的教學練習：營運同事準備新版課程操作手冊，需要知道登入與報名流程改了什麼。代理可以讀取舊版和新版的測試文件。
這次工作只整理差異，不改動文件。兩份內容放在可讀取的專案目錄，並用版本名稱區分，讓每個人都知道比較的對象。
第一步：把輸入與輸出一次說清楚
可在房間提出：「比較操作手冊舊版與新版，只列登入和報名流程的差異。每項附兩版原文位置、差異影響與需要營運確認的問題。」
這個要求比「看看新版有沒有問題」更容易完成。代理知道比較範圍，也知道結果應包含證據，而不是自己替營運作出產品決定。
如果文件位置不明確，就先讓代理回報缺少哪份資料。請求者補齊後再繼續，不必讓擁有者憑記憶在多個資料夾之間幫忙找。
第二步：先區分文字差異和行為差異
例如新版把「登入後報名」改成「填寫報名資料後登入」。這是文件文字的變動，但它是否對應網站真實流程，仍需要另一份證據。
代理可以先說「兩份文件對順序的描述不同」，並列出位置。不要只因新版說法較完整，就判斷它一定是目前的正確版本。
如果營運同事有已確認的產品說明，再把它補進任務。新的資料要明確指出來源，避免房間對話中的假設變成文件事實。
第三步：讓有權決定的人接手未決問題
假設代理找出報名截止時間不同，交付給課程負責人確認。這時代理已完成差異研究，接下來需要的是人對產品事實作決定。
你可以把結果分成「可以確認的差異」與「需要負責人回答的問題」。這種分工能讓每位成員知道自己要處理哪一段工作。
| 交付內容 | 假設例子 | 下一個負責人 |
|---|---|---|
| 可對回原文的差異 | 登入與填寫順序不同 | 文件維護者 |
| 需要產品確認的事實 | 報名截止時間不同 | 課程負責人 |
| 尚缺的資料 | 新版附錄沒有提供 | 任務提出者 |
| 完成後的修改提案 | 依確認內容修正手冊 | 有編輯權的人 |
這張表是建議的交接格式，Alook 提供房間，團隊則要安排決定者。代理能被直接找到，不代表它可以替任何成員改完所有文件。
代理共享後，如何避免任務彼此干擾？
最常見的疑問是同時有人交工作時，代理在做哪一件。你可以要求每個任務有清楚標題，交付時重述輸入版本與完成範圍。
例如「手冊登入差異」和「課程價格整理」分別使用不同資料。結果附上任務名稱，就比較不容易被貼回錯誤的對話。
接到新的要求，先確認是不是同一件工作
同事在比較途中說「順便直接修新版」，這已經改變原本只讀的任務。代理應先說明將修改哪一份文件，讓有權編輯的人決定。
這個做法是團隊工作安排，不是推測產品自動攔截所有高影響操作。原本代理可以使用的工具，仍要依實際設定限制。
若兩位同事給出不同的產品事實，先把衝突列出來。讓負責人指定採用哪份來源，比讓代理自行選較晚出現的一句話可靠。
電腦離線時，先查執行位置和當前狀態
官方說代理留在自己的機器，因此需要考慮電腦是否開啟、代理程式是否運作。房間可見，不一定代表本機工作正在執行。
遇到沒有回應的情況，可以先檢查本機代理與連線狀態，再看任務是否已有交付。不要連續重送完整指令，造成恢復後重複處理。
本文不替官方文件沒有說清楚的情況，保證離線任務會永久排隊或自動恢復。這些行為要在自己的配置中實際確認。
用可讀取的範圍管理共享資料
代理身份穩定，不代表每個房間成員都應取得整臺電腦的內容。先把測試資料放在明確目錄，並讓任務只指向這個範圍。
例如操作手冊測試不需要讀取客戶名單。若同事突然要求找其他資料，先確認那份資料是否適合分享，以及代理本來有什麼存取權。
團隊也應知道誰維護這臺機器。工具更新、代理登入或文件移動後，負責人能說明狀態，房間工作才不會只依賴一個永遠沒人管的程式。
怎麼驗收「同事不用再找你轉述」？
先用一個低影響任務，觀察提出者是否能直接說清楚需求，代理是否取得正確資料，結果是否讓負責人可以往下做決定。
如果每次仍需要擁有者補大量背景，問題可能是房間說明和任務格式不足。先補這些脈絡，比立即更換模型更容易改善交接。
看證據與接手，不只看代理有沒有回話
文件差異結果至少要附原文位置，讓同事能核對。只有「發現三處差異」而沒有內容，仍然需要人重新找一次，轉述成本沒有真正降低。
交付也要說明誰接手。例如課程負責人確認截止時間，文件維護者再修改。這能避免大家看過訊息，卻以為其他人已經處理。
如果代理找不到資料，也可以算一個可用結果，前提是清楚指出缺哪份文件。團隊因此知道下一步，而不是只得到一段空泛的建議。
延伸閱讀：【Vibe Coding】Claude Code 新功能 Subagents 教學：打造專屬 AI 助理，讓開發流程自動化再升級
房間先有一份任務說明，共享代理才容易維持
代理接入後，第一次示範可以由維護者完成，第二次改由同事獨立提出同樣類型的要求。這能看出入口是否真的容易使用，而不是只有設定者懂。
例如維護者先示範比較登入流程，同事再比較報名流程。兩次都用清楚版本和範圍，觀察是否仍需要擁有者額外補充背景。
如果同事不知道怎麼提問，就在房間留下短範例。讓它包含資料位置、工作目標和交付格式，其他人更容易依此寫出自己的任務。
把機器維護和結果確認交給不同角色
機器維護者負責確認代理能運作，文件負責人則決定內容是否正確。兩個角色可能是同一人，也可以由不同同事分工。
例如代理能讀文件卻比錯版本，結果確認者指出來源問題；如果完全沒有回應，機器維護者再查執行狀態。分工能縮短找問題的時間。
這些安排應讓團隊知道，而不只是寫在維護者自己的筆記。共享入口的目的，就是讓其他人遇到問題時，也能找到下一個接手者。
先建立穩定節奏，再增加任務種類
文件比對穩定後，可以加入格式檢查或摘要。每種新工作先做一次小案例，確認輸出和完成條件，再讓更多房間成員使用。
如果要開始修改文件，就另訂可修改範圍和審閱方式。查詢工作做得好，是增加信心的證據，但不是所有更高影響動作都已驗收。
代理逐步成為可接手的工作對象，關鍵在清楚任務和可查結果。名字固定與房間方便是入口，團隊仍要把後面的交付流程做完整。
Alook 常見問題 FAQ
Alook 會替我提供 Claude 或其他模型嗎？
官方文件說平台連線你既有的代理，不提供自己的模型，也不替你把模型部署成可使用的服務。模型方案、登入與使用成本，仍要依你原本的工具安排。
哪些代理可以接入？
2026 年 10 月 10 日查詢的官方文件列出 Claude Code、Codex、Cursor、OpenCode 與 Pi。實際設定請依各執行環境和官方文件確認。
開源代表團隊的所有工作都免費嗎？
Apache 2.0 是 Alook 程式的授權。代理使用的模型、服務與機器仍可能有成本，不能把開源程式和其他產品費用混在一起。
同事可以直接修改我的文件嗎？
能執行什麼，取決於代理本來的工具權限與任務。第一次測試建議只讀文件並整理差異，之後再明確安排修改範圍和負責人。
我的代理名稱固定，還需要寫文件位置嗎？
需要。固定身份讓人知道找誰，文件位置與版本則讓代理知道這次要處理什麼。兩者一起明確，結果才容易核對與交接。
結語：先把一份文件的交接做順
Alook 讓共享代理多了一個直接入口。它是否真的減少來回轉述，要看任務能否說清楚、資料能否對上，以及交付後是否有人接手。
先選兩份測試手冊，讓同事在房間提出差異要求。確認結果有原文位置和負責人，再把同樣方法用到更多可共享的工作。
延伸閱讀：Codex 教學：非工程師也能用的 AI 桌面助理，10 個實戰應用
