【大模型应用开发】Claude Code 全方位入门指南：从零基础到本地化实战

来源说明：本文整理自飞书文档：Claude Code学习笔记及智谱AI开放文档。
核心价值：针对国内开发者无法直接使用 Claude Code 的痛点，提供了一套完整的“本地化平替”方案，涵盖安装、环境配置、国内大模型接入（DeepSeek/Kimi/GLM）及高级功能配置。

1. 什么是 Claude Code？

Claude Code 是 Anthropic 推出的 AI 编程助手 CLI（命令行）工具。它不仅能写代码，还能像一位高级工程师一样，理解项目上下文、执行终端命令、管理 Git 版本控制，并根据你的自然语言指令完成复杂的开发任务。

2. 环境搭建（Windows/Mac 通用）

在国内环境下安装 Claude Code，通常会遇到网络下载慢、权限不足等问题。以下是最佳实践步骤：

2.1 安装前置软件

Claude Code 依赖 Node.js (v18+) 和 Git 环境。

1. Node.js: 建议安装 LTS（长期支持）版本。
   • 验证：在终端输入node -v和npm -v，显示版本号即成功。
2. Git: 版本控制工具。
   • 验证：在终端输入git --version。

2.2 解决网络下载问题（换源）

由于 NPM 官方源在海外，下载速度极慢。建议切换到淘宝镜像源：

# 临时使用淘宝源安装（推荐）npminstall-g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com# 或者永久换源npmconfigsetregistry https://registry.npmmirror.com

2.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/Linux）：

exportANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"exportANTHROPIC_API_KEY="你的-Kimi-API-KEY"

3.2 方案二：使用 DeepSeek

DeepSeek 是目前性价比极高的选择，适合高频调用。

配置命令：

exportANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"exportANTHROPIC_API_KEY="你的-DeepSeek-API-KEY"exportANTHROPIC_MODEL="deepseek-chat"

3.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-projectgitinit

4.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 与 MCP

5.1 使用 Skills 扩展能力

Skills是 Claude Code 的插件机制，允许你定义一组指令或工具来自动化特定任务。

1. 获取 Skills：从社区下载现成的 Skills。
2. 安装 Skills：将下载的 Skill 文件夹放入~/.claude/skills/目录。
3. 使用：在对话中直接用自然语言调用。

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或封装脚本启动。