小白零基础AI教程--Claude Code

01.

Claude Code‌是Anthropic公司推出的‌终端原生AI编程助手‌，是一个能自主完成全流程开发任务的智能编码工具。

它并非简单的代码补全工具，而是可以直接在开发者的终端/IDE环境中运行，理解整个代码库架构，能独立完成需求拆解、代码编写、文件修改、命令执行、测试运行甚至Git提交等全流程开发工作，相当于一个可以直接协作的AI程序员同事‌。

02.

核心特点与能力：

1. ‌终端原生集成‌：直接在终端运行，和CLI工具、IDE无缝衔接，无需来回切换窗口，不打断开发节奏
2. ‌超长上下文支持‌：支持最高‌百万级Token上下文‌，能完整理解整个大型代码库，数万行代码可直接处理
3. ‌全流程自动化‌：从需求分析到代码提交全流程自动化，关键操作会提前请求用户确认，安全性更强
4. ‌多场景适配‌：支持40+编程语言和主流框架，覆盖代码生成、Bug调试、项目导航、重构、自动化任务等全场景，还支持多AI智能体协作处理大型项目‌
5. ‌灵活兼容‌：兼容官方Claude模型，也可接入第三方国产大模型，满足不同网络和成本需求

03.

安装和配置 Claude Code 主要分为‌环境准备‌、‌安装程序‌、‌模型接入配置‌三个核心步骤。由于国内网络环境的特殊性，推荐采用“本地框架 + 第三方/国产模型”的方案，既稳定又无需特殊网络工具。

以下是基于 Windows 和 macOS 系统的详细保姆级教程：

第一步：环境准备（必做）

在安装 Claude Code 之前，请确保你的电脑已安装以下基础依赖：

• ‌Node.js‌：版本需 ≥ 18.0（推荐最新 LTS 版本）。
  检查方法：在终端输入 node -v，若未安装或版本过低，请前往 Node.js官网 下载并安装。
• ‌Git‌：用于版本控制和部分底层命令执行。
  检查方法：在终端输入 git --version。Windows 用户建议安装 Git Bash。
• ‌终端工具‌：
  ‌macOS‌：自带终端（Terminal）或 iTerm2。
  ‌Windows‌：推荐使用 PowerShell、CMD 或 Windows Terminal。

第二步：安装 Claude Code

你可以根据操作系统选择以下任意一种安装方式。‌推荐使用方法一（npm安装）‌，因为最稳定且跨平台通用。

方法一：npm 全局安装（推荐，全平台通用）

打开终端（Windows 请以管理员身份运行），执行以下命令：

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

• macOS/Linux 用户‌：如果提示权限不足，请在命令前加 sudo，即 sudo npm install -g @anthropic-ai/claude-code。
• ‌验证安装‌：安装完成后，输入 claude --version，若显示版本号则说明安装成功。

方法二：官方脚本安装（macOS/Linux 首选）

在终端中直接运行以下命令，脚本会自动检测环境并安装：

bash
curl -fsSL https://claude.ai/install.sh | bash

• ‌注意‌：此方法在国内网络环境下可能因连接超时失败，若失败请改用方法一。

方法三：Homebrew 安装（仅限 macOS）

如果你已安装 Homebrew，可以使用以下命令：

bash
brew install --cask claude-code

Windows 专属补充

Windows 用户若通过 npm 安装后无法识别 claude 命令，需手动配置环境变量：

• 找到 Node.js 的全局模块路径（通常为 C:\Users\你的用户名\AppData\Roaming\npm）。
• 将该路径添加到系统的 ‌Path‌ 环境变量中。
• 重启终端后再次验证 claude --version。

第三步：配置与模型接入（关键）

Claude Code 本身只是一个“框架/客户端”，它需要接入大模型才能工作。你有两种选择：

方案 A：使用官方 Anthropic 账号（适合有海外支付能力/网络环境的用户）

1. 在终端输入 claude 启动程序。
2. 根据提示输入 /login。
3. 浏览器会弹出 Anthropic 登录页面，使用你的 Anthropic 账号（Pro/Max 订阅）授权即可。
4. 授权成功后，终端显示 "Login successful"，即可开始使用官方 Claude 模型。

方案 B：接入国产/第三方模型（国内用户推荐，稳定且低成本）

由于直接访问 Anthropic 服务在国内存在网络门槛，大多数国内开发者选择接入兼容 OpenAI 接口的国产模型（如智谱 GLM-4、阿里通义千问、DeepSeek 等）。

推荐工具：cc-switch（图形化配置工具）‌为了简化配置，推荐使用社区开源工具 cc-switch 来管理模型切换。

1. ‌安装 cc-switch‌：

• ‌macOS‌: brew tap farion1231/ccswitch && brew install --cask cc-switch
• ‌Windows‌: 前往 GitHub Releases 页面下载安装包并安装。

2. ‌获取 API Key‌：

• 前往你选择的模型提供商平台（如智谱 AI 开放平台、阿里云百炼、DeepSeek 平台等）。
• 创建 API Key 并复制保存。

3. ‌配置模型‌：

• 打开 cc-switch 界面。
• 点击“添加配置”或“自定义配置”。
• 填写以下信息（以智谱 GLM 为例）：
• ‌Base URL‌: 厂商提供的 API 地址（例如 https://open.bigmodel.cn/api/paas/v4）
• ‌API Key‌: 你刚才申请的 Key
• ‌Model Name‌: 模型名称（例如 glm-4-plus 或 glm-4-flash）
• 保存配置，并将其设为“默认”或“激活”状态。

1. 跳过官方登录引导‌：由于不使用官方账号，首次运行 claude 时可能会要求登录。你需要创建一个配置文件来跳过引导：

2. bash
   mkdir -p ~/.claudeecho'{"hasCompletedOnboarding": true}' > ~/.claude.json

   powershell
   New-Item -ItemType Directory -Force -Path $HOME\.claudeSet-Content -Path $HOME\.claude\config.json -Value '{"primaryApiKey":"any-string"}'# 或者手动创建文件，确保包含 hasCompletedOnboarding: true

1. ‌启动测试‌：进入任意项目文件夹，输入 claude。如果配置正确，它将直接加载你配置的国产模型并开始对话。

第四步：常用操作与验证

1. ‌启动交互模式‌：在项目根目录下输入 claude，进入聊天界面。你可以直接说：“帮我分析一下这个项目的结构”或“写一个 Python 脚本来抓取网页标题”。

2. ‌常用斜杠命令‌：

• /help ：查看帮助文档。
• /clear：清空当前对话上下文。
• /config：打开配置界面（如果使用 cc-switch 则无需在此配置）。
• /compact：压缩上下文，节省 Token。

3. ‌非交互模式（一次性任务）‌：

bash
claude "修复当前的构建错误"claude -p "解释一下 main.py 中的函数逻辑"

按照以上步骤，你就可以在本地顺利运行 Claude Code，并享受 AI 辅助编程的高效体验了。