10x-cli-guide 是做什麼的？
當使用者詢問如何在日常使用 10x-cli — 包含獲取課程、列出模組、切換 AI 工具、排解錯誤、了解產出檔案存放位置，或在特定作業系統（Windows、Linux、macOS）上操作時，請呼叫此技能。涵蓋指令（get、list、doctor、auth --status/--logout）、工具設定檔、產出檔案位置、常見錯誤以及平台特定提示。排除：首次安裝與入門（請改用 10x-cli-setup）、開發或貢獻 10x-cli 原始碼，以及一般程式設計協助。
指令參考
get <lesson-id>：依據課程 ID 獲取特定課程內容。list：列出所有可用的模組與課程。doctor：執行環境診斷，檢查常見配置問題。auth --status：顯示目前的驗證狀態。auth --logout：登出並清除本機驗證 Token。
工具設定檔
10x-cli 支援多種 AI 工具設定檔，允許你在不同工具之間切換：
claude：針對 Claude Code 最佳化。cursor：針對 Cursor 編輯器最佳化。codex：針對 Codex 代理最佳化。
切換設定檔：
10x config set tool claude
產出檔案位置
Artifacts（課程產出的檔案）預設儲存在以下位置：
| 作業系統 | 路徑 |
|---|---|
| macOS | ~/Library/Application Support/10x/artifacts/ |
| Linux | ~/.local/share/10x/artifacts/ |
| Windows | %APPDATA%\10x\artifacts\ |
你可以透過 10x config set artifacts-dir <path> 自訂產出目錄。
常見錯誤
| 錯誤代碼 | 訊息 | 解決方案 |
|---|---|---|
E001 | 授權失敗 | 執行 auth --status 檢查 Token，必要時重新登入。 |
E002 | 網路逾時 | 檢查網路連線，或設定代理：10x config set proxy http://proxy:port。 |
E003 | 快取衝突 | 執行 10x doctor 清除快取。 |
E004 | 無效的課程 ID | 使用 list 確認課程 ID 是否正確。 |
平台特定提示
Windows
- 使用 PowerShell 或
cmd.exe。建議以系統管理員身分執行部分指令。 - 路徑分隔符使用反斜線 (
\)。
Linux
- 確保
~/.local/bin已加入PATH。 - 若使用 Snap 或 Flatpak 安裝，產出路徑可能有所不同。
macOS
- Artifacts 預設儲存在
~/Library/Application Support/10x/artifacts/。 - 如果遇到權限問題，請檢查
~/Library/Application Support/的目錄權限。