LANMA AGENT CLASS · L3 補充教材 補充 1 / 5

SUPPLEMENT 01 · CLAUDIAN × CODEX CLI

先讓員工能進門 Claudian 前置：安裝 Codex CLI

Obsidian 裡的 Claudian 只是一支對講機。對講機那一頭要先有人接， 那個人就是裝在你電腦裡的 Codex CLI。人沒到，喊破喉嚨都不會有回應。

TL;DR

  1. Claudian 只是對話介面，真正讀檔、寫檔、幹活的是你電腦裡的 Codex CLI。
  2. 所以順序不能反：先裝 CLI、登入、確認 codex --version 有回應，再回 Obsidian 裝外掛。
  3. 最省事的裝法不是自己打指令，是交辦給 ChatGPT／Codex App 幫你裝。

// 01

先搞懂：到底誰在幹活

很多人卡在這裡——外掛裝好了、面板也打開了，訊息送出去卻像丟進黑洞。原因幾乎都一樣：對講機那頭沒有人。

Claudian 與 Codex CLI 的分工示意圖 Obsidian 是辦公室，Claudian 是對講機，Codex CLI 是真正做事的員工，你的 Vault 是檔案櫃。檔案留在本機，運算送到雲端。 OpenAI 雲端 運算送雲端 你交辦的話、它讀到的段落會上傳 你的電腦（本機） Obsidian 辦公室 Claudian 對講機 Codex CLI 真正做事的員工 你的 Vault 檔案櫃 檔案留在本機 .md 檔一步都沒離開你的資料夾
對講機（Claudian）只負責傳話；真正翻檔案櫃、動手改檔的，是本機那位員工（Codex CLI）。

三句話講完這張圖

所謂 CLI，白話翻譯就是「在終端機裡打字下指令的程式」——沒有畫面、沒有按鈕，全靠一行一行的文字。你不必愛上它，你只需要讓它存在，然後從 Claudian 對它講話。

「一個視窗，就是一間辦公室。」 Claudian 是對講機、Codex CLI 是員工、Vault 是檔案櫃——辦公室裡的每個角色都要到齊，工作才會開始。
關鍵觀念

Claudian（外掛 id realclaudian，作者 Yishen Tu，版本 2.1.3）官方的定位是：把 Claude Code、Codex 這類 coding agent 嵌進 vault，vault 就是它的工作目錄，能讀寫檔案、搜尋、執行指令、跑多步驟工作流。這也代表——它一定要先在你電腦上找得到那個 agent 本體，才動得起來。

先確認一件事

Claudian 是桌面限定（isDesktopOnly: true）。手機、平板一律不支援，在行動裝置上外掛會是灰的、裝不起來。手機端請把 Obsidian 當「隨身閱讀器」用就好，交辦工作回電腦做。

// 02

兩條安裝路線，選一條就好

這門課的精神是「交辦，不是自己動手」。裝軟體這件事也一樣——你完全可以把它交辦出去。

路線 A · 推薦

交辦給 ChatGPT／Codex App

適合：不想碰終端機、看到黑底白字就手心冒汗的人。也就是絕大多數人。

  • 打開 ChatGPT 桌面 App 或 Codex App
  • 用裡面的 Codex 功能開一個對話
  • 把下面這段話原封不動貼進去，按下送出
  • 它會自己判斷你的作業系統、自己下指令、自己裝好
複製這段交辦句 ↓

幫我在這台電腦安裝 Codex CLI，裝完告訴我 codex 指令的完整路徑。

最後那句「告訴我完整路徑」很重要——待會 Claudian 設定裡要填的就是它。

路線 B · 自己來

自己開終端機用 npm 裝

適合：電腦上已經有 Node.js、或就是想自己按一次的人。

  • 先安裝 Node.js LTS（到 Node.js 官網下載長期支援版，一路下一步）
  • 開終端機（macOS：終端機 Terminal；Windows：命令提示字元 Command Prompt 或 PowerShell）
  • 執行下面那行安裝指令
  • macOS 也可以改用 Homebrew 安裝
終端機 · Terminal
$ npm install -g @openai/codex

# macOS 若習慣用 Homebrew，可改成：
$ brew install --cask codex
為什麼推薦 A

不是因為 B 很難，而是因為路線 A 就是這門課要練的肌肉：把一件你不熟的事情，用一句清楚的話交辦出去，然後驗收結果。你怎麼帶人，就怎麼帶 AI——講清楚、給邊界、驗收。裝 CLI 只是第一次練習。

// 03

五個步驟，從空機到能對話

照順序做，每一步都有明確的「做完長什麼樣」。做不出那個樣子就別往下走，先回頭修。

1

安裝 Codex CLI

為什麼：這是真正會幹活的員工，先讓他到職。

用上一節的路線 A（交辦）或路線 B（自己 npm 裝）擇一完成。裝完先不要急著開 Obsidian。

2

驗證裝好了沒，順便把路徑抄下來

為什麼：「應該裝好了」不算數，看到版本號才算數。

在終端機打第一行，看到版本號就是成功；第二行是把 codex 的完整路徑撈出來，等一下要填進 Claudian。

macOS · 終端機 Terminal
$ codex --version
（有印出版本號 → 成功）

$ which codex
（印出一整串路徑 → 整段抄下來）
Windows · 命令提示字元 Command Prompt
> codex --version
> where codex
（可能印出好幾行，選結尾是 codex.exe 的那一行）

把撈到的路徑貼到便條紙或 0_收件匣 裡的一則筆記，等一下要用。

3

登入：用你原本的 ChatGPT 帳號

為什麼：員工報到要先刷卡，不刷卡進不了系統。

在終端機直接打 codex 執行它，畫面會問你怎麼登入——選 Sign in with ChatGPT。

終端機 · Terminal
$ codex
→ 選 Sign in with ChatGPT
→ 瀏覽器會跳出來，用你平常的 ChatGPT 帳號登入
→ 回到終端機，看到登入成功即可
好消息

選 Sign in with ChatGPT 是吃你原本的 ChatGPT 訂閱額度，不必另外去買 API 金鑰。看到畫面在跟你要一串 sk- 開頭的金鑰，代表你選錯登入方式了，退回去重選。

4

在 Obsidian 裡安裝 Claudian

為什麼：員工到職了，現在幫他裝一支對講機。

路徑（介面語言不同時，找括號裡的英文字）：

  1. 設定（Settings）→ 社群外掛（Community plugins）
  2. 第一次進來會擋住你——需要先關閉安全模式／開啟社群外掛（Turn on community plugins）
  3. 按瀏覽（Browse）→ 搜尋 Claudian
  4. 安裝（Install）→ 啟用（Enable）

安裝到的是 realclaudian 這個外掛，作者 Yishen Tu。

5

在 Claudian 設定裡指定後端與路徑

為什麼：對講機要知道呼叫哪一位員工、他坐在哪個座位。

進 Claudian 的設定，做兩件事：後端選 Codex、把步驟 2 抄下來的完整路徑貼進 CLI 路徑欄位。

Obsidian ─ 設定（Settings）
外觀（Appearance）
檔案與連結（Files and links）
社群外掛（Community plugins）
Claudian
HTML Preview
後端／Agent（Backend）

要呼叫哪一位員工。這裡選 Codex。

Codex ▾
CLI 路徑（Path）

貼上步驟 2 撈到的完整路徑。

/…/bin/codex
工作目錄（Working folder）

預設就是這個 vault，不用動。

目前的 vault

※ 以上是示意面板，不是實際截圖。各版本欄位名稱可能略有差異，你要找的就是這兩樣東西：選 Codex 當後端、填 CLI 路徑。

驗收

回到 Claudian 面板，打一句「請列出這個 vault 根目錄有哪些檔案」。如果它答得出 0_收件匣、AGENTS.md 這些名字，代表對講機、員工、檔案櫃三者接通了——你可以開始上工了。

// 04

Windows 專區：兩個一定會踩的坑

如果你用 Mac，這節可以跳過。用 Windows 的話，這兩件事幾乎每個人都會遇到一次。

坑 1

路徑要指到 codex.exe

不是 codex.cmd。

where codex 常常一次印出好幾行，裡面同時有 .cmd 和 .exe。 Claudian 的 CLI 路徑要填結尾是 codex.exe 的那一行；填到 .cmd 會叫不起來，而且錯誤訊息通常看不出原因。

Command Prompt
> where codex
...\codex.cmd   ← 不要用這行
...\codex.exe   ← 用這行
坑 2

PATH 沒生效，要整個重開

關視窗不等於關程式。

剛裝完 CLI，系統的 PATH（＝作業系統「去哪些資料夾找程式」的清單）還沒更新到已經開著的程式身上。 Obsidian 是啟動的當下才讀 PATH 的，所以：

  • 整個關掉 Obsidian 再重開——不是只按右上角的 ×，要確認它真的結束了
  • 終端機也一樣，關掉舊的、開一個新的再測 codex --version
  • 還是不行就登出重登，或直接重開機（最暴力，也最有效）

// 05

疑難排解：卡住的時候先查這張表

九成的問題都在這七列裡。從上往下對症狀，不要跳著猜。

症狀原因怎麼修
Claudian 面板打得開，訊息送出去卻毫無反應 Codex CLI 根本沒裝，或 Claudian 找不到它 終端機打 codex --version：沒版本號 → 回步驟 1 重裝；有版本號 → 把 which codex（Windows：where codex）的完整路徑貼進 Claudian 設定
終端機回 command not found: codex（Windows：不是內部或外部命令） 裝好了，但 PATH 還沒生效 關掉這個終端機視窗、開一個新的再試。還是不行就登出重登或重開機
Windows 上路徑填了，Claudian 還是叫不起來 填到 codex.cmd 了 改填結尾是 codex.exe 的那一行路徑
路徑改對了，Claudian 卻好像還在用舊設定 Obsidian 只在啟動時讀環境變數 整個關掉 Obsidian 再重開，不是只關視窗
Obsidian 裡搜不到 Claudian 這個外掛 社群外掛還沒開啟（安全模式擋著） 設定（Settings）→ 社群外掛（Community plugins）→ 先開啟社群外掛（Turn on community plugins），再按瀏覽（Browse）搜尋
登入時畫面在跟我要一串 sk- 開頭的 API 金鑰 登入方式選錯了 退回去，選 Sign in with ChatGPT。它吃你原本的 ChatGPT 訂閱額度，不必另外買金鑰
手機／平板上外掛是灰的，裝不起來 Claudian 桌面限定（isDesktopOnly） 沒有解法，這是設計如此。行動裝置只當閱讀器，交辦工作回電腦做

// 06

誠實話：我的檔案到底跑去哪了

這是課程的紅線，講不清楚就不該叫你裝。所以我直接講白。

課程紅線

檔案不搬家，AI 來上門。

  • 檔案留在你的電腦。Vault 就是硬碟上一個普通資料夾，Claudian 不會把它整包上傳、也沒有雲端資料庫在存你的筆記。
  • 但運算是送到雲端的。你交辦的話、以及 Agent 為了完成任務實際讀到的那些段落，會傳到雲端模型去算，再把結果傳回來。
  • 所以結論很簡單：真正機密的東西不要放進 vault。密碼、客戶合約正本、還沒公告的財報、身分證影本——那些留在別的地方。
  • 會議記錄、人物卡、專案筆記這些「工作用腦內容」，是這個第二大腦的主場；真正的機密，另外處理。
「員工可以是別人訓練的，檔案櫃必須是你的。」 Codex 是 OpenAI 訓練的員工，用完就算了；但 0_收件匣、2_領域 裡那一個個 .md 檔，十年後還躺在你的硬碟上。這就是為什麼我們把界線劃在這裡。

// CHEAT SHEET

一頁帶走

卡住的時候不用重看全文，看這張就好。

補充 1 · 小抄卡

Claudian 前置：安裝 Codex CLI

  1. 順序不能反：先裝 Codex CLI、先登入，最後才在 Obsidian 裝 Claudian。
  2. 唯一的驗收指令：codex --version。印得出版本號才算裝好，其他都是感覺。
  3. 路徑要抄下來：macOS which codex、Windows where codex，整段貼進 Claudian 設定的 CLI 路徑。
  4. Windows 兩件事：指到 codex.exe（不是 .cmd）；改完整個重開 Obsidian。
  5. 登入選 Sign in with ChatGPT：用原本的訂閱額度，不必另外買 API 金鑰。
  6. 桌面限定：手機、平板不支援，別在那邊找外掛。
  7. 紅線：檔案不搬家、運算送雲端——真正機密的東西不要放進 vault。