☰

企业官网建设流程全解析

首页 / 建站日记 / 企业官网建设流程全解析
ClaudeCode终极配置指南：从安装到多模型集成
2026/7/22 19:11:59 网站建设 项目流程

目录

  1. 什么是 Claude Code

  2. 系统要求与准备工作

  3. 安装 Node.js

  4. 安装 Claude Code

  5. 获取 API Key

  6. 基础配置：环境变量与 settings.json

  7. 第三方模型配置（国内用户必看）

  8. CC Switch 可视化工具配置

  9. VS Code / JetBrains IDE 集成

  10. 常见模型 API 配置速查表

  11. 常见问题排查

  12. 参考资料

1. 什么是 Claude Code

Claude Code 是 Anthropic 推出的官方 AI 编程工具，以命令行（CLI）形式运行，可以直接在终端中与 Claude 对话，实现代码编写、调试、重构、文档生成等功能。

核心特性：

  • 直接读取和编辑本地项目文件

  • 执行终端命令并分析结果

  • 支持 Git 操作

  • 可集成到 VS Code / JetBrains 等主流 IDE

  • 支持通过第三方 API 接入国产大模型（DeepSeek、GLM、Qwen 等）

2. 系统要求与准备工作

项目要求
操作系统Windows 10/11、macOS 12+、Ubuntu 20.04+
Node.js>= 18.0（推荐 20.x LTS）
npm>= 9.0（随 Node.js 一起安装）
内存>= 4GB RAM
网络需要能访问 npm 仓库和 API 端点
磁盘空间>= 500MB

2.1 检查已有环境

# 检查 Node.js 版本 node -v ​ # 检查 npm 版本 npm -v

3. 安装 Node.js

3.1 Windows

方式一：官网安装包（推荐）

  1. 访问 Node.js — Run JavaScript Everywhere

  2. 下载LTS（长期支持版）安装包

  3. 双击运行安装程序，一路默认即可

方式二：使用 nvm-windows（版本管理）

# 安装 nvm-windows 后 nvm install 20 nvm use 20

3.2 macOS

# 使用 Homebrew brew install node@20 ​ # 或使用 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash nvm install 20 nvm use 20

3.3 Linux (Ubuntu/Debian)

# 使用 NodeSource curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs ​ # 或使用 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash source ~/.bashrc nvm install 20

3.4 验证安装

node -v # 应输出 v20.x.x npm -v # 应输出 10.x.x

4. 安装 Claude Code

4.1 官方安装（海外用户）

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

4.2 国内安装（使用淘宝镜像加速）

国内直接安装可能因网络问题导致失败，建议先切换 npm 镜像源：

# 设置淘宝镜像 npm config set registry https://registry.npmmirror.com ​ # 验证镜像设置成功 npm config get registry ​ # 安装 Claude Code npm install -g @anthropic-ai/claude-code

这样算是安装成功了：

4.3 验证安装

claude --version

如果输出版本号（如1.x.x），说明安装成功。

4.4 更新 Claude Code

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

4.5 国内用户更新（镜像源）

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

5. 获取 API Key

5.1 Anthropic 官方 API Key

5.2 第三方中转 API Key（国内推荐）

国内用户推荐使用第三方 API 中转服务，无需海外信用卡，且支持国产模型：

服务商说明
OpenRouter支持多种模型，国际通用
硅基流动支持 DeepSeek、GLM 等国产模型
火山引擎字节跳动旗下，支持豆包等模型
阿里云百炼支持通义千问系列
CloseAIAnthropic 协议兼容中转
其他中转站根据个人需求选择

💡 第三方 API Key 格式通常为sk-开头。

6. 基础配置：环境变量与 settings.json

Claude Code 的配置有两种方式：终端环境变量（临时）和settings.json 文件（持久化）。

6.1 方式一：终端环境变量（临时）

Windows CMD
setx ANTHROPIC_API_KEY "sk-ant-你的密钥" setx ANTHROPIC_BASE_URL "https://你的中转地址"
Windows PowerShell
$env:ANTHROPIC_API_KEY = "sk-ant-你的密钥" $env:ANTHROPIC_BASE_URL = "https://你的中转地址"
macOS / Linux
export ANTHROPIC_API_KEY="sk-ant-你的密钥" export ANTHROPIC_BASE_URL="https://你的中转地址"

⚠️ 使用setx设置后需重新打开终端才能生效。 如果只想临时使用，在 PowerShell 中用$env:方式设置即可（关闭终端后失效）。

6.2 方式二：settings.json（推荐，持久化）

Claude Code 的配置文件路径：

作用域路径说明
用户级~/.claude/settings.json对所有项目生效
项目级项目目录/.claude/settings.json仅对当前项目生效
创建配置文件
# 创建配置目录（如果不存在） mkdir -p ~/.claude ​ # 使用编辑器打开（以 VS Code 为例） code ~/.claude/settings.json
基础配置模板（官方 API）
{ "env": { "ANTHROPIC_API_KEY": "sk-ant-你的密钥", "ANTHROPIC_BASE_URL": "https://api.anthropic.com" } }
中转 API 配置模板
{ "env": { "ANTHROPIC_BASE_URL": "https://你的中转地址.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的中转密钥" } }

💡 使用中转 API 时，密钥变量名可以是ANTHROPIC_AUTH_TOKEN或ANTHROPIC_API_KEY，二者等效。

7. 第三方模型配置（国内用户必看）

Claude Code 支持三种模型接入模式，可根据你的 API 提供商选择对应方式。

7.1 模式一：Anthropic 兼容模式（最常用）

适用于：官方 API、模拟 Anthropic 协议的中转站、DeepSeek（Anthropic 兼容端点）

{ "env": { "ANTHROPIC_BASE_URL": "https://api.xxx.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } }

指定不同模型级别的映射：

{ "env": { "ANTHROPIC_BASE_URL": "https://api.xxx.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514", "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5-20251001", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-20250514", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-20250514" } }

7.2 模式二：OpenAI Compatible 模式

适用于：使用 OpenAI Chat Completions 协议的服务商（DeepSeek OpenAI 端点、智谱 GLM、通义千问等）

{ "env": { "CLAUDE_CODE_OPENAI_MODELS": "deepseek-chat,glm-4-plus,qwen-max", "OPENAI_BASE_URL": "https://api.deepseek.com/v1", "OPENAI_API_KEY": "sk-你的密钥" } }

⚠️ OpenAI Compatible 模式下，Claude Code 的部分内置功能（如网络搜索）可能不可用。

7.3 模式三：AWS Bedrock

适用于：使用 AWS 云服务的用户

{ "env": { "CLAUDE_CODE_USE_BEDROCK": "1", "AWS_REGION": "us-west-2", "AWS_ACCESS_KEY_ID": "你的AK", "AWS_SECRET_ACCESS_KEY": "你的SK", "ANTHROPIC_MODEL": "us.anthropic.claude-sonnet-4-20250514-v1:0" } }

7.4 模式四：Google Cloud Vertex AI

{ "env": { "CLAUDE_CODE_USE_VERTEX": "1", "CLOUD_ML_REGION": "us-east5", "ANTHROPIC_VERTEX_PROJECT_ID": "你的项目ID", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } }

8. CC Switch 可视化工具配置

CC Switch 是一个专为 Claude Code 打造的开源可视化模型切换工具（GitHub 5.9k+ stars），可以免去手动编辑配置文件的麻烦。

8.1 CC Switch 简介

特性说明
零侵入保留 Claude Code 原生使用体验
热切换切换模型无需重启
多模型支持DeepSeek、GLM、Qwen、Kimi、Claude 等
多设备同步支持配置文件云同步
本地路由通过 127.0.0.1:15721 实现协议转换

8.2 安装 CC Switch

# 通过 npm 安装 npm install -g cc-switch ​ # 启动 CC Switch cc-switch

当前（2026-07-01）最新版是CC-Switch-v3.16.5-Windows.msi

CC-Switch-v3.16.5-Windows.msi下载链接：https://github.com/farion1231/cc-switch/releases/download/v3.16.5/CC-Switch-v3.16.5-Windows.msi

8.3 CC Switch 配置步骤

  1. 启动 CC Switch：运行cc-switch或打开桌面应用

  2. 添加 Provider：点击「新增供应商」，填入以下信息：

    • 名称：自定义（如 "DeepSeek"）

    • Base URL：API 端点地址

    • API Key：你的密钥

    • 模型 ID：如deepseek-chat

  3. 选择激活：在供应商列表中点击激活

  4. 启动 Claude Code：claude即可使用配置的模型

8.4 CC Switch 工作原理

Claude Code → 127.0.0.1:15721（CC Switch 本地路由）→ 目标 API 服务商 ↓ 协议转换：Anthropic → OpenAI / 其他协议

9. VS Code / JetBrains IDE 集成

9.1 VS Code 集成

  1. 打开 VS Code

  2. 进入扩展市场，搜索Claude Code

  3. 安装官方扩展

  4. 在 VS Code 终端中运行claude即可

9.2 VS Code 中使用第三方模型

先按照第 6~8 节配置好环境变量或 settings.json，然后在 VS Code 终端中启动 Claude Code 即可自动读取配置。

9.3 JetBrains IDE 集成

  1. 打开 JetBrains IDE（如 IntelliJ IDEA、PyCharm）

  2. 进入Settings → Plugins

  3. 搜索并安装Claude Code插件

  4. 在内置终端中运行claude

10. 常见模型 API 配置速查表

10.1 DeepSeek（Anthropic 兼容端点） { "env": { "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek密钥", "ANTHROPIC_MODEL": "deepseek-chat" } } 10.2 DeepSeek（OpenAI 兼容端点） { "env": { "CLAUDE_CODE_OPENAI_MODELS": "deepseek-chat", "OPENAI_BASE_URL": "https://api.deepseek.com/v1", "OPENAI_API_KEY": "sk-你的DeepSeek密钥" } } 10.3 智谱 GLM / ZLM { "env": { "CLAUDE_CODE_OPENAI_MODELS": "glm-4-plus", "OPENAI_BASE_URL": "https://open.bigmodel.cn/api/paas/v4", "OPENAI_API_KEY": "你的智谱API密钥" } } 10.4 通义千问（Qwen） { "env": { "CLAUDE_CODE_OPENAI_MODELS": "qwen-max", "OPENAI_BASE_URL": "https://dashscope.aliyuncs.com/compatible-mode/v1", "OPENAI_API_KEY": "你的阿里云API密钥" } } 10.5 Kimi（Moonshot） { "env": { "CLAUDE_CODE_OPENAI_MODELS": "moonshot-v1-128k", "OPENAI_BASE_URL": "https://api.moonshot.cn/v1", "OPENAI_API_KEY": "你的Kimi API密钥" } } 10.6 硅基流动 { "env": { "CLAUDE_CODE_OPENAI_MODELS": "deepseek-v3,glm-4-plus", "OPENAI_BASE_URL": "https://api.siliconflow.cn/v1", "OPENAI_API_KEY": "你的硅基流动密钥" } } 10.7 火山引擎（豆包 Seed） { "env": { "CLAUDE_CODE_OPENAI_MODELS": "doubao-pro-256k", "OPENAI_BASE_URL": "https://ark.cn-beijing.volces.com/api/v3", "OPENAI_API_KEY": "你的火山引擎密钥" } }

11. 常见问题排查

11.1 安装问题

问题原因解决方案
npm install -g报错网络超时国内访问 npm 官方源慢设置淘宝镜像：npm config set registry https://registry.npmmirror.com
Permission denied权限不足Windows 以管理员运行；macOS/Linux 使用sudo npm install -g
node: command not foundNode.js 未安装按照第 3 节安装 Node.js
claude: command not foundClaude Code 未安装或 PATH 问题重新运行npm install -g @anthropic-ai/claude-code

11.2 配置问题

问题原因解决方案
API Key 无效 / 401密钥拼写错误或已过期检查ANTHROPIC_AUTH_TOKEN值，确认中转 Key 带sk-前缀
Base URL 404URL 格式错误Anthropic 协议 URL 末尾不加/v1；OpenAI 协议需加/v1
环境变量未生效需要重启终端setx设置后必须新开终端；settings.json 修改后重启claude
模型权限错误模型未开通在 API 提供商后台开通对应模型的调用权限
内置搜索不可用第三方模型限制使用/search off命令关闭搜索功能

11.3 使用问题

问题原因解决方案
响应很慢网络延迟或模型负载检查网络连接；尝试切换其他模型
中文回答质量差模型选择问题切换到中文优化更好的模型（如 GLM-4、Qwen）
文件读写权限报错目录权限不足确保 Claude Code 运行在项目目录中

11.4 查看当前配置

# 查看当前环境变量 echo $ANTHROPIC_BASE_URL # macOS/Linux echo %ANTHROPIC_BASE_URL% # Windows CMD echo $env:ANTHROPIC_BASE_URL # Windows PowerShell ​ # 在 Claude Code 会话中查看 claude> /config

12. 参考资料

官方文档

  • Claude Code 官方文档（中文）

  • Claude Code 模型配置

  • Claude Code 设置

  • API Key 管理

社区教程

  • Claude Code 安装配置完整指南 - 知乎

  • Claude Code 国内使用完整教程 - 火山引擎

  • Claude Code 安装教程（附适配国内模型） - 腾讯云

  • 安装与多模型切换（Windows/macOS） - ClaudeCN

  • Claude Code 国内安装 2026 最新教程 - 阿里云

  • Claude Code 接入第三方 API - 腾讯云

  • Claude Code API 配置 - 菜鸟教程

CC Switch 工具

  • CC Switch GitHub 仓库

  • CC Switch 保姆级教程 - 知乎

  • CC Switch 使用技巧 - 博客园

  • CC Switch 多设备同步 - 火山引擎

模型接入

  • DeepSeek V4 接入 Claude Code - CSDN

  • Claude Code + CC Switch 配置 - Apifox

  • 智谱 Claude API 兼容接口

  • AWS Bedrock 配置指南

标签： 网站建设 企业官网 项目流程 UI设计 前端开发

热门文章

文章分类

标签云

网站建设 响应式设计 用户体验 SEO优化 前端开发 小程序 电商平台 性能优化

相关文章

您可能感兴趣的其他内容

TI SoC PLL配置实战：从寄存器手册到HDMI时钟调试指南
2026/7/22 19:11:22 网站建设

TI SoC PLL配置实战：从寄存器手册到HDMI时钟调试指南

1. 项目概述：从寄存器手册到实战配置如果你曾经在嵌入式开发中，尤其是基于TI的复杂SoC（如AM335x, AM57x系列）进行过底层驱动开发，那么对PRCM（Power, Reset, and Clock Management）模块一定不会陌…...

阅读更多 →
Point Cloud Transformer（PCT）实战：Menghao模型92.6%准确率训练技巧
2026/7/22 19:10:03 网站建设

Point Cloud Transformer（PCT）实战：Menghao模型92.6%准确率训练技巧

Point Cloud Transformer（PCT）实战：Menghao模型92.6%准确率训练技巧 【免费下载链接】Point-Transformers Point Transformers 项目地址: https://gitcode.com/gh_mirrors/po/Point-Transformers Point Cloud Transformer（…...

阅读更多 →
实测ChatGPT搜索中国供应商：GEO优化的3个致命盲区
2026/7/22 19:09:55 网站建设

实测ChatGPT搜索中国供应商：GEO优化的3个致命盲区

实验背景做外贸的朋友经常问一个问题：我的独立站 SEO 排名不差，为什么询盘一直在掉？为了回答这个问题，我做了一个简单实验：用 ChatGPT 和 Perplexity 分别搜索 "推荐中国 CNC 精密加工供应商"，然…...

阅读更多 →

需要专业的网站建设服务？

联系我们获取免费的网站建设咨询和方案报价，让我们帮助您实现业务目标

立即咨询