第9章 安全與責任——金鑰、公開、許可證
必讀 想跟著這個階段學下去,一定要讀這一章。一句話總結:密碼、API 金鑰這樣的金鑰(Secret)絕對不要上傳到倉庫。 一旦提交過,即使把檔案刪掉,它也還留在 Git 記錄裡。 萬一洩露了,第一件事不是清除記錄,而是先把這個金鑰換掉(作廢、更換)。
本章依據 2026年11月1日確認的 GitHub、Claude Code 官方文件和 Anthropic 消費者條款寫成。對任何 AI 都適用的安全守則,在第1階段第9章裡。本章講的是公開倉庫和部署帶來的新風險。本章不是法律意見,重要的決定請和專家確認。
不要上傳金鑰
金鑰是讓人能夠訪問敏感系統和資料的憑據,比如外部服務用的 API 金鑰和令牌、資料庫密碼。[1] GitHub 要求,密碼、API 金鑰這樣的敏感資訊絕對不要上傳到倉庫。[2]
為什麼說得這麼重?因為提交過的金鑰會成為 Git 記錄的一部分,即使從最新檔案裡刪掉,記錄裡也還在。[3] 而且公開倉庫裡的金鑰,會被搜尋引擎和專門的收集程式抓走。[4]
常見的洩露途徑有這些。[5]
- 試驗時放進去的值,不小心被提交了
.env這樣的設定檔案- 在文件、README 的示例裡寫了真實的金鑰
理解檢查
你提交了一個金鑰值,在下一次提交裡把那個檔案刪掉了。會怎樣?
三層防護
| 步驟 | 要做的事 | 依據 |
|---|---|---|
| 1. 不放進去 | 寫進 .gitignore,並禁止 Claude 讀取 | 第2章,本節 |
| 2. 被攔住 | GitHub 推送保護在上傳前攔截 | 本節 |
| 3. 換掉 | 一旦洩露,立即作廢、更換 | 本節 |
出處:本指南的整理(依據見各腳註)
1. 不放進去。 要做的事有三件。請從上往下依次做。
- 先寫進
.gitignore:裝有金鑰的檔案,從一開始就寫進.gitignore(Git 要忽略的檔案清單)(第2章)。順序很重要。已經提交過的檔案,只寫進清單是不會被忽略的。 - 讓 Claude 讀不到:在 Claude Code 的許可權規則(規定 Claude 可以做什麼的設定)裡加上
Read拒絕規則。比如寫上Read(./.env),Claude 的檔案工具就讀不到.env。[6] 如果自己寫有困難,可以請 Claude 幫忙:"在許可權規則裡加一條Read(./.env)拒絕規則,讓你讀不到.env。" 許可權在 Claude Code 第4章講過。 - 放在倉庫外面:拒絕規則也不是萬無一失的。它攔不住不點檔名就去讀取的命令,也攔不住其他程式。[7] 所以金鑰檔案最安全的做法是,一開始就放在倉庫資料夾之外。
自動任務(GitHub Actions,第5章)需要金鑰時,也不要寫在倉庫檔案裡。要放進 GitHub 的 Secrets(在倉庫設定裡單獨存放金鑰的地方)。[8][9] 待辦看板用不到金鑰,所以現在只要知道有這麼個地方就行了。
2. 被攔住。 GitHub 的推送保護會在裝有金鑰的推送到達倉庫之前攔住它。[10] 你的帳號預設開著一項保護,會阻止往公開倉庫上傳金鑰。[10:1] 即便如此,它也只是最後一張網。它不保證能抓住所有種類,所以請先做好第1步。
3. 換掉。 收到金鑰洩露的警告時,要立即更換那份憑據。[11] 改寫 Git 記錄,需要和一起用的人協調,也有副作用。官方文件也說,要清除的如果是金鑰,第一步是作廢、更換。[12]
理解檢查
金鑰值洩露到公開倉庫時,官方文件說的第一步是什麼?
公開帶來的事
公開倉庫和 Pages 網站,誰都能看到(第2、7章)。所以公開之前,請檢查這些。
- 個人資訊:不要放進有真實姓名、聯絡方式、地址的筆記。這就是為什麼不能把第3階段整理工具的筆記原樣傳上去。
- 訪客資訊:Pages 出於安全目的會記錄訪客 IP(第7章)。
- 批准責任:建議的程式碼和命令是否安全,批准之前要先審閱,這是使用者的責任。[13]
理解檢查
為什麼不把第 3 階段整理工具的筆記原樣傳到公開倉庫?
許可證與 AI 做出來的成果
如果不確定許可證,就會適用預設的著作權法,別人不能複製、分發、修改使用我的程式碼(第2章)。想讓別人也能用,就要選一個許可證。
關於 AI 做出來的程式碼的權利,本指南沒有找到官方立場。Claude 個人帳號的條款只寫著:公司擁有的權利"如果有的話",會轉讓給使用者。[14] 它沒有回答"AI 做出來的程式碼有沒有著作權"。如果用在重要的地方,請和專家確認。
詳細說明:我們確認過的條款內容(點選展開)
我們確認到的,是適用於 Claude 個人帳號的 Anthropic 消費者條款裡的這一條(Codex、Antigravity 請遵守各自公司的條款)。它說的是:在你遵守條款的前提下,Anthropic 對輸出內容(Outputs)擁有的權利**"如果有的話"**,會轉讓給使用者。[14:1] 這並不是"AI 做出來的程式碼有沒有著作權"的答案。
我的資料會不會被用來訓練,也請確認。官方文件寫道:在 Claude 的 Free、Pro、Max、Ultra 帳號上,如果訓練設定開著,用 Claude Code 做的工作也會被用來訓練新模型。[15] 檢視設定的位置,在第2階段 Claude 指南的第9章裡。如果你在第2階段選的是 ChatGPT 指南,Claude 指南只讀這個第9章「個人資訊與安全」就可以了。
理解檢查
倉庫裡沒有指定許可證,會怎樣?
別人做的零件也要看一看
軟體常常依賴從各處取來的零件(軟體包)。這些零件裡可能在你不知道的時候混進安全漏洞。[16]
像待辦看板這樣幾乎不用零件的頁面,不必太擔心。要記住的只有一點。如果 Claude 提議安裝新零件,請問清楚裝什麼、為什麼裝再批准(和第4章檢查計劃時的問題一樣)。
詳細說明:零件多起來以後(點選展開)
GitHub 的 Dependabot 會在我用的零件有已知漏洞(安全弱點)時發出警告。
理解檢查
Claude 提議安裝新的元件(軟體包)時,這份指南建議怎麼做?
親自動手試試——公開前檢查表
- 看看待辦看板資料夾裡有沒有
.gitignore,裡面有沒有寫上可能裝有金鑰的檔案(.env等)。沒有的話,讓 Claude 幫你建一個。 - 請 Claude:"幫我查一下這個倉庫裡有沒有看起來像密碼、API 金鑰、令牌的字串。找到了只告訴我檔案和行號,不要顯示值。"
- 親自掃一遍 README、SPEC.md、資料裡有沒有真實姓名、聯絡方式。
- 想一想要不要定一個許可證。記住:不定的話,別人就不能用。
- 萬一上傳了金鑰:先到簽發它的地方作廢、更換,然後再整理倉庫。
連續任務:第10章要做的是實踐作業,把第1~9章從頭到尾一次性做一遍。
小結
- 金鑰絕對不上傳。一旦提交,刪掉了也還留在 Git 記錄裡,公開倉庫還會被收集。
- 三層防護:用
.gitignore不放進去(Read 拒絕只攔得住 Claude 的檔案工具),推送保護來攔截,洩露了先更換。 - 公開倉庫和 Pages 裡不放個人資訊。批准之前審閱的責任在使用者。
- 沒有許可證,別人就不能用。AI 輸出內容的權利,沒有找到官方答案。
- 安裝新零件時,問清楚裝什麼、為什麼裝,再批准。
術語解釋
| 術語 | 中文名稱 | 一句話解釋 |
|---|---|---|
| Secret | 金鑰 | 密碼、API 金鑰這樣的憑據 |
| Push protection | 推送保護 | 提前攔住裝有金鑰的推送的 GitHub 功能 |
| Rotate | 輪換(更換) | 把已洩露的金鑰換成新值 |
| Dependency | 依賴 | 我的軟體所依賴的別人的零件 |
這一章讀完了嗎?
學習記錄只儲存在這個瀏覽器中。整體進度可以在 全部目錄中檢視。
下一章:第10章. 實踐作業
參考資料(16 則)
GitHub 官方文件,「Secret leakage risks」。"Secrets are credentials that grant access to sensitive systems and data." / "API keys and tokens used to authenticate with external services" docs.github.com (確認日期 2026-11-01) ↩︎
GitHub 官方文件,「Adding locally hosted code to GitHub」。"Never
git add,commit, orpushsensitive information, for example passwords or API keys, to a remote repository." docs.github.com (確認日期 2026-11-01) ↩︎GitHub 官方文件,「Secret leakage risks」。"These hardcoded secrets become part of your Git history and remain accessible even after being removed from the latest commit." docs.github.com (確認日期 2026-11-01) ↩︎
GitHub 官方文件,「Secret leakage risks」。"Public repositories with exposed secrets are indexed by search engines and specialized scanning services." docs.github.com (確認日期 2026-11-01) ↩︎
GitHub 官方文件,「Secret leakage risks」。"Secrets in configuration files such as
.envfiles or infrastructure-as-code templates" docs.github.com (確認日期 2026-11-01) ↩︎Claude Code 官方文件,「Configure permissions」。"To block Claude's file tools from reading a file or directory, add a
Readdeny rule for its path, such asRead(./.env)orRead(./secrets/**);" code.claude.com (確認日期 2026-11-01) ↩︎Claude Code 官方文件,「Configure permissions」。"They don't apply to a command that reads files without naming them, such as
grep -r pattern .run from the directory that holds the file, or to arbitrary subprocesses that read or write files indirectly, like a Python or Node script that opens files itself." code.claude.com (確認日期 2026-11-01) ↩︎Claude Code 官方文件,「Claude Code GitHub Actions」。"Never commit API keys or OAuth tokens directly to your repository." code.claude.com (確認日期 2026-11-01) ↩︎
GitHub 官方文件,「Secrets」。"GitHub Actions can only read a secret if you explicitly include the secret in a workflow." docs.github.com (確認日期 2026-11-01) ↩︎
GitHub 官方文件,「Push protection」。"Rather than alerting you to credential leaks after the fact, push protection blocks pushes that contain secrets before they reach your repository." / "Stops you from pushing secrets to public repositories on GitHub" docs.github.com (確認日期 2026-11-01) ↩︎
GitHub 官方文件,「Secret scanning」。"When you receive an alert, rotate the affected credential immediately to prevent unauthorized access." docs.github.com (確認日期 2026-11-01) ↩︎
GitHub 官方文件,「Removing sensitive data from a repository」。"It is important to note that if the sensitive data you need to remove is a secret (e.g. password/token/credential), as is often the case, then as a first step you need to revoke and/or rotate that secret." docs.github.com (確認日期 2026-11-01) ↩︎
Claude Code 官方文件,「Security」。"You're responsible for reviewing proposed code and commands for safety before approval." code.claude.com (確認日期 2026-11-01) ↩︎
Anthropic 消費者條款(Consumer Terms of Service)。"Subject to your compliance with our Terms, we assign to you all of our right, title, and interest—if any—in Outputs." anthropic.com (確認日期 2026-11-01) ↩︎
Claude Code 官方文件,「Data usage」。"We will train new models using data from Free, Pro, Max, and Ultra accounts when this setting is on (including when you use Claude Code from these accounts)." code.claude.com (確認日期 2026-11-01) ↩︎
GitHub 官方文件,「Dependabot alerts」。"Software often relies on packages from various sources, creating dependency relationships that can unknowingly introduce security vulnerabilities." docs.github.com (確認日期 2026-11-01) ↩︎