Claude Code国内使用教程：Windows/Mac安装配置与国产模型接入完整指南

什么是Claude Code？国内用户的最佳选择

Claude Code是Anthropic官方推出的命令行AI编程助手，让你直接在终端里与Claude交互，完成代码编写、调试、重构和项目生成等任务。对于国内开发者来说，最大的好消息是：Claude Code完全支持国内环境使用，无需特殊网络也能配置成功，而且可以接入国产大模型API，完全免费开启高效编程体验。

Claude Code的核心优势

相比传统IDE和普通AI聊天工具，Claude Code有以下独特优势：

• 原生命令行交互：直接在终端工作，无需切换窗口，适合习惯命令行的开发者
• 智能代码编辑：可读写文件、运行命令、执行git操作，真正介入开发全流程
• 超长上下文理解：基于Claude Opus 4.5，支持整个项目级别的代码理解和修改
• 支持MCP协议：可扩展数据库查询、API调用、浏览器控制等外部能力
• 国内友好：支持配置国产大模型API（如GLM、DeepSeek等），绕过网络限制

Windows系统安装详解

方法一：PowerShell原生安装（推荐）

Windows 10/11用户推荐使用PowerShell原生安装器，无需安装Node.js：

iex (Invoke-WebRequest -Uri https://claude.ai/install.ps1 -UseBasicParsing).Content

安装完成后，终端输入claude --version验证是否安装成功。

方法二：npm安装

如果你已安装Node.js 18+，也可以使用npm全局安装：

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

国内网络安装npm包较慢时，可先切换淘宝镜像：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

国内用户配置：跳过订阅+国产模型

跳过官方订阅验证

安装后首次运行若提示订阅，用以下方法绕过：在用户目录（C:\Users\你的用户名）找到或创建.claude.json文件，添加一行：

"hasCompletedOnboarding": true

配置国产大模型API

Claude Code底层使用Anthropic协议，但支持通过CC-Switch等工具接入国产模型。推荐配置GLM-5.1（国产效果最接近Claude Opus）或MiniMax M2.7：

1. 安装CC-Switch工具（支持多模型切换的开源辅助工具）
2. 在DeepSeek或智谱AI平台申请API密钥
3. CC-Switch中新增模型配置，填入API密钥和接口地址
4. 终端输入/model切换到配置的国产模型

这样配置后，Claude Code的所有核心功能（代码编写、调试、重构）都能正常使用，Token成本大幅降低。

日常使用：10个必会的核心命令

Claude Code内置50多个斜杠命令，以下是最实用的10个：

• /clear — 清空对话，开始新会话，不丢失历史记录
• /compact — 压缩对话，释放上下文空间，保持AI注意力集中
• /model — 切换使用的模型，可选Claude Opus/Sonnet/Haiku或国产模型
• /kill — 终止当前正在运行的任务
• /status — 查看当前会话状态和资源占用
• /browse — 让Claude浏览网页获取最新信息
• /mcp — 调用已配置的MCP工具（如数据库、GitHub等）
• /review — 代码审查模式，分析当前文件的潜在问题
• /test — 生成单元测试，覆盖当前修改的代码路径
• /help — 查看所有可用命令及说明

实战场景：从零搭建一个项目

用Claude Code最爽的场景之一就是从自然语言描述直接生成完整项目。以下是实操步骤：

1. 在目标目录打开终端，输入claude启动
2. 描述你的需求，例如：「帮我创建一个Python Flask博客项目，包含用户注册、登录和文章发布功能」
3. Claude会自动创建目录结构、所有Python文件和必要的配置文件
4. 输入/test让它生成单元测试
5. 输入python app.py直接运行查看效果

实测一个中等复杂度的CRUD项目，整个流程不超过15分钟。

Claude Code vs 其他AI编程工具对比

工具	免费程度	国内适配	代码理解深度	适合人群
Claude Code	API费用（可用国产模型）	✅ 支持国产模型	⭐⭐⭐⭐⭐	命令行重度用户
TRAE	✅ 基础版免费	✅ 国产优化	⭐⭐⭐⭐	VS Code用户
通义灵码	✅ 个人免费	✅ 原生支持	⭐⭐⭐	阿里云用户
Cursor	✅ 有免费额度	⚠️ 需代理	⭐⭐⭐⭐	需要GUI的开发者

常见问题解答

Q：Claude Code收费吗？
A：Claude Code本身免费，但调用Claude模型需要API费用。如果接入国产模型（GLM、DeepSeek等），费用大幅降低，部分平台有免费额度。

Q：Windows上运行报错「找不到命令」？
A：检查PATH环境变量是否包含npm全局目录，或使用PowerShell原生安装方式。

Q：国产模型效果比得上原生Claude吗？
A：GLM-5.1和MiniMax M2在代码补全和简单重构任务上效果接近Claude Sonnet，但在复杂多文件重构方面仍有差距。建议重要项目用Claude Opus，日常任务用国产模型。

总结

Claude Code作为Anthropic官方AI编程工具，凭借超强的代码理解能力和MCP扩展生态，正在成为专业开发者的首选。国内用户通过合理的模型配置，完全可以在不依赖特殊网络、不花冤枉钱的情况下享受顶级AI编程体验。如果你习惯命令行工作流，想要一个真正能介入开发全流程的AI助手，Claude Code绝对值得一试。

• AI工具免费版完全指南：从入门到精通的实用教程 — 包含TRAE、通义灵码等更多AI编程工具的选择指南
• AI编程工具横向对比：选对工具让开发效率翻倍 — 主流AI编程工具横评与选型建议
• 通义灵码VS其他AI编程助手：深度对比评测 — 阿里通义灵码的详细使用体验