Claude Code 完整安装与配置指南

从入门到精通：原生安装、国内模型配置与 CC-Switch 一键切换

📌 本文解决的问题：
1. 无需 Node.js 的原生安装方法
2. 国内网络环境下使用 Claude Code（DeepSeek/阿里云/火山引擎）
3. 使用 CC-Switch 图形化工具一键切换模型，告别手动改配置

一、Claude Code 简介

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，被称为"世界最强编程 Agent"之一。它不仅能生成代码，更能理解整个项目结构、自动执行命令、读写文件，成为真正的"AI 编程搭档"。

相比 Cursor 等 IDE 插件，Claude Code 的优势在于：

全项目理解
：自动分析整个代码库，而非单个文件
终端集成
：直接执行命令、运行测试、操作 Git
上下文记忆
：记住项目规范和你的编码习惯
成本可控
：支持切换至性价比更高的国产模型

二、安装方式详解（推荐原生安装）

方式一：原生安装（推荐，无需 Node.js）

⚠️ 注意：这是 Anthropic 官方推荐的安装方式，自动更新，无需 Node.js 环境。

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

验证安装：

claude --version

方式二：Homebrew 安装（macOS/Linux）

brew install --cask claude-code

方式三：WinGet 安装（Windows）

winget install Anthropic.ClaudeCode

方式四：npm 安装（传统方式，不推荐）

⚠️ 官方已将 npm 安装标记为"legacy"，原生安装更稳定。

npm install -g @anthropic-ai/claude-code

三、配置国外官方模型（Anthropic Claude）

3.1 获取 API Key

访问 Anthropic Console
注册/登录账号
进入 API Keys 页面，点击 Create Key
复制生成的 sk- 开头的密钥

3.2 配置环境变量

macOS/Linux（~/.zshrc 或 ~/.bash_profile）：

export ANTHROPIC_API_KEY="sk-your-api-key-here"

Windows PowerShell（临时）：

$env:ANTHROPIC_API_KEY="sk-your-api-key-here"

Windows（永久，需重启终端）：

setx ANTHROPIC_API_KEY "sk-your-api-key-here"

四、配置国内模型（无需翻墙）

由于网络限制，国内用户可通过配置国内大模型 API 使用 Claude Code。以下是三种主流方案：

方案一：DeepSeek（推荐，性价比高）

特点：模型性能强（DeepSeek-V3.2、DeepSeek-R1）、价格便宜，新用户有免费额度、兼容 Anthropic API 协议

步骤 1：获取 API Key

访问 DeepSeek 开放平台
注册账号，进入 API Keys 页面
创建 API Key 并复制

步骤 2：配置环境变量

macOS/Linux（~/.zshrc）：

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" export ANTHROPIC_AUTH_TOKEN="sk-your-deepseek-key" export ANTHROPIC_MODEL="deepseek-chat" export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-chat" export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-chat" export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-chat" export API_TIMEOUT_MS="600000"

Windows PowerShell（永久）：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-your-deepseek-key", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-chat", "User")

步骤 3：跳过登录限制

创建/编辑 ~/.claude.json（macOS/Linux）或 %USERPROFILE%\.claude.json（Windows）：

{ "hasCompletedOnboarding": true }

方案二：阿里云百炼 - 通义千问（Qwen）

特点：国内大厂，稳定性好、新用户赠送大量免费 Token、支持 Coding Plan（代码专用套餐）

配置项	内容
API Endpoint	https://dashscope.aliyuncs.com/apps/anthropic
Model Name	qwen3.6-plus / qwen3.5-plus / qwen3-coder-next
API Key	百炼控制台获取（sk- 或 sk-sp- 开头）

方案三：火山引擎（字节跳动）- 豆包/智谱/MiniMax/Kimi

特点：一站式多模型、Coding Plan 首月仅 9.9 元、多模态支持好（图片理解）

配置项	内容
API Endpoint	https://ark.cn-beijing.volces.com/api/coding
可选模型	kimi-k2.5 / qwen3.5-plus / glm-5 / MiniMax-M2.5

五、CC-Switch：模型切换神器（强烈推荐）

🚀 为什么需要 CC-Switch？
如果你厌倦了手动修改配置文件、频繁切换多个模型供应商，CC-Switch 是必装的图形化管理工具。它是专为 Claude Code、Codex、Gemini CLI 等 AI 编程工具打造的跨平台配置管理中心。

5.1 CC-Switch 核心优势

痛点	传统方式	CC-Switch 方案
切换模型	手动编辑 JSON，易出错	一键切换，可视化界面，点击即生效
多供应商	环境变量混乱，管理困难	50+ 预设，内置主流供应商，开箱即用
配置备份	改崩了无法回滚	自动备份，保留最近 10 个配置版本
本地代理	无	智能路由、故障转移、请求日志可视化

5.2 安装 CC-Switch

macOS（推荐 Homebrew）

brew tap farion1231/ccswitch brew install --cask cc-switch

更新：brew upgrade --cask cc-switch

Windows

访问 GitHub Releases 页面
下载 CC-Switch-v{version}-Windows.msi 安装包（推荐）或便携版 ZIP
双击安装，若遇 SmartScreen 警告，选择"更多信息"→"仍要运行"

Linux

wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb sudo dpkg -i cc-switch_x.x.x_amd64.deb

5.3 首次配置（关键步骤）

步骤 1：开启应用到 Claude Code

打开 CC-Switch，点击左上角 "齿轮"图标 进入设置
在"通用"选项卡中，找到 "应用到 Claude Code 插件" 开关并开启
建议同时开启 "开机自启" 和 "本地代理"

步骤 2：添加供应商（以 DeepSeek 为例）

点击右上角 "+" 号 → "Add Provider"
选择预设 "DeepSeek"（或手动选择"Custom"自定义）
填写配置（见下表）

配置项	填写内容	说明
Provider Name	DeepSeek-V3	自定义名称，便于识别
API Endpoint	https://api.deepseek.com/anthropic	⚠️ 必须是 /anthropic 结尾
API Key	sk-xxx	你的 DeepSeek API Key
Model Name	deepseek-chat	或 deepseek-reasoner

步骤 3：启用配置

在主界面选中刚添加的供应商
点击 "Enable" 启用
系统托盘右键可快速切换

步骤 4：验证生效

claude # 输入 /status 查看当前模型是否为 deepseek-chat

5.4 配置国内主流模型（CC-Switch 方式）

阿里云百炼 - 通义千问

配置项	内容
API Endpoint	https://dashscope.aliyuncs.com/apps/anthropic
Model Name	qwen3.6-plus / qwen3.5-plus / qwen3-coder-next
API Key	百炼控制台的 sk- 或 sk-sp- 开头 Key

火山引擎 - 豆包/智谱/Kimi

配置项	内容
API Endpoint	https://ark.cn-beijing.volces.com/api/coding
Model Name	kimi-k2.5 / qwen3.5-plus / glm-5 / MiniMax-M2.5

5.5 高级功能：本地代理（强烈推荐开启）

本地代理的作用：

热切换
：在 CC-Switch 点一下切换模型，Claude Code 立刻生效，无需重启终端
统一管理
：Claude Code、Codex、OpenClaw 全部走同一个代理出口
请求日志
：在 CC-Switch 中查看详细请求记录，方便排查问题
故障转移
：主模型挂了自动切换备用模型，不中断开发

开启方法：

进入 CC-Switch 设置 → "本地代理" 选项卡
开启 "启用本地代理"
选择代理模式："全局代理" 或 "仅代理特定应用"
点击 "启动代理"

5.6 MCP 服务器统一管理

CC-Switch 支持可视化配置 MCP（Model Context Protocol）服务器：

点击 "MCP" 按钮进入管理面板
点击 "添加 MCP 服务器"
选择传输方式：stdio / http / sse
填写服务器配置，支持从 URL 导入（Deep Link）
一键同步
到所有客户端（Claude Code、Codex、Gemini CLI）

5.7 Skills 技能管理

安装技能（三种方式）：

方式 1：发现技能（推荐）

点击 "Skills" → "发现技能"
浏览 GitHub 热门 Skills 仓库
点击 "安装" 即可自动部署到 Claude Code

方式 2：导入已有技能 - 支持导入本地已下载的技能包文件夹

方式 3：从 ZIP 安装 - 下载技能 ZIP 压缩包，本地导入安装

推荐新手安装的技能：ui-ux-pro-max（UI 设计专用）、using-superpowers（技能使用指南）、writing-plans（计划编写）、executing-plans（计划执行）、brainstorming（头脑风暴）

六、配置方式对比总结

配置方式	适用场景	优点	缺点
手动环境变量	临时测试、单模型使用	简单直接，无需额外工具	切换麻烦，易出错
手动 settings.json	固定配置、团队协作	配置持久化，可版本控制	编辑繁琐，格式易错
CC-Switch（推荐）	多模型切换、日常开发	可视化、一键切换、自动备份、MCP/Skills 管理	需安装额外软件

七、常见问题解决

问题	解决方案
提示 "Unable to connect to Anthropic services"	在 `~/.claude.json` 中添加 `"hasCompletedOnboarding": true`
提示 "Command not found: claude"	检查 PATH 环境变量，原生安装检查 `~/.local/bin` 是否在 PATH 中
模型切换不生效	检查 `ANTHROPIC_BASE_URL` 是否正确（DeepSeek 必须是 `/anthropic` 结尾），使用 `/status` 确认当前模型
Windows PowerShell 执行策略限制	运行 `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`
返回 400 thinking type should be enabled or disabled	在 CC-Switch 通用配置中添加 `"claude_code_disable_adaptive_thinking": "1"`

八、总结与建议

使用场景	推荐方案	成本
追求最强性能	Anthropic 官方 Claude 3.7 Sonnet	较高
性价比优先	DeepSeek V3.2	低（有免费额度）
国内大厂稳定	阿里云百炼通义千问	中（新用户免费）
多模型切换	火山引擎 Coding Plan	低（首月 9.9 元）

💡 最后建议

对于国内用户，强烈推荐使用 CC-Switch + 国内模型（DeepSeek/阿里云/火山引擎） 的组合，既能享受 Claude Code 强大的 Agent 能力，又能避免网络问题和高昂成本。

安装 CC-Switch 后，你可以在 30 秒内完成模型切换，大幅提升开发效率。