Claude Code

Claude Code 是 Anthropic 官方的 AI 程式設計代理 CLI。它能理解您的程式碼庫、生成和編輯程式碼、執行命令，並協助完成複雜的開發任務——全部透過命令列完成。

此模板將 Claude Code 部署為 Zeabur 上的持久化開發者工作站，並提供瀏覽器可存取的 Web 終端機（ttyd）。

開始使用

1. 部署模板並等待服務啟動。首次啟動會自動安裝 Claude Code，請等待健康檢查變為綠色後再繼續。
2. 在瀏覽器中開啟服務網址（綁定到服務的網域）。
3. 登入 — 輸入 Zeabur 儀表板 Instructions 頁籤中的密碼。
4. 複製指令（例如 claude --dangerously-skip-permissions 可取得完整權限），然後點擊 Enter Terminal。
5. 認證 Claude Code — 貼上指令，依照提示登入您的 Claude Pro/Max/Team/Enterprise 訂閱帳號。

使用 API 金鑰（選用）

如果您偏好使用 API 金鑰而非訂閱認證：

1. 將 ANTHROPIC_API_KEY 設定為您的 Anthropic API 金鑰，可從 console.anthropic.com 取得。
2. 可選擇設定 ANTHROPIC_BASE_URL 以使用 Zeabur AI Hub（例如 https://ai.hub.zeabur.com）。

常用命令

命令	說明
claude	啟動互動式 Claude Code 工作階段
claude -p "提示"	執行單次提示
claude login	驗證 Anthropic 帳號
claude --version	檢查已安裝版本
claude config	檢視或修改設定

持久化儲存

/home/node 目錄掛載為持久化磁碟。所有儲存在 /home/node 下的專案、Claude Code 設定和工作階段資料，在服務重啟和重新部署後都會保留。

建議工作流程：

• 將程式碼庫複製到 /home/node/projects/
• Claude Code 設定儲存在 /home/node/.claude/

環境變數

變數	必填	說明
ANTHROPIC_API_KEY	否	Anthropic API 金鑰或 Zeabur AI Hub Token（僅在不使用訂閱登入時需要）
ANTHROPIC_BASE_URL	否	自訂 API 端點（使用 Zeabur AI Hub 時設定）
WEB_TERMINAL_PASSWORD	自動	Web 終端機登入密碼（自動產生，可在儀表板查看）

建議資源配置（官方要求）

• 最低配置：1 vCPU / 4 GB RAM
• 建議配置：2 vCPU / 4 GB RAM

Claude Code 官方系統要求為 4 GB 以上記憶體。AI 運算在 Anthropic API 端進行，本機僅運行 Node.js CLI 和 shell 工具，CPU 需求較低。

變更紀錄

2026-03-31 — 首次發佈

• ttyd Web 終端機（密碼驗證）
• Claude Code 原生安裝器（首次啟動自動安裝）
• Homebrew 及 npm 全域套件持久化於磁碟
• 資源需求及網域綁定

連結

• Claude Code 官方文件
• Anthropic Console
• Zeabur AI Hub