Linux + Claude Code Setup Guide

Learn how to install Claude Code in a Linux server environment and integrate AI-driven autonomous optimization and local code editing features with the GIIP platform.

📋 Overview

Claude Code is a tool that allows you to run Anthropic's Claude models directly in your terminal. It is exceptionally powerful for correcting complex configuration files, analyzing system performance, and optimizing code within Linux servers.

🛠️ Installation & Setup Steps

1. Prerequisites

• Node.js & npm: Node.js version 18 or higher is required.
• Anthropic API Key: An API key is needed to use Claude models.

2. Install Claude Code

Install globally using the following command in the terminal:

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

3. Authentication & API Setup

1. Generate an API key from the Anthropic Console.
2. Register the API key in your shell profile (e.g., .bashrc or .zshrc).

   export ANTHROPIC_API_KEY="your-api-key"
   source ~/.bashrc

4. GIIP Integration

When you run Claude Code in an environment where GIIP Agent Linux (giipAgentLinux) is installed, Claude can directly read system metrics and logs collected by the agent to create analysis reports.

🚀 Key Usage Cases

• Config Optimization: claude "Find performance optimization points for nginx.conf"
• Security Audit: claude "Audit security vulnerabilities in /etc/ssh/sshd_config"
• Script Automation: claude "Write a bash script to automate server backups"

💡 Tips

• Check various CLI options using claude --help.
• In the GIIP Issue Management page, selecting a task registered with the Linux + Claude combination will synchronize analysis results remotely.

🔧 Troubleshooting

Symptom	Cause	Solution
claude: command not found after installation	Node.js is older than 18, or the npm global path is not set	Install Node.js 18 or later and re-run npm install -g @anthropic-ai/claude-code
Authentication error (invalid API key) on run	ANTHROPIC_API_KEY is not set or not loaded into the shell	Register the key in .bashrc (or .zshrc) and run source ~/.bashrc
Permission error (EACCES) during npm install -g	No write permission to the global install path	Run with sudo or change the npm global prefix to a user path
Claude cannot read GIIP system metrics and logs	giipAgentLinux is not installed or not running	Verify the Linux agent is running properly first

---

Version: 1.0 Last Updated: 2026-03-19 Source: giipv3/public/help/agent-setup-linux-claude.en.md