前言

在 AI 編程助手層出不窮的今天，Anthropic 推出的 Claude Code 以其獨(dú)特的 Agentic Coding（智能體編程） 理念脫穎而出。它不是一個(gè)簡單的代碼補(bǔ)全插件，而是一個(gè)直接運(yùn)行在你終端里的 AI 同事。

本文將為你提供一份手把手的教程，涵蓋從環(huán)境準(zhǔn)備、跨平臺安裝、項(xiàng)目配置，到高級命令與最佳實(shí)踐的完整流程。無論你是 Mac、Linux 還是 Windows 用戶，都能在這篇文章中找到屬于自己的 Claude Code 打開方式。

一、簡介

Claude Code 是一個(gè)運(yùn)行在終端中的AI智能體。與 Copilot 這類“下一行預(yù)測”工具不同，你只需要在命令行中描述任務(wù)目標(biāo)，它就能自主規(guī)劃步驟：讀取相關(guān)文件、理解整個(gè)代碼庫、執(zhí)行 Shell 命令、甚至操作 Git 提交，最終完成你的指令。

其核心優(yōu)勢在于：

• 上下文感知：通過智能體式搜索探索你的項(xiàng)目，而非簡單的索引。
• 工具調(diào)用：可以直接調(diào)用 Git、MCP 服務(wù)器等外部工具。
• 安全可控：默認(rèn)在執(zhí)行高風(fēng)險(xiǎn)操作（如寫入文件、運(yùn)行命令）前請求用戶授權(quán)。

產(chǎn)品官網(wǎng)：https://claude.com/product/claude-code

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

二、環(huán)境準(zhǔn)備

在安裝之前，請確保你的系統(tǒng)滿足以下要求。

2.1 系統(tǒng)支持

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

2.2 前置依賴

Claude Code 主要通過 npm 包分發(fā)，因此 Node.js 是必需項(xiàng)。

檢查 Node.js 是否安裝：win + R 輸入 cmd 打開終端輸入以下命令，確保版本在 16.0 以上（推薦 18+）。

node --version
npm --version

如果你還沒有安裝 Node.js，請前往 nodejs.org下載安裝長期支持版（LTS）。

關(guān)于 Node.js 的安裝可參考博客：Node.js 與 npm 的安裝與配置（詳細(xì)教程）

檢查 Git 是否安裝：版本不做要求

Claude Code 在執(zhí)行任務(wù)的時(shí)候會用到 Git 的一個(gè) bash 命令 ，Git Bash 是 Git for Windows 提供的一個(gè)模擬類 Unix 的命令行工具，它為 Claude Code 提供了必要的終端環(huán)境，支持執(zhí)行相關(guān)命令，所以需要安裝

可以通過查看 Git 版本號的命令驗(yàn)證是否安裝了 Git

git --version

如果沒有安裝 Git，可參考博客：Git - 的安裝與使用 進(jìn)行安裝

三、Claude Code 的安裝

Claude Code 有兩種安裝方式。個(gè)人比較推薦使用 npm 進(jìn)行安裝 ~

3.1 方式一：原生安裝

在官方文檔中提供了 Claude Code 的安裝方式

有本地安裝、Homebrew 安裝 和 WinGet 安裝，可以安裝官方文檔的方式來進(jìn)行安裝

這里我就直接復(fù)制官網(wǎng)上的 本地安裝 方式

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
# 驗(yàn)證安裝
claude --version

Windows 安裝：

# 以管理員身份打開 Powershell 或命令提示符
# 全局安裝
npm install -g @anthropic-ai/claude-code
# 驗(yàn)證安裝
claude --version

這里我就只演示在 Windows 下安裝，通過 Win + R 輸入 cmd 調(diào)出 命令提示符

安裝成功之后，可以通過以下命令查看幫助文檔：

claude --help

四、配置代理網(wǎng)絡(luò)或者繞過IP校驗(yàn)

當(dāng)我們安裝完 Claude Code 時(shí)通過 claude 命令便可以啟動

claude

如果你的電腦能夠直接訪問外網(wǎng)，那么運(yùn)行之后它 Claude Code 就能直接正常啟動讓你選擇一個(gè)主題

選擇主題之后它會提供三種登錄方式讓你選擇：

• 訂閱 Claude 賬戶，有專業(yè)版、高級版、團(tuán)隊(duì)版或企業(yè)版
• 使用 API 使用計(jì)費(fèi)方式
• 第三方平臺

以上情況之后的步驟我就不做贅述了，在國內(nèi)更多情況下我們是不能直接訪問外網(wǎng)的，就會出現(xiàn)以下情況

Unable to connect to Anthropic services

Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

運(yùn)行之后你會發(fā)現(xiàn)報(bào)了以上的錯(cuò)誤，這是因?yàn)?Claude Code 工具會校驗(yàn)位置信息，國內(nèi)是無法使用的，我們有兩種方式可以解決這個(gè)問題：① 配置代理網(wǎng)絡(luò) ② 修改配置繞過校驗(yàn)

PS：我個(gè)人是比較推薦使用方式二

4.1 方式一：配置代理網(wǎng)絡(luò)

在當(dāng)前項(xiàng)目目錄下創(chuàng)建 .claude/settings.json

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

這樣做是為了給 Claude Code 配置網(wǎng)絡(luò)代理，讓它在運(yùn)行時(shí)通過你指定的代理服務(wù)器（這里是 127.0.0.1:7890）來訪問外部網(wǎng)絡(luò)。

4.2 方式二：修改配置繞過IP校驗(yàn)

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

"hasCompletedOnboarding": true,

然后保存即可

做完以上配置我們再次啟動 Claude Code

就能發(fā)現(xiàn) Claude Code 是啟動成功的，它會問你是否需要去讀取這個(gè)目錄文件

如果我們選擇 Yes，它會出現(xiàn)一個(gè)報(bào)錯(cuò)，提示：not login

正常你啟動的話，它會用到 Claude Code 自帶的一個(gè)模型 Sonnet 4.6 模型，但這個(gè)模型是要收費(fèi)的，一個(gè)月最低也要 17$

這里我們可以使用 API 的方式，就不需要去登錄 Claude Code 的賬戶

五、配置 API Key 環(huán)境變量

這里我以接入 七牛云 和 deepSeek的 API 為例

• 接入七牛云API

進(jìn)入 七牛云 的 AI 大模型：https://www.qiniu.com/ai/agent

打開 七牛云 的控制臺，你可以創(chuàng)建一個(gè) API key：sk-c6159***********************783a

在 七牛云 的模型廣場，選擇一個(gè)模型，例如：qwen3-coder-480b-a35b-instruct
PS：模型可以不設(shè)置，如果不設(shè)置默認(rèn)是 claude-4.6-sonnet

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

• 接入DeepSeek API

打開 deepSeek 的 API 開放平臺

API 開放平臺：https://platform.deepseek.com/usage

然后創(chuàng)建一個(gè) API KEY

然后再打開接口文檔

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

5.1 全局配置

# 臨時(shí)設(shè)置
set ANTHROPIC_API_KEY "sk-c6159***********************783a"
set ANTHROPIC_BASE_URL "https://api.qnaigc.com"
# 模型不設(shè)置默認(rèn)使用 claude-4.6-sonnet
set ANTHROPIC_MODEL "qwen3-coder-480b-a35b-instruct" 
# 永久設(shè)置
setx ANTHROPIC_API_KEY "sk-c6159***********************783a"
setx ANTHROPIC_BASE_URL "https://api.qnaigc.com"
# 模型不設(shè)置默認(rèn)使用 claude-4.6-sonnet
setx ANTHROPIC_MODEL "qwen3-coder-480b-a35b-instruct" 

5.2 配置文件內(nèi)配置

在 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"
  }
}

這里我是通過全局配置設(shè)置 API 的，配置完之后這個(gè)時(shí)候我們就可以在項(xiàng)目中啟動 Claude Code

六、常見問題

1、 如果你按照以上方式配置好了 API ，但是使用 claude 命令運(yùn)行之后，它還是提示你登錄

我們可以關(guān)閉 開發(fā)軟件 或者重新打開一個(gè)文件夾，打開命令提示符，啟動 claude

選擇 Yes 之后，它會提示你是否要使用 API key

選擇 Yes，之后，就能跳過登錄了

2、 模型不可用

或者

重新?lián)Q個(gè)模型或者不進(jìn)行設(shè)置

到此這篇關(guān)于Claude Code 安裝與配置最新詳細(xì)教程的文章就介紹到這了,更多相關(guān)Claude Code 安裝與配置內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論