OpenParable
Skip to content
← Back to skills

Install Claude Code Linux

Apps & Automation
install-claude-code-linux

Install Claude Code Linux is an Agent Skill for apps & automation published in the alibaba/anolisa repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Install and configure Claude Code on RPM-based Linux systems (e.g., Alibaba Cloud Linux) with multiple fallback methods (native installer, npm, nvm+npm). Includes DashScope/Qwen API configuration template. Use when the user asks to install Claude Code CLI, set up Claude Code CLI, or configure Claude Code with a custom API endpoint on RPM-based Linux systems.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/alibaba/anolisa/blob/HEAD/src/os-skills/ai/install-claude-code/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/install-claude-code-linux, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Install Claude Code on Alinux 4

System Requirements

  • OS: Linux
  • RAM: 4 GB+
  • Network: 需要联网
  • Shell: Bash
  • Package Manager: dnf

Installation Workflow

Copy this checklist and track progress:

Task Progress:
- [ ] Step 1: Check system & install prerequisites
- [ ] Step 2: Install Claude Code (try methods in order)
- [ ] Step 3: Verify installation
- [ ] Step 4: Configure API provider
- [ ] Step 5: Test run
- [ ] Step 6: Tokenless plugin auto-installed

Step 1: Check System & Install Prerequisites

Alinux 4 使用 dnf 作为包管理器。先确保基础依赖就绪:

# 确认系统版本
cat /etc/os-release

# 安装基础依赖
sudo dnf install -y curl git tar gzip glibc libstdc++

Step 2: Install Claude Code

Try these methods in order. Move to the next only if the previous one fails.

Method A: Native Installer (Recommended)

curl -fsSL https://claude.ai/install.sh | bash

官方推荐方式,自动后台更新,无需 Node.js 依赖。

To install a specific version:

curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

To install the stable channel:

curl -fsSL https://claude.ai/install.sh | bash -s stable

安装后确保 ~/.local/bin 在 PATH 中:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Method B: npm Global Install (Fallback)

Requires Node.js 18+. Alinux 4 默认源的 Node.js 版本可能较低,建议先确认版本:

node --version

如果 >= 18,直接安装:

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

Do NOT use sudo npm install -g — it causes permission issues. If you get EACCES errors, fix npm prefix:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

Method C: nvm + npm (When No Node.js 18+ Available)

Alinux 4 默认源可能只有 Node.js 16,此方法通过 nvm 安装 LTS 版本:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install --lts
npm install -g @anthropic-ai/claude-code

Or use the automated script (auto-fallback all 3 methods):

bash scripts/install-claude-code.sh

Pass --skip-tokenless to skip the tokenless Claude Code plugin auto-installation.

Step 3: Verify Installation

claude --version
claude doctor

Step 4: Configure Third-Party API Provider

If the user is NOT using an Anthropic account directly, configure ~/.claude/settings.json with their API provider:

mkdir -p ~/.claude

DashScope (Qwen) Configuration Template:

Write the following to ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "qwen3-coder-plus",
    "ANTHROPIC_SMALL_FAST_MODEL": "qwen3-coder-plus"
  }
}

Replace YOUR_API_KEY with the user's actual API key.

Alternative: Shell Environment Variables

If the user prefers shell env vars over settings.json, append to ~/.bashrc:

export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/apps/anthropic"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="qwen3-coder-plus"
export ANTHROPIC_SMALL_FAST_MODEL="qwen3-coder-plus"

Then source ~/.bashrc.

One-liner with script (interactive key input):

bash scripts/install-claude-code.sh --config

Step 5: Test Run

claude "hello, tell me who you are"

If using a third-party API, verify the model responds correctly. If you see authentication errors, double-check the API key and base URL.

Troubleshooting

SymptomFix
command not found: claudeCheck ~/.local/bin is in PATH: export PATH="$HOME/.local/bin:$PATH"
Native installer hangsTry npm method (Method B or C)
EACCES permission error (npm)Use the npm prefix fix shown in Method B
model not foundVerify ANTHROPIC_MODEL value matches the provider's model name exactly
Timeout errorsAdd "API_TIMEOUT_MS": "600000" to the env block in settings.json
GLIBC_xxx not foundRun sudo dnf update glibc libstdc++ to update C runtime
dnf lock conflictWait for other dnf process to finish, or sudo kill the stale process

Uninstall

Native installation:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

npm installation:

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

Remove config (optional):

rm -rf ~/.claude
rm -f ~/.claude.json