ubuntu中安装claude code

在 Ubuntu 中安装 Claude Code （Anthropic 官方推出的命令行工具）主要有两种方式。最推荐的方式是使用 npm 安装，因为它通用性最强；如果你不想安装 Node.js，也可以使用官方脚本进行原生安装。

以下是基于 Ubuntu 22.04/24.04 的完整安装与配置指南。

🛠️ 方式一：通过 npm 安装（推荐）

这是最标准的方法，适合大多数开发者。

1. 安装 Node.js 环境

Claude Code 依赖 Node.js 运行。请确保你的 Node.js 版本在 18.0 或更高。

打开终端，执行以下命令安装最新版 LTS（长期支持版）：

bash 复制代码

# 1. 更新系统包
sudo apt update && sudo apt upgrade -y

# 2. 安装 Node.js (使用 NodeSource 源安装 v20 或 v22)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 3. 验证版本
node --version
npm --version

2. 安装 Claude Code

使用 npm 全局安装：

bash 复制代码

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

⚠️ 注意：权限问题处理

如果执行上述命令时出现 EACCES 或权限错误，不要直接使用 sudo。推荐通过以下命令配置用户级全局目录：
bash 复制代码
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
# 然后重新运行安装命令
npm install -g @anthropic-ai/claude-code

⚡ 方式二：通过官方脚本安装（原生模式）

这种方式无需安装 Node.js，工具会自动更新，适合希望环境隔离的用户。

直接在终端运行：

bash 复制代码

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

🔑 认证与配置

安装完成后，你需要进行身份认证才能使用。

1. 启动并登录

在终端输入以下命令启动：

bash 复制代码

claude

首次运行会显示一个验证码，并自动打开浏览器跳转到 Anthropic 官网。
登录你的账号（需要 Claude Pro 订阅或 API 账户）并授权，终端即可连接。

2. 手动配置 API Key（可选）

如果你无法使用浏览器登录（例如在服务器环境），可以在配置文件 ~/.claude/settings.json 中直接写入 API Key：

json 复制代码

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的-API-Key-在这里"
  }
}

🚀 开始使用

进入项目目录 ：
bash 复制代码
```
cd /path/to/your/project
```
初始化项目 ：
输入 claude 启动。它会询问是否创建 CLAUDE.md 文件，建议选择"是"。这个文件是项目的"说明书"，你可以告诉它项目的构建命令、测试命令和代码规范，它会记住这些上下文。
验证安装 ：
你可以输入 claude --version 查看版本号，或者输入 /help 查看可用指令。

💡 常见问题

网络问题：由于服务器在海外，连接时可能需要配置网络代理。
Git 依赖 ：建议安装 Git (sudo apt install git)，这样 Claude Code 能更好地理解项目历史和版本控制。