Claude Code 安装与配置（详细教程）

多加点辣也没关系2026-03-21 15:31

目录

  • 前言
  • 一、简介
  • 二、环境准备
    • [2.1 系统支持](#2.1 系统支持)
    • [2.2 前置依赖](#2.2 前置依赖)
  • [三、Claude Code 的安装](#三、Claude Code 的安装)
    • [3.1 方式一：原生安装](#3.1 方式一：原生安装)
    • [3.2 方式二：npm 安装](#3.2 方式二：npm 安装)
  • 四、配置代理网络或者绕过IP校验
    • [4.1 方式一：配置代理网络](#4.1 方式一：配置代理网络)
    • [4.2 方式二：修改配置绕过IP校验](#4.2 方式二：修改配置绕过IP校验)
  • [五、配置 API Key 环境变量](#五、配置 API Key 环境变量)
    • [5.1 全局配置](#5.1 全局配置)
    • [5.2 配置文件内配置](#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+）。

bash 复制代码 
node --version
npm --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

bash 复制代码 
git --version

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

三、Claude Code 的安装

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

3.1 方式一：原生安装

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

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

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

macOS, Linux, WSL:

bash 复制代码 
curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

bash 复制代码 
irm https://claude.ai/install.ps1 | iex

Windows CMD:

bash 复制代码 
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

3.2 方式二：npm 安装

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

Linux/macOS 安装：

bash 复制代码 
# 全局安装 Claude Code
sudo npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

Windows 安装：

bash 复制代码 
# 以管理员身份打开 Powershell 或命令提示符

# 全局安装
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

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

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

bash 复制代码 
claude --help

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

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

bash 复制代码 
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

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，添加以下配置：

bash 复制代码 
"hasCompletedOnboarding": true,

然后保存即可

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

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

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

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

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

五、配置 API Key 环境变量

这里我以接入七牛云的 API 为例（因为之前七牛云上有活动，可以免费获取蛮多 token）

进入 七牛云 的 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

5.1 全局配置

bash 复制代码 
# 临时设置
set ANTHROPIC_API_KEY "sk-c6159***********************783a"
set ANTHROPIC_BASE_URL "https://api.qnaigc.com"
# 模型不设置默认使用 claude-4.6-sonnet
set ANTHROPIC_MODEL "qwen3-coder-480b-a35b-instruct" 

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

5.2 配置文件内配置

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

json 复制代码 
{
  "evn": {
    "ANTHROPIC_AUTH_TOKEN": "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、 模型不可用

或者

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

相关推荐
小七-七牛开发者17 分钟前
Personal Agent 真能越用越懂你吗？AdaptArena 揭示个性化 Web Agent 的失效链路
ai·agent·web agent·personal agent·adaptarena·个性化智能体
XLYcmy27 分钟前
AI 赋能后中文与英文数据库对比分析报告 上
数据库·ai·llm·prompt·检索·wos·cnki
独码侠1 小时前
第04篇·Codex Harness 审批×权限边界：4 档策略怎么选，密钥与仓库永远碰不到
ai·agent·codex
葵花日记2 小时前
VS2022 美化指南：用 ClaudiaIDE 设置自定义编辑器背景
ide·visualstudio·编辑器
ndsc_d2 小时前
AI生成的UI如何继续修改？画布内生成与独立AI设计工具比较
人工智能·ui·ai·ui设计·ai设计·ai设计工具·ai生成ui
土星云SaturnCloud3 小时前
土星云边缘计算+AI视觉+视频存管：连锁汽修数字化升级实践
服务器·人工智能·ai·边缘计算
Elastic 中国社区官方博客3 小时前
Elastic 线下 Meetup 将于 2026 年 12 月 19 号下午在西安举行
大数据·数据库·elasticsearch·搜索引擎·ai·数据分析·全文检索
解道Jdon3 小时前
FigCraft把Figma用Rust从零重写了一遍
ide·windows·git·svn·eclipse·github·visual studio
衣舞晨风3 小时前
一次升级引出两个BUG：API7 AI 网关流式 500 与低流量 CPU 打满排查
网关·ai·bug·异常排查
酒醉的胡铁4 小时前
相似度搜索的常见算法
算法·ai
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02历年考研数学一、数学二、数学三真题试卷及答案PDF03GitHub 镜像站点04「全语录+省流版」邵艾伦 × 孙宇晨：聊风口、聊个人IP、聊年轻人如何抓住 AI 时代的机会05Windows 10/11 如何退出微软账户并改用本地账户登录（含找不到选项的解决方法）06蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接07几个好用的ip纯净度检测网站08轻量化AI渗透武器库｜ARTEX自主攻防系统、资产梳理、漏洞挖掘、链路分析全流程智能化落地09如何新建文件夹？ 电脑新建文件夹的4种方法10Telegram APK 下载安装完整指南 — 2026年最新