文章目录1. 什么是 Claude Code2. 环境搭建Windows/Mac 通用2.1 安装前置软件2.2 解决网络下载问题换源2.3 安装与更新 Claude Code3. 核心痛点解决配置国内 API3.1 方案一使用 Kimi (Moonshot AI)3.2 方案二使用 DeepSeek3.3 方案三使用智谱 GLM (BigModel)4. 实战创建第一个项目4.1 初始化项目4.2 启动 Claude Code4.3 常用指令5. 进阶玩法Skills 与 MCP5.1 使用 Skills 扩展能力5.2 配置 MCP 服务器 (视觉与搜索)6. 常见问题 (FAQ)来源说明本文整理自飞书文档Claude Code学习笔记及智谱AI开放文档。核心价值针对国内开发者无法直接使用 Claude Code 的痛点提供了一套完整的“本地化平替”方案涵盖安装、环境配置、国内大模型接入DeepSeek/Kimi/GLM及高级功能配置。1. 什么是 Claude CodeClaude Code 是 Anthropic 推出的 AI 编程助手 CLI命令行工具。它不仅能写代码还能像一位高级工程师一样理解项目上下文、执行终端命令、管理 Git 版本控制并根据你的自然语言指令完成复杂的开发任务。2. 环境搭建Windows/Mac 通用在国内环境下安装 Claude Code通常会遇到网络下载慢、权限不足等问题。以下是最佳实践步骤2.1 安装前置软件Claude Code 依赖 Node.js (v18) 和 Git 环境。Node.js: 建议安装 LTS长期支持版本。验证在终端输入node -v和npm -v显示版本号即成功。Git: 版本控制工具。验证在终端输入git --version。2.2 解决网络下载问题换源由于 NPM 官方源在海外下载速度极慢。建议切换到淘宝镜像源# 临时使用淘宝源安装推荐npminstall-g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com# 或者永久换源npmconfigsetregistry https://registry.npmmirror.com2.3 安装与更新 Claude Code在终端CMD / PowerShell / Terminal运行# 安装npminstall-g anthropic-ai/claude-code# 验证安装claude --version# 后续升级到最新版本claude update注意如果在受限环境如无 sudo 权限下安装失败请参考本文末尾 FAQ 中的“局部安装方案”。3. 核心痛点解决配置国内 API官方 Claude API 在国内访问受限且需要外币卡支付。我们可以通过配置兼容 OpenAI 格式的第三方中转 API来完美替代。以下提供四种主流方案3.1 方案一使用 Kimi (Moonshot AI)Kimi 的 API 对代码理解能力强且有免费额度。配置命令Mac/LinuxexportANTHROPIC_BASE_URLhttps://api.moonshot.cn/anthropicexportANTHROPIC_API_KEY你的-Kimi-API-KEY3.2 方案二使用 DeepSeekDeepSeek 是目前性价比极高的选择适合高频调用。配置命令exportANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicexportANTHROPIC_API_KEY你的-DeepSeek-API-KEYexportANTHROPIC_MODELdeepseek-chat3.3 方案三使用智谱 GLM (BigModel)智谱 AI 提供了官方的 Claude Code 适配方案可以通过修改配置文件来映射模型。配置方法修改或创建配置文件~/.claude/settings.json添加如下内容{env:{ANTHROPIC_DEFAULT_HAIKU_MODEL:glm-4.5-air,ANTHROPIC_DEFAULT_SONNET_MODEL:glm-4.7,ANTHROPIC_DEFAULT_OPUS_MODEL:glm-4.7}}注修改配置文件后需关闭所有 Claude Code 窗口重新启动生效。4. 实战创建第一个项目4.1 初始化项目mkdirmy-first-projectcdmy-first-projectgitinit4.2 启动 Claude Code在项目目录下运行claude首次运行时若提示「Do you want to use this API key」选择 Yes 即可。启动后请选择信任当前文件夹。4.3 常用指令/init:核心命令。Claude 会扫描当前目录生成CLAUDE.md项目记忆文件。这个文件记录了项目的架构、技术栈和常用命令让 Claude “记住”你的项目细节。/bug: 快速修复当前代码中的错误。/help: 查看所有可用命令。/status: 查看当前模型状态和配置信息。5. 进阶玩法Skills 与 MCP5.1 使用 Skills 扩展能力Skills是 Claude Code 的插件机制允许你定义一组指令或工具来自动化特定任务。获取 Skills从社区下载现成的 Skills。安装 Skills将下载的 Skill 文件夹放入~/.claude/skills/目录。使用在对话中直接用自然语言调用。5.2 配置 MCP 服务器 (视觉与搜索)Claude Code 支持 MCP (Model Context Protocol)可以接入视觉和搜索能力。视觉 MCP允许 Claude Code “看”到图片或界面截图。搜索 MCP允许 Claude Code 联网搜索最新文档。配置参考官方文档配置 MCP Server 后即可在 CLI 中直接使用这些能力。6. 常见问题 (FAQ)Q: 手动修改settings.json不生效A: 必须关闭所有 Claude Code 终端窗口重新打开一个新的窗口运行claude。如果仍有问题尝试删除配置文件让其自动重新生成并检查 JSON 格式是否正确不能有多余逗号。Q: 遇到429 Too Many Requests错误A: 这是 API 调用频率超限。Kimi/DeepSeek 的免费版通常有 RPM每分钟请求数限制。建议降低语速或者充值升级 API 额度。Q: Windows 下提示权限错误A: 尝试以“管理员身份”运行 PowerShell或者检查 Node.js 安装目录的权限。Q:sudo命令无法使用A: 在某些 IDE如 Trae或受限环境中sudo被禁用。请使用局部安装方案即在项目目录下npm install anthropic-ai/claude-code然后通过./node_modules/.bin/claude或封装脚本启动。