Claude Code 是一个代理编码工具，可以读取你的代码库、编辑文件、运行命令，并与开发工具集成。这篇文章介绍在 Windows 中搭建 Claude Code 并接入国产大模型，使用 VS Code 可视化插件，免登录配置。

什么是 Claude Code

Claude Code 是一个由 AI 驱动的编码助手，可帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库，可以跨多个文件和工具工作以完成任务。

第一章：环境配置

需要安装两个环境

环境	说明	版本要求
Node.js	JavaScript 运行时	Node.js 18+
Git	版本管理工具	最新版

安装 Node.js

1. 访问 Node.js 官网：nodejs.org
2. 下载 Windows 安装包（.msi）
3. 双击运行，一路下一步完成安装
4. 验证安装：

node --version
npm --version

安装 Git

1. 访问 Git 官网：git-scm.com
2. 下载 Windows 版本
3. 安装时选择默认配置即可
4. 验证安装：

git --version

第二章：安装 Claude Code

命令行安装

# 打开 CMD 或 PowerShell
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

验证安装

claude --version

看到版本号说明安装成功。

第三章：免登录配置

默认情况下 Claude Code 会强制登录，以下是跳过登录的方法。

找到配置文件

配置文件路径：

# Windows 用户目录
%USERPROFILE%\.claude.json
# 完整路径示例
C:\Users\你的用户名\.claude.json

添加免登录配置

在 .claude.json 文件中添加：

{
  "hasCompletedOnboarding": true
}

注意：语法之间注意逗号分隔。

第四章：接入国产大模型

Claude Code 默认使用 Anthropic 的 Claude，也可以接入国产大模型如 DeepSeek。

接入 DeepSeek

修改配置文件：

// %USERPROFILE%\.claude.json
{
  "hasCompletedOnboarding": true,
  "models": {
    "primary": "deepseek-chat",
    "deepseek": {
      "apiKey": "your-deepseek-api-key",
      "apiBase": "https://api.deepseek.com"
    }
  }
}

接入其他国产模型

模型	API 地址
DeepSeek	api.deepseek.com
通义千问	dashscope.aliyuncs.com
智谱 GLM	open.bigmodel.cn
文心一言	qianfan.baidubce.com

使用 OpenRouter（推荐）

OpenRouter 可以一键接入多个模型：

{
  "hasCompletedOnboarding": true,
  "models": {
    "primary": "anthropic/claude-3.5-sonnet"
  },
  "OPENROUTER_API_KEY": "your-openrouter-key"
}

第五章：VS Code 可视化插件

安装 Claude for VS Code

1. 打开 VS Code
2. 按 Ctrl+Shift+X 打开扩展市场
3. 搜索 "Claude"
4. 安装 "Claude" 官方扩展

配置插件

1. 按 Ctrl+, 打开设置
2. 搜索 "Claude"
3. 配置 API Key 和模型

{
  "claude.apiKey": "your-api-key",
  "claude.model": "claude-3.5-sonnet",
  "claude.apiUrl": "https://api.anthropic.com"
}

使用方式

操作	快捷键
打开 Claude 面板	Ctrl+Shift+L
选中代码提问	Ctrl+Shift+I
解释代码	右键 → Claude → Explain
重构代码	右键 → Claude → Refactor

常见问题

Q：npm 安装失败？

A： 检查 Node.js 是否正确安装，尝试用管理员权限打开终端。

Q：免登录配置不生效？

A： 确认 .claude.json 格式正确，文件放在正确位置。

Q：VS Code 插件连不上？

A： 检查 API Key 是否正确，网络是否正常。

Q：国产模型响应慢？

A： 优先选择响应速度快的模型，或者使用 OpenRouter 代理。

一句话总结

Windows 用户搭建 Claude Code：安装 Node.js → 安装 Claude Code → 免登录配置 → 接入国产大模型 → 安装 VS Code 插件。

核心命令：

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