ClaudeCode入门指南从安装到跑通的完整步骤

做不同AI编程工具横向对比时可以在leadhi.cn这类聚合平台上快速切换体验。

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

最近搜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。关闭终端重新打开后输入claude测试。如果仍找不到命令，手动将安装路径添加到shell配置文件并执行source使其生效。

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

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

这是最容易卡住的一步。

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

第一条路：使用国内大模型厂商的兼容API。 多家国内厂商已支持Anthropic API兼容接口，让你用更低的价格、更稳定的网络使用Claude Code。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写得好不好、工作流理得顺不顺。模型会不断被替代但好的使用习惯是更持久的竞争力。