快速摘要： Claude Fable 5.1 適合評估用於困難的除錯、倉庫層級的重構，以及跨多檔案與多工具呼叫的實作。在 Claude Code 中，請明確選取模型、驗證目前活躍模型與連線，並選擇適合任務的努力等級。本指南涵蓋原生使用、可選的 CometAPI 路由、持久化設定，以及務實的檢視–實作–測試–審查工作流程。目標是可運行、可審查的變更，而非僅僅更長的模型回應。
重點摘要
- 進行選擇與驗證：當你的帳戶或供應商可用該模型時，使用 /model or --model，然後在開始大量工作前執行
/status檢查。 - 能力配任務：將此模型用於困難、需要多步推理的任務，在延遲與成本值得的情況下使用；基準分數不保證適用於你的倉庫。
- 有意識地調整努力：對高強度的程式工作以 high 起手，例行任務比較 medium，僅在自家評估證實必要時才用 xhigh 或 max。
- 保護工作流程：避免將 API 金鑰放入共享專案設定，驗證連線，事先約定範圍，執行相關測試，並審查最終 diff。
什麼是 Claude Fable 5.1？
Claude Fable 5.1 是 2026 年 9 月發佈、繼任 Claude Fable 5 的版本。Anthropic 將其定位於高要求推理與長期代理式工作。它支援 100 萬 Token 的上下文視窗、最多 128K 輸出 Token，支援文字與影像輸入，具備常時自適應思考，以及從 low 到 max 的五個 Effort 等級。
工作負載的形態比名目更重要。Fable 5.1 針對的，是可能跨越多檔案、命令、測試、反覆修訂與恢復步驟的任務。Anthropic 仍建議大多數工作先從 Opus 5 開始，當高努力等級的 Opus 評估仍不足時再切換至 Fable 5.1。
| 官方規格 | Claude Fable 5.1 |
|---|---|
| 開發者 | Anthropic |
| 模型 ID | claude-fable-5-1 |
| 發佈日期 | September 1, 2026 |
| 上下文窗 | 1M tokens |
| 最大輸出 | 128K tokens |
| 輸入/輸出 | Text and images → text |
| 思考模式 | Adaptive, always on |
| 預設 Effort | high |
| Effort 等級 | low, medium, high, xhigh, max |
| 知識截止 | June 2026 |
| 官方輸入價格 | $10 / MTok |
| 官方輸出價格 | $50 / MTok |
| Cache 讀取 | $0.25 / MTok |
| 相對延遲 | Slower |
為何 Claude Fable 5.1 與 Claude Code 相關
Claude Code 是一個代理式編碼環境：它可以檢視倉庫、編輯檔案、執行命令與測試，而不僅僅是產生孤立片段。因此，代理式編碼與業務工作流程的基準，比一般問答分數更具相關性。
哪些任務值得使用它？將 Claude Fable 5.1 用於跨模組重構、不明確根因的重現性失敗，或需要協調 API、持久層與測試的功能開發。把這視為務實的決策規則，而非基於基準的保證：一般工作從 Claude Opus 5 開始，當高努力等級的評估仍不足時再升級。對於極小改動或快速、低成本迭代，考慮 Claude Sonnet 5。依你在自家倉庫的驗證完成品質與總成本來判斷選擇。
| 精選官方基準 | Fable 5.1 | Fable 5 | Opus 5 | GPT-5.6 Sol |
|---|---|---|---|---|
| Terminal-Bench 4.0 | 55.8% | 42.0% | 52.3% | 37.3% |
| AutomationBench | 31.4% | 17.1% | 26.9% | 19.6% |
| CursorBench 3.2.0 | 73.4% | 70.5% | 70.0% | 67.2% |
Anthropic 報告了 Terminal-Bench 4.0 的 55.8%、AutomationBench 的 31.4%、以及 CursorBench 3.2.0 的 73.4%。這些結果支持 Fable 5.1 在終端驅動與多步驟編碼工作流程中的定位，但並不保證它在每個代碼庫或每個 Effort 等級都最佳。
在 Claude Code 使用 Claude Fable 5.1 前你需要什麼？
在 Claude Code 設定 Claude Fable 5.1 前，完成以下三項預檢：
- Claude Code 版本：使用 Claude Code v2.1.255 或更高。執行
claude --version，在處理模型選擇問題前先更新客戶端。 - 帳戶或 API 存取：確認你的 Claude 方案、Anthropic API 帳戶，或相容的閘道憑證有效。
- 模型可用性：在新增持久化設定前，確認
claude-fable-5-1已為你的帳戶、組織或供應商啟用。
claude --version
npm install -g @anthropic-ai/claude-code@latest
你也需要透過你的 Claude 方案，或 API/閘道設定進行存取。Anthropic 列出該模型在支援的開發者平台上為啟用狀態。
讓設定持久化且不洩漏 API 金鑰
Shell 匯出只適用於當前終端。Claude Code 亦支援在使用者層級與專案在地設定中的 env 區塊。Windows 的使用者層級路徑為 %USERPROFILE%\.claude\settings.json；macOS 與 Linux 為 ~/.claude/settings.json。
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.cometapi.com",
"ANTHROPIC_MODEL": "claude-fable-5-1"
}
}
將祕密保存在提交之外的設定中。Anthropic 明確警告不要將憑證放入共享專案設定檔。透過本機 Shell、作業系統憑證流程或祕密管理器提供 COMETAPI_KEY 或 ANTHROPIC_AUTH_TOKEN。
方法一：在 Claude Code 直接使用 Claude Fable 5.1
步驟 1：從倉庫根目錄啟動 Claude Code
cd /path/to/your/project
claude
從倉庫根目錄啟動可自一開始就提供預期的專案上下文。
步驟 2：使用 /model 選取 Fable 5.1
/model
從挑選器中選擇 Claude Fable 5.1。Claude Code 支援透過會話內指令、啟動旗標、環境變數或設定進行模型選擇。官方文件確認 /model 與 --model 會覆蓋 ANTHROPIC_MODEL。
步驟 3：直接以 Fable 5.1 啟動
claude --model claude-fable-5-1
當你已知該會話需要 Fable 5.1，且不希望啟動後再切換時，使用啟動旗標。
步驟 4：驗證活躍模型
/status
在存在多層設定時，驗證尤為重要。Status 標籤會顯示活躍模型、基底 URL 與憑證來源，有助於偵測意外的使用者設定、專案設定、環境變數或閘道路由。
方法二：如何將 Claude Code 連線到 CometAPI？
Claude Code 可連線至提供相容 API 格式的閘道。Anthropic 的文件解釋如何設定閘道 URL 與憑證，並提醒第三方閘道不受 Anthropic 擔保或維護。請驗證你工作流程所依賴的每個 Claude Code 功能。
CometAPI 將 Claude Fable 5.1 列為上線，並在 /v1/messages 提供與 Anthropic 相容的 Messages 端點。由於 Claude Code 會將 ANTHROPIC_AUTH_TOKEN 映射到 Authorization Bearer 標頭，請在正式使用前於線上模型頁確認最新的驗證格式。
macOS、Linux 或 WSL
export COMETAPI_KEY="YOUR_COMETAPI_KEY"
export ANTHROPIC_BASE_URL="https://api.cometapi.com"
export ANTHROPIC_AUTH_TOKEN="$COMETAPI_KEY"
export ANTHROPIC_MODEL="claude-fable-5-1"
claude
Windows PowerShell
$env:COMETAPI_KEY = "YOUR_COMETAPI_KEY"
$env:ANTHROPIC_BASE_URL = "https://api.cometapi.com"
$env:ANTHROPIC_AUTH_TOKEN = $env:COMETAPI_KEY
$env:ANTHROPIC_MODEL = "claude-fable-5-1"
claude
啟動後，執行 /status。 Anthropic base URL 與憑證行應顯示閘道路由與活躍的權杖。然後在開始長任務前先送出小型測試提示。
閘道可能落後於新出現的 Claude Code 欄位或端點。若透過 CometAPI 某功能行為不同，請在直接連線 Anthropic 重複相同流程後，再將差異歸因於模型。
為編碼選擇哪個 Effort 等級？
Fable 5.1 使用自適應思考，支援 low、medium、high、xhigh 與 max。Anthropic 建議以預設的 high 作為起點，並用你自己的評估集測試其他等級。Effort 是平衡智能、延遲與成本的主要控制項。
| Effort | 適合的 Claude Code 用例 | 取捨 |
|---|---|---|
| low | 極小編輯、快速解釋、簡單的局部變更 | 最低推理成本；可能較少使用搜尋 |
| medium | 例行實作、直觀修復、常規程式碼審查 | 品質與成本的良好平衡 |
| high | 嚴肅的多檔工作、除錯、含測試的實作 | 建議起點 |
| xhigh | 困難重構、艱難除錯、對架構敏感的工作 | 更多推理與延遲 |
| max | 能力敏感、異常困難且長期的任務 | 最高的時間與 Token 使用 |
在 medium Effort 下，Anthropic 指出 Fable 5.1 可大致比肩 Fable 5 並降低成本。在 low Effort 下，它可能較少呼叫搜尋與檢索工具，因此對依賴現有程式碼或文件的任務而言，low 並非自動的最佳選擇。
實用的 Fable 5.1 Claude Code 工作流程
設定只是工作的一半。當任務在檢視、範圍確認、實作、驗證與審查上有明確分工時，Fable 5.1 表現最佳。
步驟 1：從倉庫分析開始
Analyze this repository before editing anything.
Goal: add a new /api/v1/reports endpoint that returns a paginated report list.
First:
1. Find the current API routing pattern.
2. Identify the service and persistence layers involved.
3. Find existing pagination conventions.
4. Identify the relevant tests.
5. Propose the smallest implementation plan.
Do not modify files until you have summarized the plan.
這個第一步能在錯誤假設擴散到多檔案之前將其暴露出來。
步驟 2：確認範圍，然後實作
Implement the approved plan.
Constraints:
- Change only files required for this feature.
- Follow existing project conventions.
- Prefer targeted edits over whole-file rewrites.
- Do not refactor unrelated code.
- Add or update only the tests needed for this feature.
- Report unrelated defects instead of fixing them automatically.
這樣的措辭遵循 Anthropic 的建議，偏好針對性編輯，並將工作維持在請求的範圍內。
步驟 3：執行相關測試
Run the relevant unit and integration tests after implementation.
If a test fails:
1. Identify the root cause.
2. Explain whether this change caused the failure.
3. Fix only failures caused by this change.
4. Rerun the smallest relevant test set before the broader suite.
這個檢查點是可觀測的：相關測試通過，或 Claude 回報剩餘失敗及其與變更的關係。
步驟 4：在接受工作前審查 diff
Review your final changes as if you were a code reviewer.
Check for:
- behavior outside the requested scope,
- missing edge cases,
- regressions,
- duplicated logic,
- unnecessary file changes,
- tests that do not verify the new behavior.
Then summarize the final diff, tests run, and remaining risks.
這個最後步驟提供了精簡的接受檢查清單，有助於在人類審查前暴露不必要的工作。
建議的 CLAUDE.md（適用於 Claude Fable 5.1）
一份精簡的倉庫層級指示檔可以提升跨會話一致性。僅包含 Claude 否則需要重新發現的規則與命令。
# Repository Instructions
- Inspect the existing implementation before editing.
- Keep changes within the requested scope.
- Prefer surgical edits over whole-file rewrites.
- Follow existing project conventions.
- Run relevant tests after implementation.
- Fix root causes rather than patching symptoms.
- Report unrelated issues instead of changing them automatically.
- Summarize files changed, tests run, and remaining risks.
對大型單一倉庫（monorepo），補充套件管理器、測試與 Lint 命令、架構邊界、生成檔規則，以及不應手動編輯的目錄。
何時應使用 Claude Fable 5.1 而非 Opus 5？
務實的問題不在於 Claude Fable 5.1 是否更新，而在於你的任務是否需要超過 Opus 5 可可靠提供的持續推理。Anthropic 建議大多數工作從 Opus 5 開始；在 Claude Code 中，將 Fable 5.1 視為面對最艱難、長期工作的升級選項。
| 決策因子 | Claude Fable 5.1 | Claude Opus 5 |
|---|---|---|
| 任務範圍 | 倉庫層級遷移、跨模組重構、模糊的調查 | 功能、修復、審查、與受控的重構 |
| 推理跨度 | 長時間的自主會話，反覆使用工具、測試、修訂與恢復 | 較短、範圍清晰的編碼會話 |
| 品質 vs 速度 | 當最困難任務的驗證完成品質最重要時使用 | 預設更好的品質、延遲與成本平衡 |
| 升級觸發 | 高 Effort 的 Opus 仍失手、在多步驟中失去連貫性，或無法可靠完成流程 | 大多數 Claude Code 工作的首選 |
| 延遲與成本 | 僅在它能實質改變驗證結果時值得溢價 | 更適合例行或互動性工作 |
| 最佳適用 | 困難、長期的代理式編碼 | 預設用於複雜的專業編碼 |
實務升級規則
以 Opus 5 並設定 high Effort 起手。當以下任一情況成立時，切換至 Fable 5.1：
- 範圍：任務跨越多個相互依賴的檔案或服務，並需要反覆使用工具、測試、修訂與恢復。
- 可靠性：在 high Effort 下，Opus 5 仍漏掉相依、在步驟間失去連貫，或無法可靠完成工作流程。
- 失敗成本：未完成或錯誤變更的成本，高於 Fable 5.1 所需額外延遲與 API 花費。
僅當 Fable 5.1 在同一倉庫任務上能實質改善驗證完成度時才使用；否則切回 Opus 5。
在實務上，Fable 5.1 更適合倉庫級遷移、跨模組除錯、多服務功能開發，以及需要反覆檢視、執行、測試與恢復的困難根因分析。對於孤立修復、例行功能、程式碼審查與文件，Opus 5 仍是更好的預設。
疑難排解
/model 中沒有 Claude Fable 5.1
更新 Claude Code、重啟終端與會話，並確認帳戶或組織已有存取權。然後檢查是否有受管設定限制了模型選擇。
Claude Code 使用了錯誤的模型
執行 /status 並檢查每一層設定。官方文件指出 --model 與 /model 會覆蓋 ANTHROPIC_MODEL。同時檢查使用者、專案與專案在地設定。
CometAPI 回傳 401 或驗證錯誤
驗證 API 金鑰、基底 URL 與憑證變數。Claude Code 會將 ANTHROPIC_AUTH_TOKEN 透過 Authorization: Bearer 傳送，而 ANTHROPIC_API_KEY 對應 x-api-key。使用 CometAPI 端點目前接受的格式。
會話過慢或過貴
不要對每個任務都使用 max Effort。對具代表性的評估集比較 medium 與 high，量測總任務成本與完成品質，並將 xhigh 或 max 保留給額外推理能改變結果的情況。
Fable 5.1 改動超出所需
在提示或 CLAUDE.md 中加入以下範圍限制：
Prefer targeted edits over whole-file rewrites unless a rewrite is required for correctness.
Anthropic 特別記錄了此行為，並建議對小變更採用針對性編輯。
常見問題
Claude Fable 5.1 能在 Claude Code 中運行嗎？
可以。當你的帳戶或供應商可用該模型時，使用模型挑選器，或以 --model claude-fable-5-1 啟動 Claude Code。
Claude Fable 5.1 的模型 ID 是什麼？
官方 Claude API 模型 ID 為 claude-fable-5-1。
如何在會話中切換模型？
執行 /model，選擇 Claude Fable 5.1，並使用 /status 確認活躍模型與路由。
我應該使用哪個 Effort 等級？
嚴肅的程式工作以 high 起手。例行任務測試 medium；僅當自身評估顯示明顯品質提升時才使用 xhigh 或 max。
我可以在 Claude Code 中使用 CometAPI 嗎？
Claude Code 支援相容閘道，CometAPI 為 Fable 5.1 提供與 Anthropic 相容的 Messages 端點。請驗證驗證格式，以及你依賴的每一個 Claude Code 功能。
Fable 5.1 一定比 Opus 5 更好嗎？
不一定。Anthropic 建議大多數工作使用 Opus 5，而在高要求推理、長期代理式工作，或高 Effort 的 Opus 仍不足時，使用 Fable 5.1。
為何使用 Fable 5.1 而不是 Sonnet 5？
當長期推理與自主完成比速度與價格更重要時，使用 Fable 5.1。對快速、例行的編碼循環，Sonnet 5 通常更經濟。
結論
當任務超越一般編輯——如倉庫層級功能、困難調查、多檔案遷移，或必須在長期跨度中持續規劃、執行、測試與恢復的自主會話——Claude Fable 5.1 在 Claude Code 中最具吸引力。
最快的原生路徑是使用 /model 或 claude --model claude-fable-5-1。若你偏好統一的 API 層，CometAPI 提供 Claude Fable 5.1 並以與 Anthropic 相容的 Messages 端點提供服務。無論選擇何種路徑，將 Effort 等級、範圍控制、測試與最終 diff 審查視為模型設定的一部分。