ClawCodex：以生產為導向的 Claude Code Python 重寫版
令牌高效的 Claude 程式碼完整 Python 重建。 270K LoC 纯 Python 中的 AI 编码代理。成本節省高達 200 倍！
秒懂
- 它是什麼？
- 從 TypeScript 參考實作移植的 CLI 代理，支援多提供商和令牌壓縮。 本文聚焦其核心介面、部署邊界、版本訊號與實際核驗方式。
- 適合誰用？
- README 將 ClawCodex 描述為一個功能不斷增加的可用代理執行環境。它報告了具體的基準測試結果，並包含用於控制令牌使用和權限的工具。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 4 天前。
- 用什麼語言寫的？
- 主要是 Python（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
Claude Code 的 Python 重寫版
ClawCodex 是 Claude Code 的 Python 移植版，從 TypeScript 參考實作移植並改寫為道地的 Python。倉庫描述稱其為約 31 萬行程式碼的完整 Python 重寫版，README 將其描述為面向生產環境的可用 CLI 代理，而非原始碼轉儲。該移植保留了原始架構，包括工具呼叫迴圈、串流 REPL、工作階段歷史和多輪執行。與上游的主要差異在於，ClawCodex 旨在支援多種 LLM 提供商，而 Claude Code 僅針對 Claude 模型。README 將此視為相對上游的最大進步。程式碼庫被描述為可讀、可修改，並帶有測試和基於 Markdown 的技能擴充機制。專案正在積極開發中，README 的新聞部分顯示每週都有新功能。
clawcodex 第 1 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 clawcodex、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 agentforce314/clawcodex 第 1 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 agentforce314/clawcodex 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agentforce314-clawcodex-deep-analysis 第 1 節的具體核對點是 Claude Code 的 Python 重寫版。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
安裝與設定
快速安裝為一行指令：`curl -fsSL https://clawcodex.app/install.sh | bash`，該指令會安裝 uv、Python 3.10+ 並將 `clawcodex` 加入 PATH。安裝器還附帶生命週期輔助指令：`doctor`、`verify`、`update` 和 `uninstall`。它可安全重複執行，支援 macOS、Linux 和 WSL。如需從原始碼手動安裝，README 展示了複製倉庫、建立虛擬環境、安裝依賴並執行 `python -m src.cli login` 以在 `~/.clawcodex/config.json` 中寫入設定。設定檔儲存提供商 API 金鑰、基礎 URL、預設模型以及可選的 session、settings 和 env 區塊。README 建議使用 `clawcodex login` 進行互動式設定，該流程會引導選擇提供商、輸入 API 金鑰、可選的基礎 URL 和預設模型，並將所選提供商設為預設。設定檔還支援按提供商的環境變數回退，因此大多數提供商無需編輯設定檔即可使用。
clawcodex 第 2 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 clawcodex、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 agentforce314/clawcodex 第 2 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 agentforce314/clawcodex 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agentforce314-clawcodex-deep-analysis 第 2 節的具體核對點是 安裝與設定。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
令牌成本控制：/eco 與 DeepSeek 前綴快取
`/eco` 開關使用從 RTK 方法集移植的確定性過濾器壓縮每個 Bash 結果的模型繫結渲染。README 報告了一個實測基準：將 27 個真實指令輸出回放到生產管線，令牌數從 92,989 降至 17,767，減少 80%。壓縮被保證不會比原始渲染更差，任何有損壓縮都會將完整輸出儲存到磁碟並附上可執行的復原提示。另外，ClawCodex 保持請求前綴位元組穩定，使 DeepSeek 的提示快取能夠覆蓋整個系統、工具和歷史記錄範圍。README 指出快取命中的輸入按約每百萬令牌 0.0435 美元計費，約為 Claude Fable 5（每百萬 10 美元）的 1/230。這兩個功能可以疊加：快取使穩定前綴幾乎免費，`/eco` 則縮減每次回合實際支付的新的後綴。README 還包含一個對比表，使用實測比例重新計算 RTK 自身的會話模型，在平均假設下節省 19%，但在重尾的真實語料上節省 80%。
clawcodex 第 3 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 clawcodex、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 agentforce314/clawcodex 第 3 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 agentforce314/clawcodex 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agentforce314-clawcodex-deep-analysis 第 3 節的具體核對點是 令牌成本控制：/eco 與 DeepSeek 前綴快取。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
提供商覆蓋與訂閱登入
根據 README，ClawCodex 支援 30 個提供商，包括 Anthropic、OpenAI、Gemini、DeepSeek 等原生線格式，以及相容 OpenAI 的供應商和本機伺服器（如 Ollama、vLLM、SGLang）。任何新的相容 OpenAI 的供應商只需在 openai_compatible_specs.py 檔案中新增一行。README 還記錄了 Claude Pro/Max 和 ChatGPT 方案的訂閱登入。對於 Anthropic，`clawcodex login` 的訂閱選項會開啟 PKCE 授權頁面；對於 OpenAI，提供瀏覽器、裝置碼和從 Codex CLI 匯入三種方法。README 指出，從第三方用戶端使用訂閱並未獲得官方支援，且可能隨時停止運作。OpenAI 的訂閱模型包括 gpt-5.5、gpt-5.4 等，Anthropic 整合使用 OAuth 並自動重新整理權杖。顯式 API 金鑰始終優先於訂閱。
clawcodex 第 4 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 clawcodex、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 agentforce314/clawcodex 第 4 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 agentforce314/clawcodex 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agentforce314-clawcodex-deep-analysis 第 4 節的具體核對點是 提供商覆蓋與訂閱登入。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
權限與安全
互動式 CLI 預設以完全存取權限啟動，意味著它可以在不詢問的情況下編輯任何檔案和執行任何指令。使用者可透過 `/permissions` 變更此設定，它提供三個層級：請求批准、為我批准和完全存取。所選層級會儲存到 `~/.clawcodex/settings.json` 的 `permissions.defaultMode` 中。無頭模式（`-p`）預設保持 `default`，除非明確覆寫，儲存的完全存取權限不會放寬這一點。倉庫提供的設定可以收緊權限，但絕不會放寬，並且僅限於 `default` 和 `dontAsk` 模式。README 還描述了 `--dangerously-skip-permissions` 旗標，該旗標會停用所有檢查，並指出在 root 使用者下執行時會拒絕該旗標，除非設定了特定環境變數。`/plan` 模式即使在完全存取會話中也會限制編輯，除非明確放寬。
clawcodex 第 5 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 clawcodex、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 agentforce314/clawcodex 第 5 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 agentforce314/clawcodex 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agentforce314-clawcodex-deep-analysis 第 5 節的具體核對點是 權限與安全。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
基準測試及其侷限性
README 報告了在 Claude Opus 5 上以 effort=xhigh 單次執行 Terminal-Bench 2.1 的 pass@1 為 80.9%，解決了 89 個任務中的 72 個。它指出這是單次 k=1 的結果，與排行榜的 k=5 平均值對比，在公共排行榜上大約排在第三位。README 還包含一個 SWE-bench Verified 對比，ClawCodex 解決了 499 個實例中的 291 個（58.2%），而 openclaude 解決了 265 個（53.0%），兩者均由 Gemini 2.5 Pro 驅動。兩個結果都附帶明確的統計不確定性和可重現性說明，README 提供了用於本機重現的評估工具連結。Terminal-Bench 結果被描述為方向性參考，而非排名提交。
clawcodex 第 6 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 clawcodex、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 agentforce314/clawcodex 第 6 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 agentforce314/clawcodex 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agentforce314-clawcodex-deep-analysis 第 6 節的具體核對點是 基準測試及其侷限性。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
技能與定時任務
技能是儲存在 `.clawcodex/skills` 目錄下 `SKILL.md` 檔案中的 Markdown 格式斜線指令。它們支援命名引數和工具限制。`/loop` 指令按固定計畫或自定步調模式重複執行提示，使用由 CronCreate、CronList 和 CronDelete 工具管理的 cron 表達式。計畫提示在會話空閒時的回合之間觸發，重複任務在七天後自動過期。README 包含完整的 REPL 指令表，包括 `/eco`、`/stream`、`/compact` 等。技能系統支援專案級和使用者級技能，引數如 `$path` 和佔位符語法。`/loop` 功能還提供自定步調模式，模型透過 ScheduleWakeup 工具選擇下一個延遲。
clawcodex 第 7 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 clawcodex、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 agentforce314/clawcodex 第 7 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 agentforce314/clawcodex 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agentforce314-clawcodex-deep-analysis 第 7 節的具體核對點是 技能與定時任務。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
編輯結論
README 將 ClawCodex 描述為一個功能不斷增加的可用代理執行環境。它報告了具體的基準測試結果，並包含用於控制令牌使用和權限的工具。該專案正在積極開發中，README 提供了所報告基準的複現工具。 適合已能提供相容執行環境、願意依 agentforce314/clawcodex README 逐項核對的人；不適合把文件摘要當成生產承諾的團隊。先在隔離目錄依專案自己的入口跑最小案例，檢查 clawcodex 的實際輸出、錯誤訊息與設定檔，再決定是否接入正式流程。
社群筆記