Claude Code 安装配置最新详细教程

前言

AI编程助手遍地开花的今天，Anthropic的Claude Code算是杀出了一条血路。它的核心卖点“Agentic Coding”（智能体编程）可不是噱头——这玩意儿不是一个代码补全插件，而是一个直接在你终端里干活的AI同事。

这篇文章会带你把Claude Code从零跑通，从环境准备、跨平台安装、项目配置，到高级命令和最佳实践，一步步捋清楚。不管你是Mac、Linux还是Windows用户，都能找到适合自己的打开方式。

一、简介

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 --version
npm --version

如果还没装，去nodejs.org下载长期支持版（LTS）就行。

Git也需要装上——Claude Code在执行任务时会用到Git的bash命令，Git Bash是Windows下模拟Unix命令行的工具，能提供必要的终端环境。版本倒没什么特别要求。

检查Git是否安装：

git --version

三、Claude Code 的安装

Claude Code有两种安装方式，更推荐用npm安装。

3.1 方式一：原生安装

官方文档提供了几种安装方式：本地安装、Homebrew安装、WinGet安装，按文档操作就行。

直接复制官网的本地安装命令：

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

3.2 方式二：npm 安装

Claude Code基于npm安装：

Linux/macOS 安装：

# 全局安装 Claude Code
sudo npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version

Windows 安装：

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

这里演示Windows下的安装，Win + R 输入 cmd 调出命令提示符：

安装成功后，用以下命令查看帮助文档：

claude --help

四、配置袋里网络或者绕过IP校验

安装完Claude Code后，用 claude 命令就能启动。

claude

如果能直接访问外网，运行后它会正常启动，让你选一个主题：

选完主题后，它会提供三种登录方式：

• 订阅Claude账户（专业版、高级版、团队版、企业版）
• 使用API按量计费
• 第三方平台

不过在国内，大部分情况下没法直接访问外网，就会遇到下面这个报错：

Unable to connect to Anthropic services

Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

这是因为Claude Code会校验位置信息，国内没法直接用。两种解决办法：① 配置袋里网络 ② 修改配置绕过校验。这里更推荐方式二。

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:User{username} 目录下找到Claude的配置文件 .claude.json，添加以下配置：

"hasCompletedOnboarding": true,

保存即可。

做完配置后再次启动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。如果不设置模型，默认是 claude-4.6-sonnet。

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

• 接入DeepSeek API

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

创建一个API KEY：

打开接口文档：

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

5.1 全局配置

# 临时设置
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}.claudesettings.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、模型不可用

或者

换个模型，或者不设置模型试试。