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、 模型不可用

或者

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

相关推荐
码码哈哈0.01 小时前
开源项目Heygem本地运行 AI 数字人模型
人工智能·ai
智算菩萨2 小时前
【How Far Are We From AGI】5 AGI的“道德罗盘“——价值对齐的技术路径与伦理边界
论文阅读·人工智能·深度学习·ai·接口·agi·对齐技术
拙野3 小时前
OpenClaw 安装使用指南 (Windows)-对接钉钉、飞书、QQ
ai·钉钉·飞书·openclaw
CoderJia程序员甲3 小时前
GitHub 热榜项目 - 日榜(2026-03-20)
人工智能·ai·大模型·github·ai教程
芯跳加速3 小时前
AI 视频自动化学习日记 · 第三天
人工智能·学习·ai·自动化·音视频
AI英德西牛仔3 小时前
豆包公式格式
人工智能·ai·deepseek·ds随心转
前端摸鱼匠3 小时前
面试题4：多头注意力（MHA）相比单头注意力的优势是什么？Head数如何影响模型？
人工智能·ai·面试·职场和发展·求职招聘
胡少侠74 小时前
LangChain 重构 RAG：LCEL 管道语法 + 多轮对话记忆
ai·重构·langchain·agent·rag
热门推荐
01GitHub 镜像站点02Qwen3.5 开源全解析：从 0.8B 到 397B，代际升级 + 全场景选型指南03小黑课堂计算机二级WPSoffice题库软件下载安装教程（2026年3月最新版）04Labelme从安装到标注：零基础完整指南05OpenClaw 使用和管理 MCP 完全指南06班级宠物园部署指南07AI 编程三剑客：Spec-Kit、OpenSpec、Superpowers 深度对比与实战指南08OpenClaw Control UI安全上下文访问配置09UV安装并设置国内源10Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services