张昕宇梁红聊一聊 Claude Code 的基本操作。这个工具最近在开发者圈子里热度很高，它是 Anthropic 官方推出的 AI 编程助手，不是简单的聊天窗口，而是一个跑在终端里的智能体。你可以让它读整个项目、分析代码、改文件、跑测试、甚至帮你提交 Git commit，它会自己拆解任务、逐步执行，遇到可能影响项目的操作会停下来等你确认。这篇文章拖了挺久才写，因为网上的资料大多是"安装教程"或者"某某功能推荐"，真正讲清楚装完之后怎么配置、怎么接入 DeepSeek 这类第三方模型、怎么处理报错的内容很少。我把从零安装到日常使用过程中遇到的典型问题都整理了一遍，适合刚听说 Claude Code 想上手的开发者，也适合已经装好但用不起来、或者想接更经济的模型服务的人。
1. 先分清三副面孔：CLI、VS Code 插件、桌面版
这是我在评论区看到被问得最多的问题。Claude Code 不是一个单一入口，它有三种形态，很多人一开始就卡在"我到底该装哪个"上面。
| 形态 | 入口 | 本质 | 适合场景 |
|---|---|---|---|
| 命令行工具 | 终端运行 claude |
Node.js 编写的终端智能体 | 最核心形态，任何系统都能用 |
| VS Code 插件 | 编辑器侧边栏面板 | 基于 CLI 同源引擎前端 | 写代码时看 diff、选中代码提问 |
| 桌面版 | 独立图形应用 | 带界面的客户端 | 不习惯命令行的用户、快速问问题 |
CLI 是根基，所有能力都从它这里长出来。你在项目目录下敲 claude，它就会启动一个会话，能读取当前目录的文件结构，也可以向上访问父目录内容。会话过程中它会自己规划步骤：先看哪些文件、改哪几行、跑什么命令验证，每一步都带上下文。这和传统聊天机器人最大的区别是，它有"行动能力"，而且行动前会征求你的同意。
VS Code 插件本质上就是把 CLI 的能力搬进编辑器，好处是能直接选中一段代码提问，比如"这段函数有没有并发问题"，修改结果会以 diff 形式逐块展示，你可以单独接受或拒绝某个改动。日常写代码时，插件比切回终端方便不少。
桌面版更像一个图形化壳子，界面上可以选项目文件夹，然后在对话框里描述需求。它适合快速看项目概况、做代码评审式提问，但对复杂工程的控制力不如 CLI。我的建议是：先装 CLI 把基础操作跑通，日常写代码再装 VS Code 插件，桌面版看个人习惯。三者共用同一套认证和配置，学会了 CLI 的配置，另外两个基本不用额外折腾。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装：三端安装步骤与常见失败原因
2.1 装之前先检查环境
Claude Code CLI 依赖 Node.js 运行时，官方要求 Node.js 18 及以上，我实测用 20 以上的版本更稳。装之前先确认版本：
bash复制node -v
npm -v
如果 Node 版本太低，启动时会报莫名其妙的语法错误，或者直接闪退。Windows 用户建议用 Windows Terminal 来跑，系统自带的 cmd 对 UTF-8 支持不好，后面提到的乱码问题也跟终端编码有关。
macOS 和 Linux 用户如果还没装 Node，推荐用 nvm 管理版本，按官网文档装就行。Ubuntu 系统最常见的坑是 npm 全局安装的权限问题，用 nvm 安装 Node 之后，npm 全局目录就在用户目录下了，不需要 sudo，能省掉一堆权限麻烦。
2.2 三端安装步骤
CLI 安装只有一条命令：
bash复制npm install -g @anthropic-ai/claude-code
装完验证版本：
bash复制claude --version
能看到版本号就说明装好了。如果提示 claude 不是内部或外部命令（Windows）或 command not found（macOS/Linux），多半是 npm 全局目录没加进 PATH。Windows 上先跑 npm prefix -g 查看全局目录，再把它加进系统环境变量，然后重开终端。
VS Code 插件直接在扩展市场搜 "Claude Code"，注意认准 Anthropic 官方出品的那个，别装成同名第三方工具。装好后左侧会出现对应图标，打开面板就能用。
桌面