giip

Linux + Claude Code 設置指南

引導您如何在 Linux 伺服器環境中安裝 Claude Code，並將 AI 驅動的自主優化及本地代碼編輯功能與 GIIP 平台聯動。

📋 概述

Claude Code 是一款允許您在終端直接執行 Anthropic Claude 模型的工具。在 Linux 伺服器中糾正複雜的配置文件 (Config)、分析系統性能以及優化代碼方面，它表現出了極其強大的性能。

🛠️ 安裝與設置步驟

1. 前置要求

  • Node.js 及 npm: 需要 Node.js 18 或更高版本。
  • Anthropic API Key: 需要用於使用 Claude 模型的 API 密鑰。

2. 安裝 Claude Code

在終端執行以下命令進行全域安裝：

npm install -g @anthropic-ai/claude-code

3. 認證與 API 設置

  1. 在 Anthropic Console 中生成 API 密鑰。
  2. 在 Shell 配置文件（如 
    .bashrc
    或 
    .zshrc
    ）中註冊 API 密鑰。 
    export ANTHROPIC_API_KEY="your-api-key"
source ~/.bashrc

4. GIIP 聯動

在安裝了 GIIP Agent Linux (

giipAgentLinux
) 的環境中執行 Claude Code 後，Claude 可以直接讀取由代理收集的系統指標和日誌，並編寫分析報告。

🚀 核心應用案例

  • 配置文件優化: 
    claude "找出 nginx.conf 文件的性能優化點"
  • 系統安全檢查: 
    claude "檢查 /etc/ssh/sshd_config 文件的安全漏洞"
  • 自動化腳本編寫: 
    claude "編寫一個自動備份伺服器的 bash 腳本"

💡 技巧

  • 使用 
    claude --help
    命令查看各種 CLI 選項。
  • 在 GIIP 平台的 問題管理 頁面中，選擇以 
    Linux + Claude
    組合註冊的任務，分析結果將遠端同步。

🔧 疑難排解

症狀原因解決方法
安裝後出現 
claude: command not found
Node.js 版本低於 18，或 npm 全域路徑未生效安裝 Node.js 18 或更高版本，並重新執行 
npm install -g @anthropic-ai/claude-code
執行時出現認證錯誤(API 密鑰無效)未設定 
ANTHROPIC_API_KEY
或未載入至 Shell		在 
.bashrc
(或 
.zshrc
)中註冊密鑰並執行 
source ~/.bashrc
npm install -g
過程中出現權限(EACCES)錯誤		對全域安裝路徑沒有寫入權限使用 
sudo
執行，或將 npm 全域 prefix 變更為使用者路徑
Claude 無法讀取 GIIP 系統指標和日誌
giipAgentLinux
未安裝或未執行		先確認 Linux 代理是否正常執行

版本: 1.0 最後更新: 2026-03-19 源文件: 

giipv3/public/help/agent-setup-linux-claude.zh-TW.md

← Previous
Linux/WSL 智能體安裝指南
Next →
CQE 腳本管理