乐于分享
好东西不私藏

Ubuntu24.04 安装 Claude Code 超详细教程

Ubuntu24.04 安装 Claude Code 超详细教程
作为开发者,谁不想拥有一个“全能编程搭子”?不用切换窗口,在终端就能搞定代码编写、Bug修复、项目重构,甚至能读懂整个代码库的依赖关系——Claude Code 就是这样一款宝藏工具 ✨
先搞懂:Claude Code 到底是什么?
Claude Code 是 Anthropic 推出的终端原生 AI 编程助手,依托强大的 Opus 4.6 模型和最高 100 万 token 的超大上下文窗口,早已不是简单的代码生成器,而是能自主完成开发全流程的“项目级 AI 工程师”。
和 VS Code 插件类工具不同,它直接运行在终端环境,无需切换IDE,能深度融入开发者的日常工作流,核心优势一眼看懂:
  • 全栈适配:支持 40+ 编程语言(JS/TS、Python、Java、Go 等),覆盖前后端全框架,复杂类型系统和架构模式都能轻松理解;
  • 项目级理解:百万级上下文可一次性载入完整中小型项目,轻松搞定跨文件依赖梳理、无文档老项目接手、全局重构;
  • 终端原生交互:直接在终端执行命令、运行测试、调试代码,还能访问本地文件系统、数据库,无需额外配置;
  • 安全高效:支持权限控制、检查点回滚,可自定义操作白名单,避免误删文件或执行高危命令,兼顾安全与效率;
  • 2026 新特性加持:新增多智能体协作、语音编程、手机远程控制等功能,进一步解放开发者双手。
简单说,普通编程助手是“片段补全工具”,而 Claude Code 是能和你并肩作战的“AI 开发同事”,尤其适合经常使用终端的 Linux 开发者。
前置准备:Ubuntu24.04 系统要求检查
在安装前,先确认你的 Ubuntu24.04 系统满足以下基础要求,避免安装过程中出现报错(提前检查,少走弯路):
  1. 系统版本:Ubuntu 24.04 LTS(确保系统已更新至最新,避免依赖包缺失);
  2. 硬件要求:最低 4GB 内存,推荐 8GB 及以上(支撑大上下文运行更流畅);
  3. 网络环境:稳定的网络连接(用于下载安装包、完成认证);
  4. 必备工具:终端(Ubuntu 自带,Ctrl+Alt+T 快速打开)、curl(用于下载安装脚本);
  5. 账号准备:有效的 Anthropic 账户(用于后续认证,没有的话提前注册即可)。
温馨提示:Ubuntu24.04 自带 curl 工具,若提示“command not found”,先执行 sudo apt update && sudo apt install curl -y 安装即可。
重点来了:Ubuntu24.04 安装 Claude Code 详细步骤
目前 Claude Code 推荐使用原生二进制安装(NPM 安装方式已废弃),步骤简洁,全程复制命令即可,分为 5 步,每一步都有详细说明和避坑提示。
步骤 1:更新系统软件包(必做)
首先更新 Ubuntu 系统的软件包列表,确保所有依赖包都是最新版本,避免因依赖不兼容导致安装失败:
sudo apt update && sudo apt upgrade -y
执行后会自动更新软件包,耐心等待即可(时间根据网络速度而定,一般 1-5 分钟)。
步骤 2:下载并执行 Claude Code 安装脚本
Anthropic 提供了官方安装脚本,直接通过 curl 下载并执行,无需手动配置复杂路径,这是最简单高效的安装方式:
curl -fsSL https://claude.ai/install.sh | bash
⚠️ 避坑提示:不要使用 sudo 执行该命令,否则会导致权限异常,后续无法正常启动 Claude Code。
执行命令后,脚本会自动下载最新版本的 Claude Code 并完成安装,过程中会显示安装进度,等待提示“Installation successful”即安装完成。
步骤 3:验证安装是否成功
安装完成后,无需重启终端,直接执行以下命令,验证 Claude Code 是否安装成功并查看版本:
claude --version
若输出类似 “Claude Code v2.1.104” 的版本信息(版本号可能随更新变化),说明安装成功;若提示“command not found”,可关闭终端重新打开再尝试(一般是环境变量未即时生效)。
可选操作:执行claude /doctor 运行诊断,检查安装环境是否存在异常,确保后续使用无问题。
步骤 4:完成 Anthropic 认证(关键步骤)
Claude Code 需要绑定 Anthropic 账户才能使用,支持两种认证方式,推荐新手使用 OAuth 交互式登录,操作更简单:
  1. 执行认证命令:
claude auth login
  1. 执行后,终端会提示生成一个认证链接,同时显示一串验证码;
  2. 复制链接,在浏览器中打开(Ubuntu 自带浏览器即可),登录你的 Anthropic 账户;
  3. 在浏览器中输入终端显示的验证码,点击确认,完成绑定;
  4. 返回终端,若提示“Auth successful”,说明认证完成。
备选方案:若浏览器无法正常打开链接,可使用控制台认证,执行 claude auth login --console,按照提示输入账户信息即可。
步骤 5:首次启动 Claude Code,测试功能
认证完成后,即可启动 Claude Code,开始体验终端编程助手的强大功能:
  1. 启动 Claude Code(交互式模式,推荐新手):
claude
  1. 启动成功后,终端会显示欢迎信息,进入 Claude Code 交互界面;
  2. 测试功能:输入简单的编程需求,比如 “用 Python 写一个快速排序算法”,Claude Code 会立即生成代码并显示在终端,还会给出代码说明;
  3. 退出 Claude Code:输入 /exit 即可退出交互模式。
至此,Ubuntu24.04 安装 Claude Code 全部完成,接下来就可以用它高效编写代码、修复 Bug、重构项目啦!
安装常见问题排查(避坑必看)
很多新手在安装过程中会遇到一些小问题,整理了 3 个最常见的报错及解决方案,帮你快速解决:
  • 问题 1:执行安装脚本提示“Permission denied”解决方案:不要用 sudo 执行安装命令,直接执行curl -fsSL https://claude.ai/install.sh | bash,若仍报错,执行 chmod +x install.sh 赋予脚本执行权限,再重新安装。
  • 问题 2:验证版本时提示“command not found”解决方案:关闭终端重新打开,若仍无效,执行 export PATH=$PATH:~/.local/bin 配置环境变量,再执行 claude --version
  • 问题 3:认证时链接无法打开、验证码无效解决方案:检查网络连接,确保能正常访问外网;若仍不行,切换网络(比如手机热点),或使用控制台认证方式(claude auth login --console)。  
新手入门:Claude Code 常用基础命令
安装完成后,记住这几个常用命令,快速上手 Claude Code,提升开发效率:
  • claude:启动 Claude Code 交互式模式;
  • claude --version:查看当前版本;
  • claude auth status:查看认证状态;
  • claude /init:在项目根目录生成 CLAUDE.md 记忆文件,保存项目规范;
  • claude /permissions:设置操作权限,自定义安全白名单;
  • claude /rewind:打开检查点列表,一键回滚项目状态;
  • claude /exit:退出 Claude Code。
Claude Code 作为终端原生的 AI 编程助手,完美适配 Ubuntu24.04 系统,安装过程简单,无需复杂配置,新手也能轻松搞定。它的超大上下文、项目级编辑、安全权限控制等功能,能真正帮开发者从重复繁琐的工作中解放出来,聚焦核心的架构设计和创新。
按照上面的步骤,一步步操作,就能顺利安装并使用 Claude Code。如果在安装过程中遇到其他问题,欢迎在评论区留言,一起交流解决~
祝大家都能借助 Claude Code,提升编程效率,少踩坑、多产出,解锁 AI 编程新姿势 🚀