【2026 最新】Claude Code 連 Samsung 電視怎麼做？Tizen 配對、Glass Home 安裝與復原五步教學

想跟著影片做一次 Claude Code 連 Samsung 電視，把滿版推薦換成照片與常用 App？先別急著貼「幫我換首頁」。你要交給 AI 的，是一段有裝置授權、簽署與驗收的部署工作；每一關成功的意思都不同。

這篇寫給第一次接觸電視開發的讀者，用五步帶你看懂 Tizen 配對、Glass Home 安裝與復原。終端機範例以 macOS 為主；先認識指令要碰什麼，再執行。本文核對截至 2026 年 10 月 28 日的 Samsung 文件與專案版本，並開啟桌面預覽；電視端步驟依官方文件與作者紀錄整理，未在 AlphaLab 的電視上驗證。

先說結論：連上、裝好、按 Home，是三件事

Claude Code 協助部署＝電腦上的助手＋Tizen 工具＋電視授權＋逐項驗收。把它想成裝修：Claude Code 幫你看圖與施工，SDK 是工具箱，憑證是施工證；能進門，還不等於你已改好每個開關。

Glass Home 是一個可自行安裝的 Tizen 首頁風格 App。其目前文件明說：依這個專案的預設安裝流程，Home 鍵仍會開啟 Smart Hub。把 Glass Home 放到常用列、嘗試恢復最後使用 App，與改寫 Home 鍵，是不同方案。本篇只走可逐項記錄、可移除 App 的流程，不採用其他專案重寫未公開設定的做法。先讀專案的適用範圍。

第一步：Claude Code 連 Samsung 電視，先認清兩個 IP

「我的電視年份對了，為何畫面不同？」先記下完整型號、目前軟體版本與原有啟動畫面，再查該型號手冊。Samsung 型號群組表可作為平台對照入口，但年份不等於升級後的現況。作者的安裝紀錄是 2023 Q70C、Tizen 8；這是一台具體裝置的紀錄，不能擴成所有 2023 電視的版本。

先準備自己的電視、遙控器、同一個可信任家用網路的電腦、Samsung 帳號，以及已能使用的 Claude Code。SDK 是開發工具組；請從 Samsung 安裝指引準備 Tizen Studio、對應的 TV Extension、Samsung Certificate Extension，並確認 Web CLI 工具已安裝。帳號登入由你在官方視窗完成，憑證密碼與私鑰留在本機。

開啟電視的 Smart Hub → Apps → App Settings，用遙控器或數字面板輸入 12345，將 Developer mode 設為 On。Host PC IP 填電腦 IP，確認後重新啟動電視。這是 Samsung 的 TV Device 連線流程；不同介面先找 Apps 的設定頁，別把它當成工程／維修選單密碼。

另一個地址是電視 IP，供電腦連過去。像寄包裹：電視先記住准許哪台電腦，電腦再填收件地址。Mac 可在系統設定的網路資訊找目前使用介面的 IP；不要把未使用的網卡地址填進 Host PC IP。先讓 Claude 只看設定與工具是否存在：

請先唯讀檢查這個專案的 README、docs/INSTALL.md、scripts/ 與 app/config.xml。
列出電腦 IP、電視 IP、SDK 路徑與憑證 profile 需要填在哪裡。
不要掃描其他裝置、執行安裝、修改電視設定或顯示憑證密碼。
把每一步的成功輸出與復原方法先列給我。

Claude Code 官方說明確認它能讀檔、改程式與執行工具；裝置上的變動仍來自獲准執行的命令。用 權限設定中的 Plan 模式先閱讀，再逐項核准需要的命令，比一次開放所有操作容易核對。提示詞交代工作範圍，實際工具放行仍要在 /permissions 檢查。

第二步：建立「作者＋這台電視」的簽署憑證

「連上網路，為何還不能裝？」連線像走到門口，簽署才是在套件上蓋章。作者憑證辨認誰製作 App；發行憑證包含測試裝置的 DUID（裝置識別碼）。依 Samsung 憑證建立流程，在 Tools → Certificate Manager 按新增，選 Samsung → TV，為 profile 命名，例如 GlassHome。

• 建立或匯入作者憑證，完成 Samsung 帳號登入，將備份存到本機安全位置。
• 新增發行憑證，選專案所需的 Public 權限，加入目前這台電視的 DUID；可從連線裝置清單選取。
• 保存 profile，核對它的名字；更新同一 App 時沿用原作者憑證，並保留 author.p12 與密碼的安全備份。

這條圖形介面路線，與作者的命令列產證路線擇一即可。若在 Apple Silicon Mac 選作者那套 CLI，請完整跟 固定版本安裝文件的 SDK、Rosetta 與 Samsung 產證工具步驟，不要把兩條流程的憑證位置混在一起。此處不讓 Claude 代你輸入帳號密碼。

在 Tizen Studio 的 Tools → Device Manager 新增電視地址並開啟 Connection；對已連線的裝置選 Permit to install applications。再用 tizen security-profiles list 確認 CLI 看得見剛才的 profile。若清單不同，先核對 tizen cli-config -l 的 profiles 路徑，依 Samsung CLI 設定說明指向 Certificate Manager 實際使用的 profiles.xml，再進下一步。

第三步：Claude Code 連 Samsung 電視，固定版本再安裝

「每次重做，程式都不一樣？」先固定教學核對的版本。以下只下載程式與建立設定副本；需已備妥 Git。把專案放進獨立資料夾，不放進存有私人文件的工作目錄。

git clone https://github.com/victaphu/glass-home-samsung-tv.git glass-home
cd glass-home
git checkout c36636f3d5a0c6b479c3f017f7488c1251b5150c
cp scripts/tizen-env.example.sh scripts/tizen-env.sh

用編輯器打開 scripts/tizen-env.sh：將 TV_IP 改成電視地址，PROFILE 改成剛建立的名稱，TIZEN_HOME 改成實際 SDK 路徑。使用圖形介面建立憑證時，SKILLS 是作者另一條產證路線的設定；build／install 腳本的核心仍使用 tizen 與已存在的 profile。請 Claude 對照腳本說明每個變數，不要直接執行整份網路安裝指令。

. scripts/tizen-env.sh
sdb connect "$TV"
sdb devices
sdb -s "$TV" shell 0 getduid
tizen security-profiles list

sdb 是 Tizen 的裝置連線工具。這份專案把 TV 組成「電視 IP 加 :26101」；核對清單中的連線裝置與讀出的 DUID，確認它就是憑證列入的電視。連上之前先排 IP、Developer Mode 與重啟；連上之後安裝失敗，再查憑證。不要套用 Android 的 APK／ADB 安裝教學。

想先看看畫面，可用專案的本機預覽。作者開發腳本使用 Node.js 22；若尚未備妥這個環境，可先略過預覽、閱讀下圖，再接電視端步驟。這條命令以專案預設埠在本機提供預覽，--no-fetch 關閉服務的外部擷取，並不代表已驗證電視功能：

node dev/run.js --no-fetch

瀏覽器開啟 http://127.0.0.1:18091/index.html?preview=1，方向鍵與 Enter 可檢查焦點移動；完成後在終端機按 Ctrl+C。預覽使用模擬的 App 清單，像飛行模擬器，適合看排版，實機 App 啟動仍要另外驗收。

接著請 Claude 在 app/js/config.js 先只保留你確定已安裝的 App；天氣維持關閉，照片先用內附範例。不要同時調整 DNS、廣告偏好或其他系統設定。看過 build 腳本與 install 腳本，確認目標地址、profile 與輸出路徑後，逐行執行：

scripts/build.sh
scripts/install.sh

第一行建立並簽署 dist/GlassHome.wgt；第二行連線、執行安裝許可、安裝套件並啟動 App。這是這個固定版本的腳本行為；Built 只代表產出套件，還要看電視是否真的出現畫面。若 SDK 回報不認得 install-permit，先依第二步用 Device Manager 完成安裝許可，再依 Samsung CLI 文件逐項 install／run，別讓 Claude 改成提升系統權限。

第四步：把啟動、重開機與 Home 鍵分開驗收

「畫面出現就能交差？」請在紙上記三列：手動啟動、重新開機、按 Home，各寫預期與觀察。先用方向鍵挑一個已安裝 App，按 OK 看是否進去，再回到原生首頁，選 Glass Home 確認可重新開啟。App 沒打開時，才查 config 的 ids 與名稱比對，不要先改系統首頁設定。

將 Glass Home 加入常用列只是方便找回。作者在自己的電視關閉 Start with Smart Hub Home、開啟 Autorun Last App，並從 Glass Home 關機來測試恢復最後 App。Samsung 2025 機型說明把 Start Screen Option 放在 All Settings → Advanced Features；關閉 Smart Hub 自動啟動後，文件描述的是回到最後使用來源，不是替任意 App 保證自動啟動。

你的機型若找不到 Autorun Last App，就把結果記為「此路線僅手動啟動」，保留常用列入口。若有這項設定，拍下原值後再試；改完先正常關機開機，再以該機型手冊的重新啟動方式測一次。Home 鍵依目前 Glass Home 文件仍開 Smart Hub；看到它不代表簽署失敗，也不應據此去寫入未公開的服務設定。

第五步：復原不是重置整台電視

「想回去時，要從哪裡拆？」把復原當成安裝的最後一關。先保存自己上傳照片的原始檔與想保留的捷徑；依本篇最小設定，先前沒有更動 DNS 或廣告設定，就無須多做一輪系統調整。

• 依安裝前照片，還原 Start with Smart Hub Home 與 Autorun Last App 的原值。
• 在 Apps → App Settings → Glass Home → Delete 移除測試 App。熟悉 CLI 者也可在仍連線時，先核對 app/config.xml 的應用程式 ID，再執行下列命令。
• 在 Device Manager 關閉 Connection／移除這次測試連線項目，再把電視的 Developer mode 設為 Off，確認並重新啟動。
• 重新開機，確認原有來源、Smart Hub 與常用 App 都可正常操作；逐項勾掉原先記錄。

. scripts/tizen-env.sh
tizen uninstall -s "$TV" -p GlassHome1.GlassHome

Samsung TV CLI 的 run／uninstall -p 使用應用程式 ID；這裡是固定版本的 GlassHome1.GlassHome，不是套件檔名。若你改過 app/config.xml，先改成自己那份 ID。不要為了刪一個測試 App 直接執行 Smart Hub 重置或恢復原廠。

照片清理也有一個細節：專案資料儲存說明列出正常的 App 私有資料夾，以及寫入失敗時的備援位置 /home/owner/share/GlassHome1；後者會在移除 App 後保留。要清理個人照片時，先在 App 的「＋」面板核對目前使用哪個位置，再依專案流程處理；不要讓助手對不明路徑做遞迴刪除。

三個常見坑：把權限、網路與功能分開查

連不進去：先核對兩個 IP、電腦是否換網卡／網路、是否完成電視重啟，以及訪客網路的裝置隔離。保持家用區網測試，勿為了讓連線成功把開發埠轉發到網際網路。這是裝置連線問題，與要選哪個 Claude 模型分屬兩層。

簽署不過：先看 Samsung TV profile、DUID 與目前 CLI 的 profile 路徑。保留完整錯誤碼，但分享紀錄前遮住憑證路徑中的姓名、DUID、密碼與私鑰內容。先前的 Claude Code 原生 App 開發教學也能補上「產出程式」與「裝置接受程式」的差別。

照片網址可以用，卻不是安全公開網站：Glass Home 安全文件明示照片服務使用區網 HTTP；同網路上可攔截流量的人可能看到傳輸中的密碼與照片。先用不敏感照片，只在可信任網路操作；若不需要照片服務，可依 config 文件停用 photoService，同時移除 manifest 中對應的 service 宣告與 feature。這會改變「＋」、捷徑與自有照片功能，需重新建置驗收。

截至本文核對日，Samsung 也已公布 Tizen MCP Server與 Tizen agent skills，涵蓋環境、建置與部署。因此不用把這次示範理解成「官方完全沒有 AI 開發工具」；新手先學會每一步的目標與輸出，再決定要不要增加自動化。

常見問題：八個先講答案的判讀

1. Claude Code 會直接住進電視嗎？

本篇不是這種配置。Claude Code 在電腦協助閱讀與執行工具，電視安裝的是 Glass Home。這個分工像設計師留在工作室、成品送到客廳。

2. Android TV 的 ADB 指令可以原樣貼上嗎？

不要。這篇走 Samsung Tizen 的 SDB、簽署憑證與 WGT 套件；先辨識作業系統，再選工具。

3. Home 鍵一定會回 Glass Home 嗎？

依目前這個專案的預設流程，不會；作者明示仍開 Smart Hub。開機恢復最後 App 是另外一個驗收項目。

4. 作者列出支援年份，就代表我的電視一定成功？

不代表。專案清單是個別使用者回報；型號、韌體與 web service 能力仍要核對。先保留手動啟動與復原入口。

5. 要買新模型方案嗎？

先用你已可使用的 Claude Code。這裡的瓶頸是工具、憑證與裝置授權；本文沒有要求某個模型型號或宣稱固定 token 成本。

6. 桌面預覽正常，就證明電視部署成功？

不能這樣判斷。預覽用模擬 App 清單；它驗排版與焦點，電視驗簽署、真正 App 啟動與電源行為。

7. Developer Mode 可以一直開著嗎？

完成測試後，本篇流程是關閉並重新啟動；需要更新再依流程開啟。重新開機後另測已安裝 App，別把開發連線狀態當成安裝結果。

8. 刪除 App，照片就一定完全清掉嗎？

不一定。專案另有移除後保留的備援資料位置，先核對「＋」面板與原始照片備份，再完成個人資料清理。

給新手的三個重點

• 把助手、SDK、電視與憑證想成不同角色，錯誤才找得到負責的那一層。
• 把手動啟動、開機恢復與 Home 鍵各寫一個預期，逐項記錄結果。
• 先拍原設定、先留復原入口，再改任何與啟動有關的選項。