Claude Code 的開源應用程式

Claude Code 是 Happier 能在自家終端機介面之內、而非在它前面執行的代理程式。開啟整合終端機執行環境後，Happier 會在共用的終端機宿主裡啟動真正的 claude TUI，把該工作階段串流到你的裝置，並把你從應用程式送出的訊息直接鍵入其中——因此修正可以落在已經在執行的回合中，而不必等它結束。接受修正的是 Anthropic 自己的終端機，Happier 只是替你按著鍵盤；這與隔著執行器談論某個工作階段是不同的安排，也正是本頁存在的理由。

預設的執行環境是 Agent SDK 那一套，對多數工作階段而言它也是對的那一套。它能接續對話、列出那台電腦上的 Claude Code 工作階段、把廠商狀態帶到第二台電腦；當用量上限擋住你時，它可以去問這個上限是不是真的解除了，而不是留你自己猜。它不做的是把訊息帶進已經在執行的回合：Anthropic 把 Agent SDK 的串流輸入記載為依序處理的排隊訊息，並可中斷。在兩種執行環境之間選擇，改變的只有這一項行為，你的程式碼放在哪裡則完全不變。

登入依然走 Anthropic 的流程，只是可以從你人在的任何地方發起。Claude Code 的供應商頁面會在你挑選的電腦上執行 claude 並送出 /login，所以瀏覽器那個步驟發生在將要保存憑證的那台電腦上，而不是你手上的手機。Happier 會先到 Anthropic 安裝程式放置執行檔的地方找它——~/.local/bin、~/.local/share/claude 底下的版本目錄、Homebrew 前綴、~/.claude/local/cli.js——才提議顯示安裝指令給你，因為在多數電腦上它早就在那裡了。

Claude Code 是 Anthropic 的終端機程式設計代理程式：你在儲存庫裡執行 claude，它會讀檔、改檔並執行指令。Happier 不改變這些。happier claude 啟動相同的執行檔、在相同的目錄、用相同的登入，並把對話鏡射到每台你已登入的裝置。

它替你換來的是「可以走開」。在座位上啟動重構，午餐路上用手機看差異，回答它停下來等的權限要求，回到座位時再從終端機把工作階段接回來。儲存庫還留在它原本就在的那台電腦上。

引導和中斷不是同樣的動作，而 Claude Unified 談的是前一種。中斷會停掉目前的回合並另起新的；引導則是往正在執行的回合裡追加。Anthropic 把 Agent SDK 的串流輸入記載為依序處理的排隊訊息，並可選擇中斷——那是這裡的預設執行環境，對多數工作階段來說也是對的那一種。Claude Code 自己的終端機吃的是另外那種：在它工作時打字，指示就會併入進行中的工作。Unified 驅動的就是那個終端機，所以應用程式可以從手機上做到。

不管走哪條路，都只有一個 Claude Code 行程。在整合模式下，終端機和應用程式同時都是活的——你可以在電腦上的 TUI 裡打字，同時工作階段從手機被回覆，兩邊都不會被鎖在外面。這就是這裡所謂的「整合」：一個行程、一份對話紀錄、二個可以往裡面打字的地方。

iOS 和 Android 應用程式、macOS、Windows 和 Linux 的桌面應用程式，以及 app.happier.dev，全都是連向你電腦上執行中的 Claude Code 行程的用戶端 — 不是唯讀的鏡像。回應權限請求、送出下一則指示、瀏覽儲存庫、閱讀差異。對話紀錄在離開你的電腦前就已端對端加密，所以承載它的伺服器持有的是密文。

Happier 安裝在已經放著你儲存庫的那台電腦上，而 happier claude 會在那裡以一般子行程的方式啟動 Claude Code，在你指定的目錄裡，並以你當初登入的方式登入。代理程式和 Anthropic 之間沒有閘道，你的原始碼在其他任何地方也沒有副本。

Happier 會在你的 PATH 上尋找 claude，並執行你安裝的那一份。Anthropic 是用安裝指令碼而不是套件來散布它；Happier 可以把那個指令顯示給你，但它不會自行執行供應商的安裝指令碼 — 除非你明確允許，否則供應商的安裝方案會被拒絕。

Anthropic 自己的安裝與登入指南在 code.claude.com/docs/en/setup。Happier 不會鏡像一份，因為把別人的安裝說明抄一份過來，抄的就是一份會過期的東西。

Happier 這一側的設定參考 — Happier 文件中的 Claude Code。

Claude Code 是 Happier 可以指向「你連結過一次的憑證」的代理程式之一，而不是指向那台電腦當下登入的帳號。它接受 a Claude subscription or an Anthropic API key。

已連結服務是以憑證為鍵，而不是以代理程式為鍵，所以同一份 Claude subscription 在每一台你連結過的電腦上，都能給任何接受它的代理程式選用 — 這也正是把你自己的帳號組成一個池、跨多台電腦使用會有幫助的原因。憑證的加密與解密都在你自己的裝置上進行；文件頁面 記載各種設定檔的規則，因為每個代理程式接受哪些種類的設定檔，正是會隨版本變動的那類細節。

Claude Code 是 Happier 執行的 13 個命令列程式設計代理程式之一，它們共用同一份工作階段清單、同一個權限收件匣、同一套鍵盤快速鍵和同一份 MCP 設定。

You define an MCP server once and Claude Code receives it as native MCP inventory, next to whatever MCP servers it already had of its own.

這在你同時跑不只一個的日子最重要：不同供應商的工作階段並排在一起，而點一下通知會開啟提出該請求的工作階段，而不是應用程式的大門。完整清單在這裡。

在終端機輸入 happier claude 就會在你所在的地方啟動工作階段，而同一個工作階段同時也在應用程式裡。你在那個 shell 裡讀到的是 Happier 自己對該工作階段的顯示 — 對話紀錄、權限提示、工具輸出 — 而不是 Claude Code 的介面。沒有人得放棄終端機才能得到一個手機用戶端。

當你想用 Claude Code 自己的 TUI 時，在擁有該工作階段的電腦上執行 happier attach <session-id>，就會在 tmux 裡把它交給你，而且歷史紀錄已經在那裡了。在預設執行環境下這種交接是獨占的：只要終端機握著工作階段，你從應用程式送出的訊息會排在佇列裡等，而不是在你眼皮底下被打進去；等你把控制權交回來，它才會送出去。 統一終端機執行環境是另一種安排 — 共用終端機主機裡只有一個 Claude Code 行程，終端機和應用程式可以同時寫入。

attach 指南列出了各種情況，而不是承諾全部都行。

在放著你程式碼的電腦上執行一道指令，然後在你想工作的儲存庫裡執行 happier claude。

逐步說明在指南裡。全部都採 MIT 授權，而中繼站是你可以自己執行的。