☰

企业官网建设流程全解析

首页 / 建站日记 / 企业官网建设流程全解析
Claude Code 安装与配置（详细教程）
2026/9/12 15:04:36 网站建设 项目流程

目录

  • 前言
  • 一、简介
  • 二、环境准备
    • 2.1 系统支持
    • 2.2 前置依赖
  • 三、Claude Code 的安装
    • 3.1 方式一：原生安装
    • 3.2 方式二：npm 安装
  • 四、配置代理网络或者绕过IP校验
    • 4.1 方式一：配置代理网络
    • 4.2 方式二：修改配置绕过IP校验
  • 五、配置 API Key 环境变量
    • 5.1 全局配置
    • 5.2 配置文件内配置
  • 六、常见问题

前言

在AI编程助手层出不穷的今天，Anthropic推出的Claude Code以其独特的Agentic Coding（智能体编程） 理念脱颖而出。它不是一个简单的代码补全插件，而是一个直接运行在你终端里的AI同事。

本文将为你提供一份手把手的教程，涵盖从环境准备、跨平台安装、项目配置，到高级命令与最佳实践的完整流程。无论你是Mac、Linux还是Windows用户，都能在这篇文章中找到属于自己的Claude Code打开方式。

一、简介

Claude Code是一个运行在终端中的AI智能体。与Copilot这类“下一行预测”工具不同，你只需要在命令行中描述任务目标，它就能自主规划步骤：读取相关文件、理解整个代码库、执行Shell命令、甚至操作Git提交，最终完成你的指令。

其核心优势在于：

  • 上下文感知：通过智能体式搜索探索你的项目，而非简单的索引。

  • 工具调用：可以直接调用Git、MCP服务器等外部工具。

  • 安全可控：默认在执行高风险操作（如写入文件、运行命令）前请求用户授权。

产品官网：https://claude.com/product/claude-code

中文文档：https://code.claude.com/docs/zh-CN/quickstart

二、环境准备

在安装之前，请确保你的系统满足以下要求。

2.1 系统支持

  • macOS: 10.14+
  • Linux: Ubuntu 18.04+, CentOS 7+, 以及其他主流发行版
  • Windows: Windows 10/11 (推荐使用 PowerShell 或 Git Bash)

2.2 前置依赖

Claude Code主要通过npm包分发，因此Node.js是必需项。

检查Node.js是否安装：win + R 输入 cmd打开终端输入以下命令，确保版本在16.0以上（推荐18+）。

node--versionnpm--version

如果你还没有安装Node.js，请前往 nodejs.org下载安装长期支持版（LTS）。

关于Node.js的安装可参考博客：Node.js 与 npm 的安装与配置（详细教程）

检查Git是否安装：版本不做要求

Claude Code在执行任务的时候会用到Git的一个bash命令 ，Git Bash是Git for Windows提供的一个模拟类Unix的命令行工具，它为Claude Code提供了必要的终端环境，支持执行相关命令，所以需要安装

可以通过查看Git版本号的命令验证是否安装了Git

git--version

如果没有安装Git，可参考博客：Git - 的安装与使用 进行安装

三、Claude Code 的安装

Claude Code有两种安装方式。个人比较推荐使用npm进行安装 ~

3.1 方式一：原生安装

在官方文档中提供了Claude Code的安装方式

有本地安装、Homebrew安装 和WinGet安装，可以安装官方文档的方式来进行安装

这里我就直接复制官网上的本地安装方式

macOS, Linux, WSL:

curl-fsSLhttps://claude.ai/install.sh|bash

Windows PowerShell:

irm https://claude.ai/install.ps1|iex

Windows CMD:

curl-fsSLhttps://claude.ai/install.cmd-oinstall.cmd&&install.cmd&&del install.cmd

3.2 方式二：npm 安装

Claude Code是基于npm的形式安装的：

Linux/macOS安装：

# 全局安装 Claude Codesudonpminstall-g@anthropic-ai/claude-code# 验证安装claude--version

Windows安装：

# 以管理员身份打开 Powershell 或命令提示符# 全局安装npminstall-g@anthropic-ai/claude-code# 验证安装claude--version

这里我就只演示在Windows下安装，通过Win + R输入cmd调出 命令提示符

安装成功之后，可以通过以下命令查看帮助文档：

claude--help

四、配置代理网络或者绕过IP校验

当我们安装完 Claude Code 时通过 claude 命令便可以启动

claude

如果你的电脑能够直接访问外网，那么运行之后它 Claude Code 就能直接正常启动让你选择一个主题

选择主题之后它会提供三种登录方式让你选择：

  • 订阅 Claude 账户，有专业版、高级版、团队版或企业版
  • 使用 API 使用计费方式
  • 第三方平台

以上情况之后的步骤我就不做赘述了，在国内更多情况下我们是不能直接访问外网的，就会出现以下情况

Unable to connect to Anthropic services

Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

运行之后你会发现报了以上的错误，这是因为 Claude Code 工具会校验位置信息，国内是无法使用的，我们有两种方式可以解决这个问题：① 配置代理网络 ② 修改配置绕过校验

PS：我个人是比较推荐使用方式二

4.1 方式一：配置代理网络

在当前项目目录下创建.claude/settings.json

{"evn":{"HTTP_PROXY":"http://127.0.0.1:7890","HTTPS_PROXY":"http://127.0.0.1:7890"}}

这样做是为了给 Claude Code 配置网络代理，让它在运行时通过你指定的代理服务器（这里是 127.0.0.1:7890）来访问外部网络。

4.2 方式二：修改配置绕过IP校验

在C盘下C:\User\{username}，找到claude的json配置文件.claude.json，添加以下配置：

"hasCompletedOnboarding":true,

然后保存即可

做完以上配置我们再次启动Claude Code

就能发现Claude Code是启动成功的，它会问你是否需要去读取这个目录文件

如果我们选择Yes，它会出现一个报错，提示：not login

正常你启动的话，它会用到Claude Code自带的一个模型Sonnet 4.6模型，但这个模型是要收费的，一个月最低也要17$

这里我们可以使用API的方式，就不需要去登录Claude Code的账户

五、配置 API Key 环境变量

这里我以接入七牛云和deepSeek的 API 为例

  • 接入七牛云API

进入 七牛云 的 AI 大模型：https://www.qiniu.com/ai/agent

打开 七牛云 的控制台，你可以创建一个 API key：sk-c6159***********************783a

在 七牛云 的模型广场，选择一个模型，例如：qwen3-coder-480b-a35b-instruct
PS：模型可以不设置，如果不设置默认是claude-4.6-sonnet

然后找到它的 Anthropic BaseURL：https://api.qnaigc.com

  • 接入DeepSeek API

打开 deepSeek 的 API 开放平台

API 开放平台：https://platform.deepseek.com/usage

然后创建一个API KEY

然后再打开接口文档

就能找到它的Anthropic BaseURL和模型了

5.1 全局配置

# 临时设置setANTHROPIC_API_KEY"sk-c6159***********************783a"setANTHROPIC_BASE_URL"https://api.qnaigc.com"# 模型不设置默认使用 claude-4.6-sonnetsetANTHROPIC_MODEL"qwen3-coder-480b-a35b-instruct"# 永久设置setx ANTHROPIC_API_KEY"sk-c6159***********************783a"setx ANTHROPIC_BASE_URL"https://api.qnaigc.com"# 模型不设置默认使用 claude-4.6-sonnetsetx ANTHROPIC_MODEL"qwen3-coder-480b-a35b-instruct"

5.2 配置文件内配置

在C:\Users\{uername}\.claude\settings.json添加以下配置：

{"env":{"ANTHROPIC_API_KEY":"sk-c6159***********************783a","ANTHROPIC_BASE_URL":"https://api.qnaigc.com","ANTHROPIC_MODEL":"qwen3-coder-480b-a35b-instruct","CLAUDE CODE ATTRIBUTION HEADER":"0"}}

这里我是通过全局配置设置API的，配置完之后这个时候我们就可以在项目中启动Claude Code

六、常见问题

1、 如果你按照以上方式配置好了 API ，但是使用 claude 命令运行之后，它还是提示你登录

我们可以关闭 开发软件 或者重新打开一个文件夹，打开命令提示符，启动claude

选择Yes之后，它会提示你是否要使用API key

选择Yes，之后，就能跳过登录了

2、 模型不可用

或者

重新换个模型或者不进行设置

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

热门文章

文章分类

标签云

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

相关文章

您可能感兴趣的其他内容

Vue3组件库选型指南与2026生态分析
2026/9/12 15:03:59 网站建设

Vue3组件库选型指南与2026生态分析

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …...

阅读更多 →
Beads `bd undefer` 命令实战：从 Icebox 恢复 Issue 的完整机制解析
2026/9/12 15:03:42 网站建设

Beads `bd undefer` 命令实战：从 Icebox 恢复 Issue 的完整机制解析

Beads bd undefer 命令实战：从 Icebox 恢复 Issue 的完整机制解析 【免费下载链接】beads Beads - A memory upgrade for your coding agent 项目地址: https://gitcode.com/GitHub_Trending/beads1/beads 本篇技术指南以 Beads 项目中 bd undefer 命令为绝对…...

阅读更多 →
max generate 命令完全指南：使用 MAX CLI 无服务端直连生成文本
2026/9/12 15:03:12 网站建设

max generate 命令完全指南：使用 MAX CLI 无服务端直连生成文本

max generate 命令完全指南：使用 MAX CLI 无服务端直连生成文本 【免费下载链接】mojo The Modular Platform (includes MAX & Mojo) 项目地址: https://gitcode.com/GitHub_Trending/mo/mojo 导读 max generate 是 Modular Platform（MAX&am…...

阅读更多 →

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

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

立即咨询