Claude Code 入门实战：从安装配置到真实项目落地本文将手把手介绍 Claude Code 的安装方式、国内模型

一、Claude Code 简介

Claude Code 是 Anthropic 推出的面向开发者的 AI 编程协作工具，与在聊天窗口里写几段代码不同，Claude Code 的核心目标是理解你的整个项目，并参与到真实的编码、修改和重构过程中。

Claude Code 不是一个代码生成器，而是一个能读项目、懂上下文、遵守约束的 AI 编程搭档。简单说:Claude Code 是 Claude 的命令行版本,专门为编程场景设计。它不是网页里的聊天框，而是直接在你的终端(Terminal)里运行,可以:

读取你整个项目的代码
理解文件之间的关系
直接修改代码文件
执行你的指令并给出建议

二、Claude Code 和其他 AI 编程工具有什么区别?

你可能还听说ChatGPT、Cursor、GitHub Copilot，它们和 Claude Code 有什么不同?

Claude Code vs Cursor / Copilot

维度	Cursor / Copilot	Claude Code
工作方式	编辑器内自动补全	命令行对话式
适合场景	写代码时实时提示	理解、重构、架构级修改
学习成本	低,开箱即用	中,需要学习指令过 ChatGPT、Cursor、GitHub Copilot，它们和 Claude Code 有什么不同?

三、安装与配置Claude Code

3.1 准备工作

必须工具：

工具	用途	安装地址
Node.js	运行环境（v18.0 或更高版本）。	nodejs.org/en/download…
Git	Windows上使用Claude code 需要安装git	git-scm.com/install/win…
API Key	模型服务	阿里Qwen/月之暗面k2/智普GLM等

3.2 使用npm安装Claude Code

（1）macOS

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

下载完成终端执行

claude -v

安装成功

（2）Windows

在 Windows 上使用 Claude Code，需要安装 WSL 或 Git for Windows，然后在 WSL 或 Git Bash 中执行以下命令

// 全局安装
npm install -g @anthropic-ai/claude-code

// 查看安装版本号
claude -v

如果出现访问不到claude的情况，需要全局配置下环境变量

(3) VS Code中安装使用

注意：Claude Code for VS Code插件配置中的Select Model需要填入本地已经配置的模型

终端执行

claude

报错提示： Unable to connect to Anthropic services

Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

编辑 ~/.claude.json 文件，将hasCompletedOnboarding 字段的值设置为 true并保存文件。

{
  "hasCompletedOnboarding": true
}

再次终端执行 claude，启动成功

3.3 配置模型

Claude 在国内用，API 其实不是很友好，除了 Claude 官方的模型，我能用其他 AI 模型吗？

常用国内模型配置示例：

厂商/品牌	简介	API 申请入口（点击即达）
阿里百炼（通义千问）	阿里云大模型统一入口，支持 qwen-max、qwen-turbo 等	bailian.console.aliyun.com
GLM（智谱清言）	清华系 ChatGLM 系列，支持 GLM-4、GLM-3-Turbo 等	open.bigmodel.cn
MiniMax	国产多模态，支持文本、语音、图像混合调用	platform.minimaxi.com

进入对应控制台后，注册/登录 → 完成实名认证 → 创建 API Key 即可开始调用。

（1）手动配置

Windows

在 CMD 中运行以下命令，设置环境变量：

setx ANTHROPIC_AUTH_TOKEN "你的API Key"
setx ANTHROPIC_BASE_URL "模型API地址"
setx ANTHROPIC_MODEL "模型名称"

打开一个新的 CMD 窗口，运行以下命令，检查环境变量是否生效

echo %ANTHROPIC_AUTH_TOKEN%
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

macOS/Linux：

打开配置文件 ~/.claude/settings.json。编辑配置文件：

vim ~/.claude/settings.json

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "你的API Key",
        "ANTHROPIC_BASE_URL": "模型API地址",
        "ANTHROPIC_MODEL": "模型名称"
    }
}

重新打开一个新的终端使环境变量配置生效。

（2）使用CC Switch

平台一多，配置起来就麻烦，我们可以使用第三方工具 CC Switch 可以帮我们轻松管理这几个热门工具的 API 配置: github.com/farion1231/…, Windows / macOS / Linux 全支持。CC Switch 是一个 Claude Code / Codex / Gemini CLI 的全方位辅助工具。

各个平台安装包下载地址：github.com/farion1231/…