最近在AI编程工具的交流群里，大家讨论热度最高的工具是Claude Code。不过我发现一个很有意思的现象：大多数人卡住的地方，不是这个工具能做什么，而是根本不知道怎么装上它。它不像ChatGPT那样打开浏览器就能用，也不像Copilot那样在IDE里装个插件就完事——Claude Code是Anthropic在2025年推出的AI编程Agent，它住在你的终端里，能理解整个代码库，帮你写代码、改Bug、跑测试、管理文件。入口就是终端命令行，没有传统意义上的"网页入口"。

今天就把从零到跑通的完整路径讲清楚。

最高频的问题不是"能干什么"而是"怎么装"

最近搜Claude Code的人越来越多，但卡住的地方出奇一致——不是功能不会用，而是入口找不到。它不像ChatGPT打开浏览器就能用，也不像Copilot在IDE里装个插件就行。

Claude Code是Anthropic在2025年推出的AI编程Agent。它住在你的终端里，能理解整个代码库，帮你写代码、改Bug、跑测试、管理文件。但它的入口就是终端命令行，没有传统意义上的"网页入口"。

先装Claude Code本体

Anthropic官方已经不推荐用npm方式安装了，他们更建议直接用原生客户端。这样不用先装Node.js，而且后台还能自动更新，省心不少。

macOS和Linux用户，在终端里跑一下官方安装脚本就行。当然也可以通过Homebrew来装，但那个版本不会自动更新，需要定期手动升级。

Windows用户呢，在PowerShell里执行官方安装脚本就可以。也可以用WinGet安装。不过有个前置条件得注意：Windows下必须确保已经装好了Git for Windows，Claude Code依赖它来提供兼容环境。

国内用户如果遇到官方脚本下载慢的情况，社区有人维护了国内可用的安装脚本，可以从GitHub获取。

安装完成后，输入claude --version，看到版本号就说明成功了。

配置环境变量PATH

装完之后，要是终端输入claude提示命令找不到，十有八九是PATH没配置好。

macOS和Linux通常安装脚本会自动配置PATH，但保险起见，先关掉终端重新打开再试试。如果还是找不到命令，就需要手动把安装路径加到shell配置文件里，然后执行source让它生效。

Windows用户要找到安装路径——一般是用户目录下的.local/bin，把这个路径添加到系统环境变量的Path中。操作路径：开始菜单搜"环境变量"，编辑系统环境变量，在Path中新建一项即可。

配置API：国内用户最关键的一步

这一步可以说是最容易卡住的地方。

Claude Code首次启动时会连接Anthropic服务器做初始化验证，大陆网络环境下很可能失败。国内用户有两条路可以走。

第一条路：使用国内大模型厂商的兼容API。 目前多家国内厂商已经支持Anthropic API兼容接口，比如DeepSeek、阿里百炼、智谱GLM、豆包等。用这些接口，不仅网络更稳定，价格也往往更低。

第二条路：使用统一中转服务。 如果你同时在用Claude Code、Cursor、Codex等多个工具，统一中转服务比每个工具单独配置省事得多。

配置方式有两种，推荐用配置文件方式。配置文件路径在用户目录下的.claude文件夹中的settings.json。核心需要填写三个字段：API密钥、API基础地址、模型名称。还可以加上请求超时时间和禁用非必要流量的配置。

也可以用环境变量方式临时配置，写入shell配置文件后执行source使其生效。但环境变量方式重启终端后可能失效，配置文件方式更加持久。

配置完成后必须重启终端，否则不会生效。

首次启动：绕过登录检查

这里有个坑需要特别注意：即使是国内API，Claude Code首次运行时还会强行连接官方服务器做一次登录检查，暂时忽略掉自定义API地址。

解决方案是在用户根目录创建一个配置文件，添加跳过新手引导的设置项。macOS和Linux用echo命令写入，Windows在PowerShell中执行对应命令。

保存后重启Claude Code，就能跳过登录检查直接进入交互界面。

进入交互界面后，建议先跑/status确认模型名称和API端点都是你预期的那一个，再开始干活。如果遇到问题，先跑claude doctor，这个内置诊断工具能自动检查环境配置并报告潜在问题。

三个模式搞清楚

启动后底部状态栏会显示当前模式，按Shift + Tab循环切换。

Default模式：每步都要确认，最安全，适合新手。

Auto-Accept模式：文件修改自动执行，适合重复性高的批量工作。

Plan模式：纯只读，不修改任何文件，只做分析和输出方案。复杂任务建议先用这个模式理清思路再执行。

VS Code中也能用

如果不习惯纯终端操作，VS Code有官方扩展。把VS Code更新到最新版，在扩展市场安装Claude Code for VS Code插件。安装后，在VS Code的工作区中可以直接通过图形界面与Claude Code对话。

高频命令速查

几个必须掌握的指令：

/init扫描项目生成CLAUDE.md，新项目第一次用时优先执行。/compact压缩过长对话。/clear清空对话历史，切换任务时必用。/model切换模型。/cost查看token消耗。/status查看当前配置。/resume恢复历史会话。

趋势判断

2026年的AI编程工具已经从尝鲜走向标配。Trae、Cursor、Claude Code、Codex CLI、Windsurf是目前五款主流工具，均支持接入自定义API端点。从配置难度看，Trae最简单，是GUI三步配置；Claude Code依赖环境变量配置，稍复杂但灵活性最高。

当然，入门只是开始。真正决定使用效果的，是CLAUDE.md写得好不好、工作流理得顺不顺。模型会不断被替代，但好的使用习惯是更持久的竞争力。