前言 最近Anthropic推出的Claude Code真的是火出圈了！作为一个可以直接在终端运行的AI编程助手，它不仅能写代码、改Bug，还能理解整个项目架构，甚至帮你执行Shell命令。
经过一段时间的深度使用，我发现它比传统的IDE插件要强大得多——真正的“智能体”体验。今天就手把手教大家如何在Linux服务器或本地环境中部署Claude Code，以及如何玩转它的各种骚操作！
目录
一、环境准备
1.1 系统要求
1.2 安装Node.js环境
二、安装Claude Code
2.1 方法一：官方脚本安装
2.2 方法二：NPM全局安装（强烈推荐）
2.3 验证安装
三、核心配置
3.1 配置API密钥
方案A：使用Anthropic官方API
方案B：使用阿里云百炼（国内推荐，速度快）
3.2 跳过官方登录验证
四、使用指南
4.1 基本启动
4.2 三大核心工作模式（Shift+Tab切换）
4.3 神器：斜杠命令 (/ 命令)
4.4 实战演示
五、常见问题
Q1: command not found: claude
Q2: 低配服务器（1G/2G内存）安装失败
Q3: 连接不上，报错 ERR_BAD_REQUEST
Q4: 对话太长卡顿了怎么办？
六、进阶小贴士
结语
一、环境准备
在动手之前，我们先确认一下环境。Claude Code基于Node.js运行，所以第一步是装好Node.js。
1.1 系统要求
-
操作系统：Linux (Ubuntu 20.04+, CentOS 8+), macOS, 或 Windows WSL2
-
内存：建议4GB以上（小内存服务器请参考文末的Swap配置）
-
网络：需要能访问外网（或配置代理），如果不能访问用NPM安装配置国内镜像源
1.2 安装Node.js环境
⚠️注意：Claude Code要求Node.js版本 >= 18，建议直接上20.x或22.x：
# 1. 更新系统包
sudo apt update && sudo apt upgrade -y
# 2. 安装必要依赖
sudo apt install -y curl wht gpg
# 3. 添加NodeSource仓库（以Node.js 20.x为例）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash –
# 4. 安装Node.js
sudo apt install -y nodejs
# 5. 验证版本（务必检查！）
node -v # 输出类似 v20.19.4
npm -v # 输出类似 10.9.2
如果你是Windows用户，请先安装WSL2（Windows Subsystem for Linux），然后在Ubuntu子系统中操作，体验完全一致。
二、安装Claude Code
Node环境就绪后，安装Claude Code就非常简单了，这里有三种方法供你选择，推荐方法一：。
2.1 方法一：官方脚本安装
该方法会自动配置路径并支持后续自动更新：
# 一行命令搞定
curl -fsSL https://claude.ai/install.sh | bash
⚠️注意：在中国地区通过官方源安装会报地区不支持！！！
安装完成后，脚本会提示你把路径加到环境变量，按提示操作即可：
# 如果是bash用户
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
# 如果是zsh用户
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
2.2 方法二：NPM全局安装（强烈推荐）
npm install -g @anthropic-ai/claude-code
如果下载速度过慢或者出现连接问题可以配置国内镜像源：
npm install -g @anthropic-ai/claude-code –registry=https://registry.npmmirror.com
2.3 验证安装
claude –version
# 正常会输出版本号，比如 2.1.x
如果显示command not found，一般是环境变量问题，可以参考上面的步骤修复。
三、核心配置
Claude Code本质上需要调用Anthropic的大模型API。如果你是海外服务器且有官方Key，直接配置官方地址即可；如果是国内开发者，可以使用中转服务或阿里云百炼。
3.1 配置API密钥
我们需要创建配置文件~/.claude/settings.json：
# 创建配置目录
mkdir -p ~/.claude
# 编辑配置文件
vim ~/.claude/settings.json
根据你的实际情况，复制对应的配置内容：
方案A：使用Anthropic官方API
{
"env": {
"ANTHROPIC_API_KEY": "sk-ant-your-api-key-here",
"ANTHROPIC_BASE_URL": "https://api.anthropic.com",
"ANTHROPIC_MODEL": "claude-3-5-sonnet-latest"
}
}
方案B：使用阿里云百炼（国内推荐，速度快）
去阿里云百炼开通服务并获取API Key：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-your-alibaba-api-key",
"ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "claude-3-5-sonnet"
}
}
3.2 跳过官方登录验证
为了直接进入终端界面，我们告诉Claude已经“完成过引导”了：
# 创建或编辑 ~/.claude.json
vim ~/.claude.json
写入以下内容：
{
"hasCompletedOnboarding": true
}
✅ 至此，安装配置全部完成！
四、使用指南
4.1 基本启动
在你的项目目录下，直接输入claude即可启动：
cd /home/your-user/my-project
claude
看到下面的界面和输入框，就说明启动成功了！
4.2 三大核心工作模式（Shift+Tab切换）
这是Claude Code的设计精髓，通过按Shift+Tab可以在三种模式间循环切换：
| Default模式 | ? for shortcuts | 每次修改文件、执行命令都需要确认 | 日常开发，最安全 |
| Auto-Accept模式 | accept edits on | 自动接受文件修改，但执行Shell仍需确认 | 批量修改、简单代码生成 |
| Plan Mode ✨ | plan mode on | 只读模式，不修改任何文件，只做分析规划 | 学习源码、重构方案设计 |
最佳实践工作流：先用Plan Mode理清思路 → 切回Default看一眼计划 → 切到Auto-Accept快速执行 → 切回Default做安全检查。
4.3 神器：斜杠命令 (/ 命令)
在对话输入框中，输入/可以看到所有命令，这里有几个非常实用的：
-
/init：最最重要！ 让Claude扫描你的项目结构，生成CLAUDE.md记忆文件。之后每次对话它都会记住项目规范。
-
/memory：直接编辑记忆文件，告诉它“这个项目不要改test目录”、“提交格式必须是feat: xxx”。
-
/model：切换模型。简单任务用Haiku（快又便宜），复杂架构用Opus。
-
/clear：清空对话历史，让脑子乱的时候重置上下文。
-
/cost：看看你今天花了多少Token（防止账单爆炸💥）。
4.4 实战演示
假设你要在一个老旧项目中排查Bug：
Step 1: 初始化
> /init
[Claude正在扫描目录结构…]
已生成 CLAUDE.md 记忆文件。
Step 2: 切换到Plan Mode 按两次 Shift+Tab，提示符变成 plan mode on。
Step 3: 下达指令
> 分析一下src/main.py的逻辑，找出为什么数据库连接池会泄露，不要急着改代码。
[AI开始只读分析…]
Step 4: 执行修改 切回 Auto-Accept 模式：
> 按照刚才的方案修复连接池问题，并添加超时机制。
[AI自动修改文件…]
五、常见问题
Q1: command not found: claude
A: 安装目录未加入PATH。执行以下命令重试：
export PATH="$HOME/.local/bin:$PATH"
# 然后添加进 ~/.bashrc 或 ~/.zshrc
Q2: 低配服务器（1G/2G内存）安装失败
A: 内存不足，创建Swap交换分区：
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# 重试安装命令即可
Q3: 连接不上，报错 ERR_BAD_REQUEST
A: 这通常是因为环境变量没生效，或者配置的ANTHROPIC_BASE_URL不对。检查~/.claude/settings.json文件格式是否正确，然后重启终端再试。
Q4: 对话太长卡顿了怎么办？
A: 输入 /compact 让AI自动压缩上下文，或者 /clear 直接新开一局。
六、进阶小贴士
后台运行任务 如果执行了耗时的编译命令，按 Ctrl + B 可以把任务挂到后台，然后用 /tasks 查看进度。
图片理解 Claude Code支持传图片！截图后直接 Cmd+V (Mac) 或 Ctrl+V (Win) 粘贴到终端，它就能看懂UI布局或架构图。
团队共享配置 把项目根目录下的 CLAUDE.md 提交到Git仓库，整个团队就能共用一套AI开发规范，新人上手体验直接拉满！
结语
Claude Code不仅仅是一个“聊天机器人”，它已经成为了我的结对编程搭档。特别是在Linux环境下，它的响应速度和操作流畅度远超网页版。
赶紧去试试吧，相信你会回来感谢我的！
如果你在安装过程中遇到了其他问题，欢迎在评论区留言，我们一起探讨！👇
