老实说第一次看到 ClaudeCode 这个词的时候我以为是某个 VS Code 插件名。直到同事在终端里敲了一个claude唰一下拉出命令行对话界面我才反应过来这东西不走 IDE它直接住在你的终端里。作为 Anthropic 官方的命令行编程智能体ClaudeCode 能读取整个 Git 仓库用自然语言帮你改代码、跑测试、查报错、提 Pull Request跟 OpenAI 的 Codex CLI 属于同一条赛道。这篇教程不绕弯子Windows、Mac、Linux 三条安装路线各跑一遍把 Node 环境坑、Homebrew 安装失败、服务器上没有浏览器怎么登录这类实际问题一次说清适合所有想在本地或远程开发机上真正用起来的人直接照抄。1. 装之前先搞清楚三件事它不是 IDE 插件而是你终端里的结对编程搭档1.1 ClaudeCode 到底是什么为什么要在终端里做这种事很多人跟我一开始一样默认把 ClaudeCode 归类成编辑器插件其实它的核心是一个可执行文件claude本质是跑在终端里的 AI 代理Agent。启动之后有两种工作方式直接敲claude进入交互式对话界面在里面来回沟通或者用claude -c 把 src/utils.ts 里的越界错误修掉这种单次执行模式让它自主处理完一个任务再结束。它不只是聊天框。ClaudeCode 会自己分析项目结构读相关文件规划修改方案调用内置编辑工具改代码还能帮你运行测试命令、看输出、根据报错继续修最后给你一份可审查的 diff。这意味着你可以让它处理跨文件的重构而不是一问一答地复制粘贴代码。为什么不把它做成 IDE 插件因为终端才是所有开发者的最小公分母。你用 VS Code、PyCharm、Neovim 还是纯 SSH 进服务器只要有 shell 就能跑 ClaudeCode不需要绑定任何编辑器。这一点在多人协作和远程开发场景里非常实用也是我最终愿意花时间把三个平台都装一遍的原因。1.2 安装前的基础检查清单动手前先把这几项检查完能省掉后面 80% 的报错。Node.js 环境ClaudeCode 通过 npm 分发底层跑在 Node 上。要求 Node.js 18 及以上建议直接用 20 LTS 或更高版本。检查命令是node -v和npm -v如果提示找不到命令说明还没装 Node。终端工具Windows 上强烈建议装 Windows Terminal微软商店免费默认 PowerShell 或 CMD 也能用但体验和字体渲染差一截macOS 用自带 Terminal 或 iTerm2 都行Linux 端 bash 或 zsh 随意。账号凭证需要一个 Anthropic 账号或 API Key。之后本地开发机走浏览器授权登录服务器上走 API Key我们会在第 5 节详细展开。磁盘空间安装包只有几十 MB加上缓存和配置也占不了多少不用提前清理磁盘。npm 镜像状态npm 官方源在部分地区访问速度不稳定如果安装时卡在ETIMEDOUT可以先切换到 npmmirror淘宝 npm 镜像再装后面章节有具体命令。有一句忠告放在最前面不要用 sudo 或者管理员权限去全局安装 npm 包。有些教程图省事让你sudo npm install -g结果 npm 全局目录的归属权变成 root后续更新、卸