夜雨聆风01.
Claude Code是Anthropic公司推出的终端原生AI编程助手，是一个能自主完成全流程开发任务的智能编码工具。
它并非简单的代码补全工具，而是可以直接在开发者的终端/IDE环境中运行，理解整个代码库架构，能独立完成需求拆解、代码编写、文件修改、命令执行、测试运行甚至Git提交等全流程开发工作，相当于一个可以直接协作的AI程序员同事。
02.
核心特点与能力：
终端原生集成：直接在终端运行，和CLI工具、IDE无缝衔接，无需来回切换窗口，不打断开发节奏 超长上下文支持：支持最高百万级Token上下文，能完整理解整个大型代码库，数万行代码可直接处理 全流程自动化：从需求分析到代码提交全流程自动化，关键操作会提前请求用户确认，安全性更强 多场景适配：支持40+编程语言和主流框架，覆盖代码生成、Bug调试、项目导航、重构、自动化任务等全场景，还支持多AI智能体协作处理大型项目 灵活兼容：兼容官方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 账号（适合有海外支付能力/网络环境的用户）
在终端输入 claude启动程序。根据提示输入 /login。浏览器会弹出 Anthropic 登录页面，使用你的 Anthropic 账号（Pro/Max 订阅）授权即可。 授权成功后，终端显示 "Login successful"，即可开始使用官方 Claude 模型。
方案 B：接入国产/第三方模型（国内用户推荐，稳定且低成本）
由于直接访问 Anthropic 服务在国内存在网络门槛，大多数国内开发者选择接入兼容 OpenAI 接口的国产模型（如智谱 GLM-4、阿里通义千问、DeepSeek 等）。
推荐工具：cc-switch（图形化配置工具）为了简化配置，推荐使用社区开源工具 cc-switch 来管理模型切换。
安装 cc-switch：
macOS: brew tap farion1231/ccswitch && brew install --cask cc-switchWindows: 前往 GitHub Releases 页面下载安装包并安装。 获取 API Key：
前往你选择的模型提供商平台（如智谱 AI 开放平台、阿里云百炼、DeepSeek 平台等）。 创建 API Key 并复制保存。 配置模型：
打开 cc-switch界面。点击“添加配置”或“自定义配置”。 填写以下信息（以智谱 GLM 为例）： Base URL: 厂商提供的 API 地址（例如 https://open.bigmodel.cn/api/paas/v4）API Key: 你刚才申请的 Key Model Name: 模型名称（例如 glm-4-plus或glm-4-flash）保存配置，并将其设为“默认”或“激活”状态。
跳过官方登录引导：由于不使用官方账号，首次运行 claude时可能会要求登录。你需要创建一个配置文件来跳过引导：bash mkdir -p ~/.claudeecho'{"hasCompletedOnboarding": true}' > ~/.claude.jsonpowershell New-Item -ItemType Directory -Force -Path $HOME\.claudeSet-Content -Path $HOME\.claude\config.json -Value '{"primaryApiKey":"any-string"}'# 或者手动创建文件，确保包含 hasCompletedOnboarding: true
启动测试：进入任意项目文件夹，输入
claude。如果配置正确，它将直接加载你配置的国产模型并开始对话。
第四步：常用操作与验证
启动交互模式：在项目根目录下输入
claude，进入聊天界面。你可以直接说：“帮我分析一下这个项目的结构”或“写一个 Python 脚本来抓取网页标题”。常用斜杠命令：
/help ：查看帮助文档。/clear：清空当前对话上下文。/config：打开配置界面（如果使用 cc-switch 则无需在此配置）。/compact：压缩上下文，节省 Token。非交互模式（一次性任务）：
bash
claude "修复当前的构建错误"claude -p "解释一下 main.py 中的函数逻辑"
按照以上步骤，你就可以在本地顺利运行 Claude Code，并享受 AI 辅助编程的高效体验了。
