Claude Code安装及配置国内大模型完整教程

主流Agent安装与使用 2026-07-31 11:26 eogee.com 教程团队边看边学 436 次阅读 1次收藏

Claude Code是Anthropic开发的AI编程助手，本教程详细介绍Claude Code安装配置及国内大语言模型的接入方法。包含Node.js环境准备、大模型API Key获取、settings.json配置文件设置，以及Claude Code基础使用等内容。帮助开发者快速搭建本地AI编程、文档编辑等多功能智能体使用环境，提升工作和学习效率。

前置教程

如想快速开始学习本教程，你可能需要先完成以下前置教程：

VSCode的安装与基本使用教程，VSCode作为编辑器，Claude Code在VSCode的集成终端中运行。
Node.js和Npm安装与使用教程，用于下载、安装和配置Claude Code。
Git的安装与基本使用教程，用于执行Npm和Npx命令。

1. 项目部署与启动指南

环境检查

在VSCode的集成终端中打开git命令行，确保已安装必要的环境：

# 检查 Node.js 版本
node --version

# 检查 Npm 版本
npm --version

安装方式选择

项目级本地安装，打开git命令行，输入以下命令：

# 创建项目目录
mkdir my-claude-project
cd my-claude-project

# 初始化 npm 项目
npm init -y

# 本地安装 Claude Code (使用国内镜像源)
npm install -D @anthropic-ai/claude-code --registry https://registry.npmmirror.com

# 启动 Claude Code
npx claude

全局安装（重点，后续的配置和使用基本以全局安装为例）：

# 全局安装 (使用国内镜像源)
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com

# 验证安装
claude --version

# 启动 Claude Code
claude

2. API 配置

2.1 获取智谱GLM API Key

由于智谱GLM提供免费模型，无需支付费用，本教程以智谱GLM为例。

注册地址: https://bigmodel.cn/

API Key 获取步骤:

访问智谱AI官网并注册账户
完成实名认证
进入 API Keys 管理页面：https://bigmodel.cn/usercenter/proj-mgmt/apikeys
创建新的 API Key
复制并保存 API Key

其他厂商模型： Deepseek也同样提供针对于Claude Code的API服务：

注册地址: https://platform.deepseek.com/

API Key 获取步骤:

访问Deepseek官网官网并注册账户
进入 API Keys 管理页面：https://platform.deepseek.com/usercenter/proj-mgmt/apikeys
创建新的 API Key
复制并保存 API Key

2.2 创建配置文件

创建项目级配置文件：

打开PowerShell或命令提示符，执行以下命令：

# 创建配置目录
mkdir .claude -Force

# 创建配置文件
New-Item -Path .claude\settings.json -ItemType File -Force

# 编辑配置
notepad \.claude\settings.json

创建全局配置文件：

# 创建配置目录
mkdir -Force ~/.claude

# 创建配置文件
New-Item -Path ~/.claude/settings.json -ItemType File -Force

# 使用记事本编辑
notepad ~/.claude/settings.json

notepad $HOME/.claude/settings.json # Windows命令

2.3 配置GLM API信息

在配置文件中添加以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "您的智谱API密钥",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic"
  },
  "model": "glm-4.7-flash"
}

配置说明:

ANTHROPIC_AUTH_TOKEN: 填入您的智谱API Key
ANTHROPIC_BASE_URL: 智谱API服务地址
model: 指定使用 GLM-4.7-flash 模型

配置GLM API信息示意图

3. 在VSCode中使用Claude Code

3.1 安装插件

在VSCode中搜索并安装 Claude Code 插件。

默认情况下，插件会自动在VSCode的右侧边栏中启动Claude Code，你可以将其拖动至左侧边栏，或其他位置。

3.2 配置插件

打开VSCode设置
搜索 Claude Code
将Login Prompt（登陆提示）禁用

配置插件示意图

4. 常见问题解决

PowerShell执行策略限制

问题症状: 脚本无法执行

解决方案:

# 为当前用户修改执行策略
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

# 或临时绕过策略
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force

举手提问

0/1000