Claude Code 安装使用快速极简教程

谢正元
0 阅读7分钟

Claude Code 安装使用完整教程

在AI辅助编程成为主流的当下，Claude Code 作为一款高效的命令行式AI编程工具，能够帮助开发者快速分析项目、优化代码、切换模型，大幅提升编码效率。本文将从环境准备、工具安装、模型配置到实际使用，一步步带你上手 Claude Code，全程附详细步骤和注意事项，新手也能轻松搞定。

一、前置准备：安装 Node.js

Claude Code 基于 Node.js 生态构建，因此在安装工具前，需先确保本地环境已部署 Node.js，且版本符合要求。

1.1 版本要求

推荐安装 Node.js 18.0 及以上版本，优先选择 LTS 版（长期支持版），其稳定性和兼容性更优，适合日常开发使用。Node.js 的 LTS 版为偶数版本（如18.x、20.x、22.x），拥有至少30个月的维护期，可有效避免版本兼容问题。

1.2 安装步骤

  1. 访问 Node.js 官方网站，根据自身操作系统（Windows、Mac、Linux）选择对应的 LTS 版本安装包，点击下载后按照默认引导完成安装（无需额外修改配置）。
  2. 安装完成后，验证是否安装成功：打开命令提示符（Windows）或终端（Mac/Linux），输入以下命令并回车： node --version
  3. 若终端输出类似 v18.17.0 的版本号，说明 Node.js 安装成功；若提示“命令不存在”，需检查安装路径是否添加到系统环境变量中（Windows 可重启命令提示符，Mac/Linux 可执行 source ~/.bash_profile 刷新环境变量）。

补充说明：若需切换 Node.js 版本，可使用 nvm 工具（Windows 推荐 nvm-windows），具体安装和使用方法可参考 Node.js 官方文档或相关教程。

二、全局安装 Claude Code

Node.js 验证通过后，即可通过 npm（Node.js 自带的包管理工具）全局安装 Claude Code，步骤如下：

  1. 保持命令提示符/终端处于打开状态，输入以下全局安装命令，回车后等待安装完成（安装速度取决于网络环境，耐心等待即可）： npm install -g @anthropic-ai/claude-code
  2. 安装完成后，可输入以下命令验证安装是否成功： claude --version
  3. 若输出类似 2.1.12 (Claude Code) 的版本信息，说明 Claude Code 安装成功；若提示“命令不存在”，可重启命令提示符/终端后再次尝试。

三、模型选择与配置（关键步骤）

Claude Code 支持多种 AI 模型，本文优先推荐智谱免费模型（无需付费，适合新手体验），同时也支持其他模型，配置后可自由切换。

3.1 智谱模型注册与 Token 获取

  1. 访问智谱模型官方配置文档：docs.bigmodel.cn/cn/guide/de…。
  2. 按照文档指引，完成智谱账号注册、登录，然后创建 API Key（即后续需要用到的 Token），创建后复制 Token 并妥善保存（后续配置需用到，请勿泄露）。

补充说明：若不想使用智谱模型，可选择其他支持的模型，只需在后续配置文件中修改对应地址和 Token 即可。

智普.png

智谱2.png

3.2 配置 settings.json 文件

settings.json 是 Claude Code 的核心配置文件，用于设置模型地址、Token、超时时间等参数，后续更换模型也需在此文件中修改。

  1. 找到配置文件路径：

    1. Windows 系统：默认路径为C:\Users\你的用户名.claude（将“你的用户名”替换为自己电脑的用户名，例如用户名为82737，则路径为 C:\Users\82737.claude）。
    2. Mac 系统：路径为 ~/Library/Application Support/.claude 或 ~/.claude。
    3. Linux 系统：路径为~/.claude。

  2. 创建配置文件：若 .claude 文件夹中没有 settings.json 文件，手动新建一个名为 settings.json 的文件（注意文件名和后缀不可错）。

  3. 编辑配置内容：打开 settings.json 文件，复制以下代码粘贴进去，然后将 ANTHROPIC_AUTH_TOKEN 后面的空字符串替换为你获取到的智谱 Token： { `` "env": { `` "ANTHROPIC_AUTH_TOKEN": "你的智谱Token",// 替换为自己的Token `` "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",// 智谱模型接口地址 `` "API_TIMEOUT_MS": "3000000",// 接口超时时间（单位：毫秒），无需修改 `` "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1// 禁用非必要流量，无需修改 `` } ``}

  4. 补充配置（可选）：为避免启动时报错“Unable to connect to Anthropic services”，可在 .claude文件夹中再新建一个 .claude.json 文件，粘贴以下内容： { `` "hasCompletedOnboarding": true ``}

配置完成后，保存文件即可，后续若需更换模型，只需修改 ANTHROPIC_BASE_URL（模型接口地址）和 ANTHROPIC_AUTH_TOKEN（对应模型的 Token）。

四、启动 Claude Code 并使用

4.1 启动工具

  1. 打开命令提示符/终端，切换到你需要操作的项目目录（例如项目在 D:\my-project，Windows 可输入 cd D:\my-project，Mac/Linux 可输入 cd ~/my-project）。
  2. 在项目目录下，输入以下命令并回车，启动 Claude Code： claude
  3. 启动成功后，会看到 Claude Code 的欢迎界面，确认界面正常显示即说明配置无误，可以开始使用。

启动1.png

代码1.png

4.2 模式切换（shift+tab）

Claude Code 提供三种核心模式，可通过 shift + tab 组合键快速切换，适配不同使用场景：

  1. 默认模式：需手动确认每一步操作，安全性最高，适合新手使用，可避免误改代码。
  2. 自动模式：效率优先，无需手动确认，工具会自动执行分析、修改等操作，适合熟悉工具的开发者，可大幅提升编码效率。
  3. 规划模式：仅对项目进行分析、生成优化建议，不会修改任何代码，适合只想获取编码思路、不想改动现有代码的场景。

4.3 核心命令详解

在 Claude Code 界面中，输入以下命令并回车，可实现对应功能，熟练掌握这些命令能进一步提升使用效率：

  • /init：初始化项目，工具会自动读取项目文件、分析项目结构，并生成一份详细的项目分析 md 文件，方便快速了解项目全貌。
  • /model：打开模型选择界面，可在已配置的模型中快速切换，无需修改 settings.json 文件。
  • /theme：切换工具界面主题（如深色、浅色模式），可根据个人使用习惯选择，提升视觉体验。
  • /clear：清除当前对话上下文，减少 Token 消耗，避免因上下文过多导致的模型响应缓慢或费用增加（若使用付费模型，此命令可有效控制成本）。
  • /cost：查看当前 Token 消耗情况，清晰了解模型使用成本（免费模型可忽略此命令，付费模型建议定期查看）。

补充技巧：除上述核心命令外，Claude Code 还支持 /read（读取指定文件）、/edit（修改指定文件）等进阶命令，可根据需求逐步探索使用。

876095a4-1c1b-4316-b899-8fd5a3f65872.png

五、常见问题与注意事项

  • 安装失败：若提示“npm 命令不存在”，需重新检查 Node.js 安装是否成功，确保环境变量配置正确；若安装速度过慢，可切换 npm 镜像源（如淘宝镜像）后再尝试安装。
  • 启动报错：若提示“无法连接到模型接口”，检查 settings.json 文件中的 Token 和接口地址是否正确，同时确认智谱账号已正常登录，Token 未过期。
  • 模型切换：后续更换模型时，只需修改 settings.json 中的 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，保存后重启 Claude Code 即可生效。
  • Token 安全：请勿将自己的模型 Token 泄露给他人，避免被恶意使用，导致不必要的损失。

六、总结与后续更新

本文已覆盖 Claude Code 从环境准备到实际使用的全流程，包括 Node.js 安装、工具安装、智谱模型配置、模式切换和核心命令使用，新手按照步骤操作即可顺利上手。

Claude Code 的功能仍在持续更新，后续会逐步补充更多进阶使用技巧、模型适配方法和问题解决方案，欢迎大家关注，获取最新使用指南。如果在使用过程中遇到其他问题，可在评论区留言，一起交流解决！

avatar
文章
阅读
粉丝