AI API key 到底是什麼？完整 Gemini + Claude 申請指南

你是因為想用 Angel 的某個工具被導過來的嗎？ 如果是，恭喜你——再 5 分鐘你就可以開始用了。這篇會一步一步帶你走完。

沒時間讀全文？3 個 takeaway：

1. API key 不是代碼，是你的身分證。 就像家裡的 Wi-Fi 密碼，你拿去給 AI 工具用，工具才知道「啊，是你要用」。只是它背後接的不是 Wi-Fi，是 Gemini 或 Claude。

2. 選 Gemini 還是 Claude？先 Gemini。 免費、不用信用卡、2 分鐘搞定，輸出對大部分人夠用。覺得不夠好再換 Claude。

3. 不想讀全文沒關係。 文章最後有一段 prompt，整段複製給任何 AI chat（Claude.ai、Gemini、ChatGPT 都可以），它會問你幾個問題然後一步步帶你做。

🧭 第一次用？依你的情境照這個順序做

常見卡關的原因不是步驟太多，是不知道哪個先做。這張表讓你一眼看清楚。

路線 A — 最快上手（5 分鐘）：只想試試看，直接在工具裡打字

1. 申請 Gemini API key（下面第 03 段）
2. 打開工具，Onboarding 選「Here in the app / 直接在這邊打」
3. 右上角 ⚙ API keys → 貼 Gemini key → 儲存
4. 填表 → 生成 → 複製去 Slack / Email

不用碰 Notion、不用儲值、不用信用卡。

路線 B — 完整流程（15 分鐘）：想從 Notion 拉筆記、生成後存回 Notion

1. 申請 Gemini API key（第 03 段）
2. 複製 Angel 的 Notion 週報模板 到你的 workspace
3. 建 Notion integration 拿 token（下面第 05 段）— 這步很多人漏掉
4. 把 integration 邀請到 你剛複製的那個資料庫 — 這步也很多人漏掉
5. 打開工具，Onboarding 選「In Notion / 寫在 Notion」
6. 右上角 ⚙ API keys → 貼 Gemini key + Notion token → 儲存
7. 貼 DB 網址 → Load weeks → 點 row → 生成 → Save to Notion

路線 C — 品質優先（10 分鐘）：對寫作品質要求高

先 申請 Claude API key（第 04 段，要綁信用卡 + 儲值 $5 美金），其他步驟照路線 A 或 B。

我先承認——我第一次看到「API key」這四個字的時候，我也以為需要很會寫程式才能用。

但其實不用。API key 只是一串讓 AI 知道「是你在用」的密碼。 你不需要會寫任何一行程式，就能申請、複製、貼到工具裡，然後它就跑起來了。

這篇會幫你從零開始，申請 Gemini 或 Claude 的 API key。兩個都寫了，你可以只讀要用的那一個。

01｜先搞懂：API key 到底是什麼？

把 AI 想成一間會寫字、算數、會畫圖的雲端超能力工廠。

這間工廠不是免費對公眾開放的——你要用它，必須有一張「廠門識別證」。這張識別證就是 API key。

對使用者來說，你只需要知道三件事：

1. API key 是一串隨機字元，看起來像 AIzaSyB... 或 sk-ant-...
2. 有了它，工具就能代替你去「敲工廠的門」，讓 AI 幫你做事
3. 工廠會按你用了多少來算錢——Gemini 有免費額度、Claude 一開始要儲 $5 美金

為什麼需要 BYOK（Bring Your Own Key，自備金鑰）？

有些工具（像 Angel 的週報工具）選擇讓你用自己的 key，而不是幫你代收費。好處：

• 完全免費 — 工具不賺你的錢，只是中轉 AI 的能力
• 控制權在你 — 你想停用、換 key、rotate 都是你說了算
• 隱私 — 你的內容直接走到 AI 廠商，工具不看、不存

壞處：你要自己處理 key。但看完這篇你就會了。

02｜選哪個：Gemini 還是 Claude？

⭐ 我建議你先申請 Gemini。 理由：

• 免費、快、沒風險
• 如果你用了覺得輸出不夠好，再去申請 Claude 也不遲（兩個 key 可以同時存在）
• 週報這類短文本任務，Flash 幾乎看不出差別

如果你已經在用 Claude.ai 做日常對話、很習慣它的寫作風格，那 Claude 直上也合理。

03｜申請 Gemini API key（2 分鐘完成）

Step 1 · 打開 Google AI Studio

前往 aistudio.google.com/app/apikey。

用你平常的 Google 帳號登入——就是你收 Gmail 那個。

Step 2 · 同意條款

第一次進去可能會跳出 Terms of Service 視窗。勾選同意，按確認。

（Gemini 的條款有提到「免費額度下你的資料可能被用來訓練模型」。如果你介意，就別丟機密資訊給它；或改用 Claude。）

Step 3 · 按「Create API key」

右側會有一顆藍色的「＋ Create API key」按鈕，點下去。

它會問你要綁在哪個 Google Cloud project。沒有 project 也沒關係，它會自動幫你建一個。 直接按「Create API key in new project」就好。

Step 4 · 複製 key 並存好

key 產生後會顯示在畫面上，類似：

AIzaSyX············································

這串東西只會顯示這一次。 立刻複製，貼到密碼管理器（1Password、Bitwarden、或你習慣的地方）。

萬一沒存到也沒關係——回到同一個頁面就可以刪掉舊的、重新產一個。

Step 5 · 貼進工具

回到你要用的工具（像 Angel 的週報工具），找到 API key 的輸入框，貼上。

完成。你可以開始用了。

04｜申請 Claude API key（5 分鐘，需要信用卡）

Step 1 · 註冊 Anthropic Console

前往 console.anthropic.com。

用 email 註冊，或如果你已經有 Claude.ai 帳號就直接登入。

Step 2 · 綁定付款方式（必要）

左側選單 → Settings → Billing → Plans。

選「Build」方案（最便宜、按用量算），綁定信用卡，最少儲 $5 美金。

這 $5 不是月費——是一個儲值額度，用完再補。$5 大概夠生成 100 份週報。

Step 3 · 建 API key

左側選單 → API Keys → 右上角「Create Key」。

取一個名稱（例如 angel-weekly-recap），按確認。

Step 4 · 複製 key 並存好

key 會產生，類似：

sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

一樣只顯示這一次。 複製，存好。

Step 5 · 貼進工具

打開你要用的工具，找到 API key 輸入框（通常會要你先選 provider 是 Anthropic），貼上。

完成。

05｜設定 Notion integration（只有要讓工具讀/寫你的 Notion 才需要）

如果你只在工具裡手動打字、不想碰 Notion——這段跳過。你已經可以開始用了。

會需要這步的情境：Angel 的週報工具走「Notion flow」（從你 Notion 資料庫拉筆記、生成後寫回去）。

申請 Gemini 或 Claude 的 key 是讓工具能呼叫 AI；建 Notion integration 是讓工具能讀/寫你 Notion 裡的特定資料庫。是兩件獨立的事，都要做。

Step 1 · 建 integration

打開 notion.so/my-integrations → 右上角「＋ New integration」。

設定：

• Type：Internal（內部使用，不是發給別人用的）
• Name：隨便取，例如 angel-recap（只有你自己看得到）
• Associated workspace：選擇含有你目標資料庫的那個 workspace

按「Save」。

Step 2 · 選 Capabilities（權限）

新建的 integration 頁面會有「Capabilities」區塊。至少要勾：

• ✅ Read content（讀你的筆記）
• ✅ Update content（把生成的週報寫回去）

「Insert content」可勾可不勾（目前不會新增 row）。User information 全部不需要。

Step 3 · 複製 token

左側選「Configuration」→ 找到「Internal Integration Secret」→ 按「Show」→ 複製。

長得像 ntn_xxxxxx... 或 secret_xxxxxx...。立刻存到你的密碼管理器，這串東西就是你的 Notion 身分證。

Step 4 · 把 integration 邀請到目標資料庫

這步最多人漏掉。

Integration 建好了，但 Notion 預設不讓它存取任何東西——要你一個一個邀請。

1. 打開你要讓工具讀取的 Notion 頁面（Angel 的週報模板複製過來那頁）
2. 右上角「...」→ Connections → Add connections
3. 搜尋你剛建的 integration 名稱（例如 angel-recap）
4. 點選 → 按「Confirm」

如果你的資料庫在一個母頁面底下，建議邀請到母頁面——整個子樹都會一起授權。

Step 5 · 貼進工具

回到 Angel 的週報工具（或任何有 Notion integration 功能的工具）：

• 右上角 ⚙「API keys」→ 找到「Notion integration token」欄位
• 貼上剛複製的 ntn_... 或 secret_...
• 按「Save」

完成。現在工具可以讀/寫你剛才邀請的資料庫了。

常見卡關

• 「按 Load weeks 沒反應／跳 404」 → 多半是 Step 4 漏掉。回到資料庫頁面確認 Connections 有你的 integration。
• 「貼了 URL 但看不到例子 row」 → 確認你貼的是資料庫的 URL（不是上層 wrapper 頁面）。Notion URL 裡有 32 位英數字那串就是 DB ID。
• 「我把 token 用完一次就刪掉了」 → 隨時回 my-integrations → 對應的 integration → 產新 token。舊的會失效。

06｜不想讀步驟？讓 AI 帶你走完

如果你看到上面那些步驟還是覺得頭大，這裡有一個備案——把下面這段 prompt 整段貼給任何 AI chat（Claude.ai、Gemini 都可以），它會像真人助理一樣問你幾個問題、然後帶你做。

你是我的 AI API key 設定助手。我要幫一個 AI 工具設定 API key，但我是完全的初學者——沒寫過程式、沒用過 API、看到 token 就頭痛。

請帶我一步一步走完整套流程。

── 我需要你先幫我決定 ──
先問我這三個問題：
1. 你對成本敏感嗎？（免費 vs 每週花幾毛錢都可以）
2. 急用嗎？（今天要用 vs 慢慢來）
3. 你已經在用 Claude.ai 或 ChatGPT 了嗎？

根據我的回答，推薦：
- Gemini：免費、不用信用卡、2 分鐘搞定
- Anthropic Claude：需要信用卡 + 儲 $5 美金、但寫作品質更好

── 然後帶我做 ──
給我選擇後完整的步驟指南：
- 每個步驟我會看到什麼畫面、要點哪個按鈕
- 提醒我可能會卡住的地方（例如 Gemini 的 Google Cloud project 那關、或 Anthropic 要儲值才能用）
- key 拿到後，帶我貼到工具裡

── 最後 ──
key 生效後提醒我：
- 把 key 存在密碼管理器（1Password、Bitwarden 都可以）
- 不要把 key 貼在公開的地方（GitHub repo、公開 Slack、社群貼文）
- 每 3–6 個月 rotate 一次（刪掉舊的、產新的）是好習慣

請從那三個問題開始。

按「一鍵複製」→ 開你慣用的 AI chat → 貼上 → 跟著它走。

07｜拿到 key 之後，幾個好習慣

1. 存在密碼管理器。 1Password、Bitwarden、iCloud Keychain 都可以。不要存在記事本、email 草稿、截圖裡。

2. 不要 commit 到 Git。 如果你也在學寫程式，不要把 key 貼進 .env 後推上公開 repo——GitHub 會掃描並在幾秒內通知你、關掉 key。

3. 監控用量。 Gemini 在 aistudio.google.com、Claude 在 console.anthropic.com 都可以看使用紀錄。如果看到不是你的 spike，立刻 rotate。

4. 每 3–6 個月 rotate 一次。 刪掉舊 key、產新的、更新所有用到的地方。如果量大、或你之前不小心貼到公開地方過，就馬上 rotate，別等。

5. 一個工具一把 key。 可以的話，針對每個用到的工具產一個獨立 key（例如 angel-weekly-recap、my-blog-writer），出事的時候好追蹤、好 rotate。

你開始了嗎？

API key 是讓你從「用別人做好的 AI 產品」跳到「用 AI 當自己的組件」的第一步。看起來是個技術門檻，其實不是——是信心門檻。 你只是沒做過，不是做不到。

拿到 key 之後，回去你原本要用的工具，貼上，開始。如果中間卡住任何地方，就把「第 5 段」那個 prompt 貼給 AI 問——它會比任何教學文件都有耐心。

歡迎進入自己開鑰匙的世界 :)