CLI 手動設定
環境檢查
設定任何 CLI 之前先確認基礎環境到位
無論你最終用 Claude Code、Codex 還是 Gemini,都需要先把 Node.js 和對應的 CLI 裝好。這一頁幫你跑完前置檢查。
1. 檢查 Node.js
在終端機執行:
node -v
npm -v正常情況下兩條命令都會輸出版本號(Node.js 建議 18 及以上)。如果提示「命令未找到」或類似錯誤,說明 Node.js 沒裝好,請先去 Node.js 官網 下載 LTS 版本安裝。
2. 安裝 CLI
直接一條龍裝齊:
npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest只用其中某一個的話,按需安裝即可,不用全裝。
Windows 使用者:如果上面命令報權限錯誤,請用「以系統管理員身分執行」開啟 PowerShell / CMD 再執行。
3. 首次執行(產生設定目錄)
這一步非常關鍵,不跑這一步後續要編輯的設定檔不會被自動產生。
claude出現互動介面或登入提示就說明安裝成功,按 Ctrl+C 退出。此時 ~/.claude/ 目錄已經被建立。
如果執行 claude 時報錯 Unable to connect to Anthropic services,看 常見問題:Claude Code 無法連線。
codex同理,看到互動介面就退出。~/.codex/ 目錄已被建立。
gemini~/.gemini/ 目錄已被建立。
完成上述三步後,就可以挑你要用的工具,去對應的設定頁繼續。