Claude Code 完整安装与使用攻略Windows Linux先说结论如果你日常工作要频繁改代码、查日志、写脚本、部署服务Claude Code 是现阶段值得认真上手的一款终端 AI 编程工具。它不是那种套壳的聊天窗口而是直接跑在终端里的 agent 式助手能读你的项目目录、改文件、执行命令、跑测试然后告诉你它改了什么、为什么改。这篇文章我会把 Windows 和 Linux 两套环境下的安装、登录、日常使用、常见坑都捋一遍有命令行基础的人照着做基本一次过完全没有经验的小白也能按步骤抄作业。我在自己主力机和两台服务器上都装了 Claude Code实际用下来的体感是它更适合“有明确任务的代码工作”比如修复一个报错、给某个模块补单元测试、批量重命名、写一个一次性脚本而不是泛泛地陪你聊架构。下面所有内容都是我装过、踩过、调过之后沉淀下来的尽量少废话。1. Claude Code 是什么先搞清楚它和普通 AI 对话的区别很多人第一次打开终端输claude之后会下意识把它当成 ChatGPT 的终端版。但其实 Claude Code 的本质是一个“能真正动你代码”的代理型工具。它可以递归阅读项目文件理解代码结构和依赖关系按照你的指令直接修改源码、新增文件、删除冗余在终端里执行 shell 命令比如跑脚本、装依赖、执行测试通过 git diff 查看改动自己发现错误并迭代修复支持多文件同时编辑适合跨模块的重构任务。和你在网页对话框里复制粘贴代码相比Claude Code 最大的优势是“上下文就在项目里”。它知道你的package.json、requirements.txt、tsconfig.json里写了什么你只需要一句“帮我找到所有没用的 import 并清理掉”剩下的它会自己定位、改代码、再跑一遍检查。适合使用它的人有三类一是日常开发主力是终端的工程师二是需要维护多台 Linux 服务器的运维三是在 VSCode 里写代码但觉得 AI 插件经常给不到点上的人。不适合的人也有完全没接触过命令行、连cd和ls都不太熟的新手建议先在终端里待一周再上这个工具。我个人的观点是Claude Code 的定位不是“第二大脑”而是“可以无限次免费使唤的初级工程师”。你给它明确的任务、清晰的验收标准它完成度相当能打你让它做模糊的架构决策它反而容易一本正经地跑偏。记住这个前提后面所有使用方法都顺了。2. 安装前准备系统、Node、账号一个都不能少在真正执行安装命令之前建议先花十分钟把环境捋一遍能省掉后面一大半报错。2.1 系统要求和终端选择官方对系统的要求并不高Windows 10/11 64 位、Ubuntu 22.04 及以上、Debian 12、CentOS 7 都能跑。我这里说的“能跑”是指能正常启动和对话实际体验则受两个因素影响一是内存开发机建议至少 16G8G 机器我也试过能跑但处理大型项目时会明显变慢二是终端程序Windows 上强烈建议装 Windows Terminal配合 PowerShell 7 或 Git Bash 使用老的 conhost 窗口在渲染和处理 Unicode 上都会有不少毛病。Linux 下就宽松很多Ubuntu 默认的 GNOME Terminal、KDE 的 Konsole、或者直接用 tmux 跑都没问题。我个人在服务器上习惯先用tmux挂一个会话再启动 Claude Code这样即使 SSH 断开了任务也还在跑这个习惯强烈推荐给所有经常远程操作的人。2.2 Node.js 版本是最容易忽略的硬门槛Claude Code 本体是一个 npm 包所以 Node.js 是绕不开的运行时。版本要求 Node 18.0.0 以上但这里有个容易踩的坑如果你用的是 Node 18 的早期小版本有些新 API 可能不全官方在启动时甚至会直接报错。我建议直接装 Node 20 LTS 或更新版本的 LTS省心。检查 Node 版本的方法很简单终端里输入node -v npm -v如果输出类似v20.11.0和10.2.4说明环境没问题。如果提示找不到命令那就说明 Node 根本没装往后看对应的安装章节。2.3 账号和订阅这件事提前想清楚启动 Claude Code 必须通过 Claude 账号认证。目前支持的账号方式分两类一类是 Claude 官网的订阅账号Pro 或 Max 套餐另一类是 Anthropic API 的密钥方式两种在 Claude Code 里都能用。如果你是个人开发者直接用官网订阅登录是最省事的如果你是团队或企业环境看你们是统一采购了 API 还是走订阅账号。这里给一个我踩过的坑有些网友在团队电脑上装完后登录时跳出来一句Your organization has disabled claude subscription access for claude code以为自己账号出问题了。实际上这大概率不是你个人账号的问题而是你们公司把 Claude 的订阅统一托管在企业组织下管理员在后台关闭了 Claude Code 的权限。你只需要拿个人订阅的账号登录或者让管理员重新开启权限即可和你的安装过程无关。2.4 准备一个干净的工作目录安装前建议先建一个目录来测试不要在系统盘根目录或权限受限的目录里跑。Windows 上我习惯单独建一个C:\dev\testLinux 下就用~/test。原因很简单Claude Code 在第一次启动时会尝试在当前目录创建配置文件比如.claude目录如果目录权限不对或路径含有特殊字符后面会出现各种莫名其妙的问题。3. Windows 下完整安装流程从零到能跑Windows 稍微麻烦一点但跟着下面四步走完基本不会有问题。3.1 安装 Node.js推荐 winget 或者直接下载安装包Windows 上装 Node.js 最简单的办法是用官方安装包去 nodejs.org 下载 LTS 版本一路下一步即可。如果你系统是 Windows 10 1709 以上也可以直接用命令行装速度快且方便后续卸载winget install OpenJS.NodeJS.LTS装完一定要新开一个终端窗口再执行node -v因为旧窗口的环境变量不会自动刷新。这是我反复提醒别人的点很多人装完说“node 找不到”其实就是没重开终端。3.2 用 npm 全局安装 Claude Code确认 Node 可用后直接执行npm install -g anthropic-ai/claude-code这里要解释一下为什么要加-g全局安装。全局安装会把claude命令放在 npm 的全局 bin 目录里这样你在任何一个目录下打开终端都能直接运行不用每次都在特定项目里找命令。如果你不加-g它会装到当前目录的node_modules里命令行里根本调用不到等于白装。如果安装过程很慢或者卡住很可能是默认 npm 源的问题。可以临时切换 npm 源来加速比如使用国内常用的 npmmirror 镜像npm config set registry https://registry.npmmirror.com装完可以验证一下版本claude --version正常会输出类似1.0.x的版本号。如果提示“claude 不是内部或外部命令”说明 npm 的全局目录没有加到系统 PATH。解决方法是先执行npm config get prefix看全局目录路径再把这个路径加到系统环境变量 Path 里然后新开终端重试。3.3 首次登录认证浏览器验证安装成功后在项目目录下输入claude首次运行会提示登录。它会生成一个一次性验证码并自动打开浏览器跳到 Claude 官网的授权页面。你在页面里登录你的 Claude 账号然后粘贴验证码授权终端里就会出现欢迎信息同时会询问你是否允许 Claude Code 在你的终端里执行命令。这一步建议直接选允许否则后面让它跑命令时每次都要确认体验大打折扣。这里有第二个容易踩的坑如果你在浏览器登录时点了“使用 Google 登录”或其他第三方登录方式授权页可能要求你再做一次账号确认反复几次后终端会提示“等待授权超时”。解决办法是直接重新在终端运行claude触发重新登录在浏览器里尽量保持同一个登录会话不要中途切账号。3.4 VSCode 里接入 Claude Code让插件成为你的出入口很多人的日常开发其实都在 VSCode 里那就会用到vscode配置claude code这个场景。在 VSCode 扩展市场里搜 “Claude Code”装好 Anthropic 官方插件之后它会在编辑器底部给你一个输入框效果类似把 Claude Code 终端嵌入到编辑器里。你可以直接选一段代码然后让 Claude 解释、重构、补测试它会在终端面板里执行真正的 Claude Code 进程。我实测下来插件最实用的两个点一是选中代码后右键菜单里直接有“Ask Claude Code”相关动作省去手动复制粘贴二是它继承了 VSCode 的 Diff 视图Claude 改完文件后你能直接在编辑器里审查改动比纯终端里看 diff 舒服很多。配置上不需要做什么复杂操作插件会自动查找你全局安装的 claude 命令。唯一需要注意的是如果插件报“找不到 Claude Code”你需要确保claude确实已经在命令行里可用然后重启 VSCode。4. Linux 下完整安装流程覆盖新版发行版和旧版Linux 的安装过程比 Windows 干净但权限和发行版差异是主要变量。4.1 两种方式安装 Node.jsnvm 最灵活Linux 下安装 Node 我很推荐用 nvmNode Version Manager它最大的优势是不污染系统目录而且随时可以切 Node 版本。装完 nvm 之后执行nvm install 20 nvm use 20 node -v如果你的网络环境访问 GitHub 上的 nvm 脚本很慢这里只说脚本下载也可以直接从 nodejs.org 下载预编译的二进制包解压到自己家目录的~/node里再把~/node/bin加入 PATH。这种方式绕开包管理器适合那些系统源里 Node 版本太老的发行版。如果用的是 Ubuntu 或 Debian用 apt 安装也很方便只是版本可能不是最新的。我个人不推荐直接用 apt 装 Node原因是 apt 源里的 Node 往往是旧版本比如在 Ubuntu 22.04 里默认的 Node 只有 12而 Claude Code 要求 18 以上你后面还得折腾升级。nvm 全程不需要 sudo省权问题这是我最推荐它的原因。4.2 全局安装并处理 PATH 问题Node 就绪后执行和 Windows 一样的命令npm install -g anthropic-ai/claude-code claude --version如果全局安装时遇到EACCES权限报错说明 npm 全局目录是系统目录比如/usr/lib/node_modules普通用户没写权限。最省事的解决方法是安装 nvm 之后用 nvm 自带的 npm 装这会自动装到当前用户目录如果你不想换成 nvm也可以手动修改 npm 的 prefix 到用户目录但比较绕还是建议直接上 nvm。切换用户登录时如果提示找不到 claude 命令多半是 nvm 的 PATH 只对当前 shell 生效了没有写入到~/.bashrc或~/.zshrc。我用 zsh 的时候踩过这个坑后来在~/.zshrc里加了一行export PATH$HOME/.nvm/versions/node/v20.11.0/bin:$PATH才一劳永逸。4.3 服务器远程使用tmux 和权限在 Linux 服务器上装完 Claude Code 之后有一个场景很典型你通过 SSH 登录服务器让 Claude Code 帮忙维护一个常驻服务或改配置文件结果一断网任务就没了。解决办法就是第 2 节提到的 tmux。启动方式很简单tmux new -s claude claude下次 SSH 进来执行tmux attach -t claude就能回到原来的会话。另外Claude Code 在执行命令时会以你当前的用户身份运行所以如果你让它改/etc/nginx/nginx.conf这类需要 root 权限的文件它大概率会提示权限不够。这时候不建议直接 root 跑 claude更安全的做法是你先用sudo处理好权限或在本用户有权限的路径下操作它。5. 日常使用核心命令、工作流、配置一个比一个有用安装只是第一步真正拉开效率差距的是怎么用。5.1 最常用的命令速查命令作用备注claude开始新的一次会话最常用claude --resume恢复最近的会话适合重新接上昨天的活claude --continue让上次任务继续做自动继承上下文claude --print 需求非交互式一次性输出适合脚本里调用claude --model sonnet指定模型按需切换速度/质量/clear清空当前会话上下文聊天聊杂了就用/compact压缩会话历史长对话不丢上下文/init根据项目生成 CLAUDE.md适合项目交接我在实际使用中最常用的是--resume。因为 Claude Code 的会话上下文会保留哪怕你关机重启了第二天回来claude --resume还能接着上次的进度谈不用重新解释背景。这和传统 chat 工具完全不一样越用越觉得这是一个被低估的功能。5.2 一个真实的实操案例让它改一个日志脚本下面我用一个实例来演示工作流。假设我有个 Python 脚本parse_log.py功能是读 Nginx 日志统计 UV但代码写得比较乱我想让它重构。我直接在终端输入claude然后对话里写帮我重构 parse_log.py目标 1. 从命令行参数接收日志文件路径 2. 统计每个 IP 的出现次数并排序输出 3. 保留原来的正则匹配逻辑但把硬编码路径改成参数 4. 写完后用我给的测试日志跑一遍。Claude Code 会先读取文件内容分析结构然后一边改一边在终端里输出它正在做什么。过程中它可能会主动问我一两个问题比如输出格式要不要带时间范围我回答“按昨天的日志格式即可”。改完后它会在终端展示 diff并自己执行python3 parse_log.py test.log验证结果。这个流程里有几点体验值得说它不需要我把整个文件复制粘贴进去因为它自己读了文件它真实执行了命令所以能验证自己的改动对不对如果测试失败它会根据错误信息再改一轮。我全程只动了嘴没有碰任何一个字符。5.3 接入第三方模型DeepSeek 和本地模型Claude Code 默认走 Anthropic 的服务但很多人有“接入 DeepSeek 或调用本地模型”的需求这个也是可以做到的原理是通过环境变量覆盖 API 地址。接入 DeepSeek在启动前设置两个环境变量export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN你的_DeepSeek_API_Key claude设置之后Claude Code 发起的请求会走 DeepSeek 的 Anthropic 兼容接口。这样你在界面上看到的还是原来的操作方式但底层模型已经换成 DeepSeek 了。这个方案比较适合没有 Claude 订阅但买了 DeepSeek API 的人。如果你不想花钱调用云端 API还可以用 LM Studio 跑本地模型。先启动 LM Studio 的本地服务器默认端口 1234然后设置export ANTHROPIC_BASE_URLhttp://localhost:1234/v1 export ANTHROPIC_AUTH_TOKENlm-studio claude本地模型的好处是隐私性高、离网可用但效果和速度取决于你的显卡。我用一个 7B 参数的量化模型试过日常改改简单脚本没问题但让它做复杂重构就明显力不从心所以这个方案定位是“本地兜底”主力任务还是建议云端模型。6. 常见问题排查实录都是我自己碰过的网上各种报错贴子很多这里挑几个高频的和 Clude Code 强相关的附上排查思路。6.1 登录报“Your organization has disabled claude subscription access for claude code”这个问题在前文提到过再展开说一下排查思路。先搞清楚你是用什么方式登录的如果你用的是公司统一订阅这个提示几乎可以确定是组织管理员在 Claude 的后台里关闭了 Claude Code 的访问开关你自己改不了只能联系管理员。如果你用的是个人订阅但浏览器里保存的是公司账号建议退出所有账号重新用个人账号登录一次。这个报错和你的安装命令、Node 版本、系统环境都没有关系不要浪费时间重装。6.2 Windows 下claude命令闪退或直接关闭窗口我遇到过一次很典型的场景在 PowerShell 里输入claude窗口闪了一下就退了也没有任何报错输出。排查后发现问题出在 Windows Terminal 的启动目录不存在或者说当前工作目录被删掉了。解决办法是手动先cd到一个真实存在的目录再执行claude。另一个常见原因是老版本的 PowerShell5.1对某些 ANSI 转义序列处理不好建议用 PowerShell 7 或者 Git Bash 测试。6.3 npm 装包失败或超时如果你用的是默认 npm 源在某些环境下装大包超时很常见。我一般用两个手段第一临时切换镜像源装完再切回官方第二升级 npmnpm install -g npmlatest老版本 npm 的网络处理确实容易出问题。注意换镜像源只影响包的下载地址不会影响 Claude Code 本身的登录和请求服务。6.4 Node 版本过低如果你装完后启动报You are using Node.js 16.x.x之类的提示说明 Node 版本不满足要求。Windows 上直接去官网下新的 LTS 覆盖安装Linux 上用 nvm 切换到新版本这一步没什么技术含量但经常被忽略。6.5 Linux 下无法执行某些命令Claude Code 执行命令时用的是当前 shell有时候会遇到它执行git或docker时提示找不到命令但你自己在终端里运行却是好的。这通常是因为它没有加载你.bashrc里的 PATH。解决办法是在运行 claude 之前确认echo $PATH里包含这些命令的路径。7. 我踩过几次坑之后的一些建议最后分享几点自己的体会不一定对所有人适用但对我自己来说改掉了之后效率提升很明显。第一给 Claude Code 任务时一定要说清楚“完成标准”。比如“重构完帮我跑一下测试保证所有测试通过”这样它就不会给你一个改了但没验证的结果。第二项目根目录下创建一个CLAUDE.md文件把项目的架构说明、编码规范、常用命令写进去Claude Code 启动时会自动读取它后续所有对话质量都会有明显提升相当于给 AI 一个入职培训。这个文件用/init命令可以直接生成初步版本再自己补充完善。第三不要把什么都丢给它。日志特别大、二进制文件、依赖目录这些它读起来很慢甚至可以把它卡死。最好在.claudeignore文件里把node_modules、.git、dist之类的目录排除掉。我个人目前的习惯是一周里至少有三四天会把 Claude Code 挂在终端里写脚本、改配置、调 bug 都让它先上手我只负责最后审阅和验收。遇到它反复修不好的问题也不硬刚通常是自己先看看报错提炼一下核心信息再丢回去往往第二次就过了。这工具不是万能的但在合适的场景里它的确让我的工作节奏比之前轻松了不少。