在Ubuntu上用npm安装Claude Code CLI：从零开始的完整指南

什么是Claude Code？

Claude Code 是 Anthropic 推出的命令行界面工具，专为开发者设计，它不像传统聊天窗口或新IDE那样，而是直接运行在你熟悉的终端环境中，能够理解项目结构、读取并修改文件、执行命令，帮你完成从代码生成到审查、从重构到Git提交的整个开发流程。

本文将以Ubuntu系统为例，介绍如何通过npm安装并配置Claude Code CLI。

环境准备

Claude Code 采用TypeScript开发，编译后发布到npm上，运行时依赖Node.js，所以安装前需要先准备好Node.js环境。Claude Code 最低要求 Node.js 18，建议使用 Node.js 20 LTS 以获得更好的稳定性和兼容性。

第一步：安装Node.js和npm

Ubuntu系统下，可以直接通过apt安装Node.js：

# 更新软件包列表
sudo apt update

# 安装Node.js和npm
sudo apt install nodejs npm

# 验证安装版本
node --version
npm --version

如果你需要更灵活的版本管理，推荐使用nvm（Node Version Manager） 。这样可以避免权限问题，也便于在不同Node.js版本之间切换：

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

# 重新加载shell配置
\. "$HOME/.nvm/nvm.sh"

# 安装Node.js 22（推荐版本）
nvm install 22

# 设为默认版本
nvm alias default 22

国内加速小技巧：如果nvm下载速度慢，可以设置国内镜像源：

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
nvm install 22

第二步：配置npm镜像（国内用户）

为了加快npm包的下载速度，建议配置国内镜像源：

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com

安装Claude Code CLI

环境准备就绪后，使用npm全局安装Claude Code。-g参数表示将软件包安装到系统的全局位置，这样在终端的任何路径下都可以执行claude命令：

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

安装完成后，验证是否成功：

claude --version

如果输出版本号（如 2.1.80 (Claude Code)），说明安装成功。

配置认证信息

Claude Code 支持两种认证配置方式：settings.json 文件配置和环境变量配置。

方式一：通过settings.json配置（推荐）

创建配置目录和文件：

# 创建配置目录
mkdir -p ~/.claude

# 编辑settings.json文件
vim ~/.claude/settings.json

在 settings.json 中添加以下内容：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
    "ANTHROPIC_AUTH_TOKEN": "你的API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-20250514"
  }
}

配置项说明：

ANTHROPIC_BASE_URL：API服务地址（使用官方API保持默认即可）
ANTHROPIC_AUTH_TOKEN：你的Anthropic API Key，在Anthropic Console中获取
ANTHROPIC_MODEL：默认使用的主模型
ANTHROPIC_SMALL_FAST_MODEL：轻量级模型，用于快速任务

方式二：使用环境变量

你也可以临时设置环境变量：

export ANTHROPIC_AUTH_TOKEN="你的API_KEY"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"

使用国内模型服务（可选）

如果你使用的是国内第三方API服务（如MiniMax、腾讯云等），需要将 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 替换为相应服务商提供的地址和密钥。

启动Claude Code

配置完成后，在终端中输入以下命令启动：

claude

首次启动时，Claude Code会引导你完成初始设置，包括：

选择主题（dark/light模式）
确认安全须知
配置终端设置
信任工作目录

完成这些步骤后，你就可以在终端中直接与Claude对话了。

常用命令速查

基础CLI命令

命令	说明
`claude`	启动交互模式
`claude -p "你的问题"`	运行一次性任务后退出
`claude -c`	继续最近的对话
`claude commit`	自动创建Git提交
`claude --dangerously-skip-permissions`	跳过权限确认（谨慎使用）

交互模式中的斜杠命令

进入交互模式后，输入 / 即可查看所有可用命令。以下是几个最常用的：

命令	说明
`/help`	获取使用帮助
`/clear`	清除对话历史
`/compact`	压缩上下文以节省token
`/model`	切换AI模型
`/init`	创建CLAUDE.md项目配置文件
`/cost`	显示令牌使用统计
`/doctor`	检查安装健康状况
`/permissions`	查看或更新权限设置
`/login` / `/logout`	登入/登出账户

键盘快捷键

Ctrl+C：取消当前生成
Ctrl+R：搜索命令历史
Shift+Tab：切换模式（正常 → 自动接受 → 计划）

进阶技巧

1. 使用CLAUDE.md定义项目规则

在每个项目根目录下执行 /init 命令，Claude会生成一个 CLAUDE.md 文件。Claude Code 每次会话都会读取这个文件，作为项目的“持久记忆”。你可以在里面定义项目的技术栈、代码风格偏好、测试规范等，让AI更好地理解你的项目上下文。

# 进入项目目录
cd your-project

# 启动Claude Code
claude

# 在交互模式中执行
/init

2. 版本更新

Claude Code默认会自动保持最新状态。如需手动更新：

claude update

如需禁用自动更新：

export DISABLE_AUTOUPDATER=1

3. 一键式任务执行

对于简单的、单次性的任务，可以使用 -p 参数直接执行并退出，无需进入交互模式：

# 生成快速排序函数
claude -p "创建一个Python快速排序函数"

# 代码审查
claude -p "review this code for potential bugs"

常见问题

Q：提示 "command not found: claude" 怎么办？
A：这通常是因为npm全局安装的路径没有加入系统PATH。可以检查npm的全局安装路径：npm config get prefix，然后将该路径下的bin目录加入PATH。

Q：安装时遇到权限问题？
A：使用nvm安装Node.js可以彻底避免sudo权限问题。如果已经使用apt安装了Node.js，可以尝试设置npm的全局安装目录到用户目录下。

Q：网络连接不稳定？
A：建议配置国内npm镜像源，或使用代理工具。部分用户反馈原生安装脚本在国内环境下可能不够稳定，使用npm安装是更可靠的选择。

Q：API调用超时怎么办？
A：可以在 settings.json 中增加 "API_TIMEOUT_MS": "3000000" 来延长超时时间。

Q：连接失败

A：检查密钥是否正确。对于DeepSeek确认转发地址，即Base URL 为：https://api.deepseek.com/anthropic

结语

Claude Code CLI 将AI编程助手无缝融入终端工作流，让你无需切换界面就能完成从代码编写到Git提交的全流程操作。配合VS Code扩展和JetBrains插件，还可以将终端能力延伸到IDE中，实现更完整的开发体验。希望这篇指南能帮助你顺利上手Claude Code，享受AI辅助编程带来的效率提升。