Claude Code零基础安装教程

01 环境准备

Claude Code 运行依赖两大基础工具：

1. Node.js（核心运行环境）

所有指令、模型调用、程序运行均依托Node.js，优先选择稳定版本，杜绝兼容问题。

1. 官网下载：https://nodejs.org/

2. 选择 LTS 长期稳定版（v18.0.0及以上）

3. 安装全程默认下一步，务必勾选 Add to PATH 自动写入环境变量

2. Git（项目读写必备工具）

用于项目文件识别、版本关联、批量文件操作，不同系统安装指令不同：

Windows：进入 git-scm.com 下载安装包，默认安装即可
Mac：终端执行 xcode-select --install 或 brew install git
Linux：终端执行 sudo apt install git

3. 环境校验

安装完成后，关闭所有旧终端，重新打开终端执行以下命令，全部输出版本号即为环境就绪：

node -vnpm -vgit --version

02 Claude Code安装

方案一：官方NPM安装

标准全局安装，稳定无冗余，适合绝大多数开发者：

npm install -g @anthropic-ai/claude-code

-g 代表全局安装，任意目录可调用指令
无红色报错、进度走完提示 success 即为安装成功

安装校验：终端输入命令，正常输出版本号即部署完成。

claude --versionclaude-code --version

方案二：VS Code插件安装

1. 安装VS Code编辑器并打开；

2. 插件市场搜索「Claude Code」官方插件；

3. 安装后重启VS Code，侧边栏出现Claude Code图标即可使用。

03 国产大模型

Claude官方模型存在付费、网络限制，如果只是想体验一下的话，可以使用一些免费国产大模型，有百万级免费额度、国内直连、延迟极低，不过大模型的能力比原生模型要差一些。

1. 免费模型推荐

阿里百炼 Qwen3-Coder

阿里云官方出品，代码生成、纠错、项目重构能力顶尖，免费额度充足，适配绝大多数编程场景，稳定性拉满。

DeepSeek Coder

专注代码领域，算法调试、复杂逻辑编写表现优异，适合深度开发场景。

智谱 GLM-4.7

日常编程性价比极高，适配简单开发、文案生成、代码排查，新手零门槛。

2. 免费API密钥获取步骤（以阿里百炼为例）

1. 登录阿里云百炼控制台：https://bailian.console.aliyun.com

2. 开通模型服务，进入「API-KEY管理」；

3. 一键创建密钥，复制保存备用（自动生效免费额度）。

3. 两种配置方式

方式1：配置文件

settings.json文件放置目录：

- Windows：C:\Users\你的用户名\.claude\

- Mac / Linux：~/.claude/

阿里百炼完整配置模板：

{"defaultModel": "qwen3-coder-plus","theme": "default","logLevel": "warn","autoComplete": true,"language": "zh-CN","env": {"ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/compatible-mode/v1","ANTHROPIC_API_KEY": "你的阿里百炼API-KEY","ANTHROPIC_MODEL": "qwen3-coder-plus"  }}

方式2：系统环境变量配置

适配智谱GLM-4.7，全局生效，切换灵活：

Windows：

ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"ANTHROPIC_AUTH_TOKEN="你的智谱API-KEY"ANTHROPIC_MODEL="GLM-4.7"

Mac/Linux终端执行：

export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropicexport ANTHROPIC_AUTH_TOKEN=你的API-KEYexport ANTHROPIC_MODEL=GLM-4.7

4. 配置生效规则

1. 替换密钥/配置环境变量后，彻底关闭所有终端重新打开；

2. 输入 claude 启动程序，对话测试正常应答即为配置成功；

3. 切换模型仅需替换接口地址、模型名、密钥，无需重装软件。

04 启动和测试

安装+配置全部完成后，执行简单测试，确保读写、对话功能正常。

1. 启动程序

claude

2. 核心功能测试

基础对话：输入指令让AI生成代码，正常应答即为正常。
文件读取：使用 @文件名 读取本地文件，验证读写权限。
上下文添加：输入/add 文件名 将文件加入AI上下文。

3. 退出会话

输入 /exit 或按下 Ctrl+C 即可退出终端会话。

05 新手高频报错合集

报错1：npm 不是内部或外部命令

原因：Node.js未安装、未写入环境变量、安装后未重启终端。

解决：重装Node.js并勾选Add to PATH，关闭所有终端重启重试。

报错2：claude 命令未找到

原因：NPM全局路径未加入系统环境变量。

解决：执行 npm config get prefix，将输出路径手动添加到PATH，重启终端。

报错3：Mac/Linux权限不足（permission denied）

解决：临时提权安装。

sudo npm install -g @anthropic-ai/claude-code

报错4：安装超时、network timeout

解决：清空缓存后重试，国内用户切换国产模型。

npm cache clean -fnpm install -g @anthropic-ai/claude-code

报错5：浏览器授权空白、无法唤起窗口

解决：放弃网页授权，改用API密钥登录，或直接使用国产模型。

报错6：启动崩溃、版本不兼容

解决：卸载现有Node版本，重装 18.x/20.x LTS稳定版。

报错7：API Key无效、模型调用失败

原因：密钥含空格、接口与模型不匹配、密钥过期。

解决：清理密钥空格，核对对应模型接口地址，重新生成密钥配置，重启终端。

报错8：版本冲突、重复安装报错

解决：卸载旧版本后全新安装。

npm uninstall -g @anthropic-ai/claude-codenpm install -g @anthropic-ai/claude-code

06 写在最后

很多开发者，尤其是AI编程新手，都会犹豫要不要深入学习Claude Code，可能是担心需要特殊网络、付费成本高。

但其实完全不用纠结，Claude Code 搭配国产免费模型可以在一定程度上还原原生模型的编程实战效果。

对于国内AI新手开发者而言，这是最友好的试错方式：无网络限制、无需海外账号、无需付费、零成本零基础上手。

大家可以先免费体验、熟练掌握各类实操用法，感受Agent编程的强大效率，积累一定使用经验后，再根据自身需求考虑是否升级官方模型、效赋能日常开发、项目迭代与代码优化。

如果本文对你有帮助的话，别忘记点赞、在看、转发！