Setup Claude

更新時間：2026/07/17 11:54:39

安裝 Claude Code CLI 並還原 OAuth 憑證的 Gitea Composite Action。此 action 以 composite（複合）型態封裝「啟動橫幅 → 安裝 CLI → 解碼寫入 OAuth 憑證」三個步驟，供其他 workflow 以 uses 引用；啟動時會輸出 action 名稱／用途／更新時間，方便在 CI 日誌辨識。

---

目錄

• 專案列表
• 功能列表
• 使用範例

---

專案列表

專案描述

專案名稱	專案描述
setup-claude	安裝 Claude Code CLI，並將 base64 編碼的 OAuth 憑證解碼寫入 ~/.claude/.credentials.json 的 Gitea Composite Action。

參考專案

專案名稱	參考專案列表
setup-claude	無

NuGet 套件

專案名稱	NuGet 套件列表
setup-claude	無

---

功能列表

本專案為 Gitea Composite Action，未包含可列入 README 的公開程式方法（public method、public constructor、public extension method、public operator）。以下改以 action 的對外契約與步驟說明呈現，實際呼叫方式請見「使用範例」。

輸入參數（inputs）

參數	必填	預設值	說明
oauth	是	無	base64 編碼的 OAuth 憑證字串；解碼後寫入 ~/.claude/.credentials.json。建議由呼叫端以 secret 傳入。

執行步驟（runs.steps）

步驟	說明
顯示 action 資訊	啟動橫幅；輸出 action 名稱、用途與更新時間。
安裝 Claude Code CLI	以 npm install -g @anthropic-ai/claude-code 全域安裝 Claude Code CLI。
寫入 OAuth 憑證	單行完成：建立 ~/.claude 目錄 → 將 oauth（base64）解碼寫入 .credentials.json → chmod 600；全程不輸出憑證內容。

---

使用範例

在其他 workflow 中引用本 action，並以 secret 傳入 base64 OAuth 憑證：

jobs:
  demo:
    runs-on: ubuntu
    steps:
    - name: 取得原始碼
      uses: actions/checkout@${{ vars.ACTION_CHECKOUT_VERSION }}
    - name: 執行 Setup Claude
      uses: https://gitea.jsc.idv.tw/composite-actions/setup-claude@master
      with:
        oauth: ${{ secrets.CLAUDE_OAUTH_B64 }}
    - name: 使用 Claude CLI
      shell: bash
      run: claude --version

oauth 需為 OAuth 憑證檔內容經 base64 編碼後的字串（例如 base64 -w0 ~/.claude/.credentials.json），action 會解碼還原至 ~/.claude/.credentials.json。

執行時 CI 日誌會先出現啟動橫幅：

================================================
Action  : Setup Claude
用途    : 安裝 Claude Code CLI 並還原 OAuth 憑證
更新時間: 2026/07/17 11:54:39
================================================