Claude Code这个工具我折腾了有小半年,从最早的命令行版本一路用到现在的桌面版和VS Code插件,中间踩过的坑比官方文档里写出来的多得多。这篇不打算讲那些高大上的底层原理,就聚焦Claude Code的基本操作:怎么安装、怎么配置模型、怎么接入DeepSeek这类第三方服务、怎么配置Skills、以及529报错和乱码这些高频问题怎么排查。不管你刚听说Claude Code,还是已经装好了但卡在“连接模型”这一步,这篇都值得收藏慢慢看。
下面我会按我自己实际操作时“从零到一”的顺序来写,尽量说人话,保证你照着做能跑通。
1. 先搞清楚Claude Code是什么,三种形态怎么选
1.1 Claude Code到底能替你做哪些事
Claude Code是Anthropic推出的AI编程助理,和你在网页上聊天的Claude不同,它直接跑在你本地终端或编辑器里,能读取你项目里的代码、增删改文件、执行终端命令、调用Git、跑测试。你可以把它理解成“一个能动手的助手”,而不只是“一个给建议的顾问”。
它能做的事远不止写代码。我见过有人用它整理数据集、批量改文件名、生成周报、搭PPT框架、做代码审查,甚至帮非技术背景的人写SQL查询。核心逻辑是:你把任务描述清楚,它会在你的项目目录里实际执行操作,然后把改动结果给你看。对开发者来说,它省掉了“复制代码到网页、再粘贴回来”的中间环节,效率提升是很明显的。
适合谁来用?第一类是写代码的工程师,第二类是每天和文件、数据、文档打交道但不想学复杂脚本的人,第三类是刚入门编程、想让AI带着你理解项目的人。门槛不算高,但前提是你得愿意和终端打交道。
1.2 桌面版、CLI、VS Code插件,三者之间的真实差异
Claude Code现在主要有三种形态,我身边人经常搞混,我直接列个表说明:
| 形态 | 安装方式 | 适合场景 | 主要短板 |
|---|---|---|---|
| CLI(命令行) | npm 全局安装 | 终端党、脚本自动化、SSH远程服务器 | 纯文本界面,看代码不够直观 |
| 桌面版 | 官网安装包 | 不习惯命令行的用户、图形化管理文件 | 占内存比CLI高,自动化能力弱一些 |
| VS Code插件 | 扩展市场安装 | 写代码时边写边审、实时改代码 | 依赖CLI,且只在VS Code里生效 |
三者共用同一套登录状态和配置,完全可以同时装,互不冲突。我自己的习惯是:桌面版用来处理长对话和需要可视化看文件变更的任务,CLI用来跑批处理和自动化脚本,VS Code插件则在写代码的时候用作实时审查和补全。
这里有个容易忽略的点:VS Code插件虽然界面友好,但它底层还是要依赖CLI的命令行能力,所以就算你打算只用插件,我建议也先把CLI装好,否则某些功能会报错。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 从零安装Claude Code:Windows、Ubuntu、macOS全流程
2.1 安装前的环境准备
CLI版的核心依赖是Node.js。Anthropic官方要求Node.js 18以上,建议直接装最新的LTS版本,省得后面升级麻烦。装完后在终端跑一下验证:
bash复制node -v
npm -v
两个命令都有输出版本号,说明环境就绪。桌面版不需要Node.js,直接下载安装包就行。VS Code插件则要求你本地已经装了VS Code(这个基本是废话,但确实有人问过)。
另外强烈建议Windows用户把默认终端换成Windows Terminal,而不是继续用老式cmd或者Windows PowerShell的默认窗口。很多后面要讲的乱码问题,其实在终端这一步就能避免一大半。
2.2 CLI安装命令与验证
CLI的安装非常简单,一行命令:
bash复制npm install -g @anthropic-ai/claude-code
安装完成后验证版本号:
bash复制claude --version
能看到版本号就说明安装成功。如果你在Windows的PowerShell里执行命令后报“无法加载脚本”之类的错误,那是因为系统的脚本执行策略默认限制,可以执行下面这条命令放开当前用户的限制:
powershell复制Set-Exe
