Codex CLI 與 Claude Code 安裝與整合指南
本文整理目前主流的終端機 AI 編碼代理工具——OpenAI Codex CLI 與 Anthropic Claude Code——在 macOS、Linux、WSL 與 Windows 環境下的安裝方式、基本設定，以及兩者協同使用的進階配置。
工具總覽
| 工具 | 開發商 | 主要安裝方式 |
|---|---|---|
| Codex CLI | OpenAI | npm 全域安裝 |
| Claude Code | Anthropic | 原生安裝腳本（curl/irm）或 Homebrew / WinGet |
Claude Code 安裝步驟
官方建議使用「原生安裝」（Native Install），無需 Node.js，且支援背景自動更新。
macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
替代安裝方式
- Homebrew：
brew install --cask claude-code（預設不自動更新，需手動brew upgrade） - WinGet：
winget install Anthropic.ClaudeCode（預設不自動更新，需手動winget upgrade） - npm（舊式）：
npm install -g @anthropic-ai/claude-code（需 Node.js 22+）
驗證與啟動
安裝完成後，在專案資料夾執行：
claude
依畫面提示登入（需 Pro、Max、Team、Enterprise 或 Console 帳號；免費版 Claude.ai 不含 Claude Code 使用權）。
驗證安裝：
claude --version
# 或更詳細的診斷
claude doctor
Codex CLI 安裝步驟
Codex CLI 透過 npm 全域安裝，安裝後需登入 ChatGPT 帳號或設定 OpenAI API Key。
安裝
npm install -g @openai/codex
登入與啟動
codex login
codex
提示：若在 Claude Code 內部以 shell 指令呼叫，可在指令前加
!，例如!codex login。
兩者整合使用（進階）
OpenAI 提供官方 Codex Plugin，讓 Claude Code 可直接呼叫 Codex 進行程式碼審查或研究任務。
前置條件
- 已完成 Claude Code 與 Codex CLI 安裝
- 已執行
codex login完成授權
安裝外掛
# 1. 加入外掛市集
/plugin marketplace add openai/codex-plugin-cc
# 2. 安裝外掛
/plugin install codex@openai-codex
# 3. 重新載入外掛
/reload-plugins
# 4. 驗證安裝
/codex:setup
常用子指令
安裝完成後，在 Claude Code 輸入 /codex 可見以下子指令：
/codex:review— 程式碼審查/codex:status— 查詢審查狀態/codex:result— 取得審查結果
實測流程範例：
/codex:review --background
/codex:status
/codex:result
替代協作方式：tmux 分割視窗
不需外掛，啟動 tmux 並分割視窗：
- 左側執行
codex - 右側執行
claude
兩個模型可在同一終端環境中互相看見彼此輸出並協同工作，適合偏好手動掌控流程的使用者。
常見注意事項
| 環境 / 情境 | 注意事項 |
|---|---|
| Windows 原生安裝 Claude Code | 建議額外安裝 Git for Windows 以啟用 Bash 工具；否則將改用 PowerShell 作為執行環境。 |
| npm 全域安裝 | 切勿加 sudo，易造成權限與安全性問題；若遇權限錯誤，請改用官方原生安裝腳本。 |
| Alpine Linux 等 musl-based 系統 | 需額外安裝 libgcc、libstdc++、ripgrep，並設定環境變數 USE_BUILTIN_RIPGREP=0。 |
| Termux (Android) | 官方二進位檔無法直接使用，需搭配社群提供的修補腳本。 |
結語
Codex CLI 與 Claude Code 分別代表 OpenAI 與 Anthropic 在終端機 AI 編碼代理領域的最新佈局。兩者皆支援跨平台安裝，並可透過官方外掛或 tmux 等方式實現協同工作。建議依團隊既有訂閱方案、偏好工作流與作業系統環境，選擇單一工具或雙工具並行策略。