HoRain云--2026最新ClaudeCode安装使用全攻略-编程实验室

🎬 HoRain云小助手：个人主页

🔥 个人专栏: 《Linux 系列教程》《c语言教程》

⛺️生活的理想，就是为了理想的生活!

⛳️ 推荐

前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。

专栏介绍

专栏名称	专栏介绍
《C语言》	本专栏主要撰写C干货内容和编程技巧，让大家从底层了解C，把更多的知识由抽象到简单通俗易懂。
《网络协议》	本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘，一起解密网络协议在运行中协议的基本运行机制！
《docker容器精解篇》	全面深入解析 docker 容器，从基础到进阶，涵盖原理、操作、实践案例，助您精通 docker。
《linux系列》	本专栏主要撰写Linux干货内容，从基础到进阶，知识由抽象到简单通俗易懂，帮你从新手小白到扫地僧。
《python 系列》	本专栏着重撰写Python相关的干货内容与编程技巧，助力大家从底层去认识Python，将更多复杂的知识由抽象转化为简单易懂的内容。
《试题库》	本专栏主要是发布一些考试和练习题库（涵盖软考、HCIE、HRCE、CCNA等）

⛳️ 推荐

专栏介绍

Claude Code 安装与使用指南：2026年最新版

3. 配置环境变量（macOS/Linux）

四、配置Claude Code（Windows用户特别步骤）

1. MCP（Multi-Context Protocol）配置

Claude Code 安装与使用指南：2026年最新版

Claude Code作为目前最强大的命令行AI编程工具，已从最初的仅支持macOS和Linux扩展到完整支持Windows系统。无需WSL环境，Windows用户现在可以直接安装使用。以下是最新、最完整的安装与使用指南。

一、前置条件准备

1. Node.js 18+（必备）

安装方式：

验证安装：

node -v # 应显示 v18.x 或更高版本 npm -v # 应显示版本号

💡重要提示：Windows用户如果没有正确安装Git，会遇到"Could not find git"错误。如果遇到此问题，请将CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\git\bin\bash.exe添加到系统环境变量中，然后重启终端。

二、安装Claude Code

1. Windows安装步骤

打开命令提示符（CMD）或PowerShell
- 按Win+R输入cmd或powershell打开

全局安装Claude Code

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

🌐 注意：如果网络有问题，可以使用国内镜像源安装：
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com

验证安装
```
claude --version
```
- 如果显示版本号，表示安装成功

2. macOS/Linux安装步骤

打开终端

全局安装Claude Code

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

验证安装
```
claude --version
```

三、配置API Key

1. 获取API Key

推荐使用以下平台获取API Key（免费或低成本）：

智谱AI GLM Coding Lite（推荐）：
其他平台：
- UModelVerse（UModelverse控制台）
- Moacode（Moacode官网）

2. 配置环境变量（Windows）

按Win+R输入sysdm.cpl打开系统属性
点击"高级" → "环境变量"
在"用户变量"区域点击"新建"
创建以下三个环境变量：

变量名	变量值	说明
ANTHROPIC_AUTH_TOKEN	你的API Key	用于身份验证
ANTHROPIC_API_KEY	你的API Key	用于API访问
ANTHROPIC_BASE_URL	https://open.bigmodel.cn/api/anthropic	智谱API端点

💡重要提示：如果你使用其他平台，替换ANTRHOPIC_BASE_URL为对应平台的API端点

3. 配置环境变量（macOS/Linux）

# 临时设置（终端会话期间有效） export ANTHROPIC_AUTH_TOKEN=your_api_key export ANTHROPIC_API_KEY=your_api_key export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic # 永久设置（添加到~/.bashrc或~/.zshrc） echo 'export ANTHROPIC_AUTH_TOKEN=your_api_key' >> ~/.bashrc echo 'export ANTHROPIC_API_KEY=your_api_key' >> ~/.bashrc echo 'export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic' >> ~/.bashrc source ~/.bashrc

四、配置Claude Code（Windows用户特别步骤）

Windows用户需要额外配置.claude.json文件：

在Git Bash中操作（不是CMD）
- 在项目文件夹右键 → "Git Bash Here"

安装jq工具（用于配置）

# 下载jq curl -L https://github.com/stedolan/jq/releases/latest/download/jq-win64.exe -o /tmp/jq.exe # 安装到用户目录 mkdir -p ~/bin mv /tmp/jq.exe ~/bin/jq.exe export PATH=$PATH:~/bin # 验证安装 jq --version

执行配置脚本

# 设置环境变量 export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic export ANTHROPIC_API_KEY=你的完整API密钥 # 执行配置脚本 (cat ~/.claude.json 2>/dev/null || echo 'null') | jq --arg key "${ANTHROPIC_API_KEY:-20}" '(.//{})|.customApiKeyResponses.approved|=([.[]?,$key]|unique)' > ~/.claude.json.tmp && mv ~/.claude.json.tmp ~/.claude.json

修复配置文件
```
nano ~/.claude.json
```

五、启动与使用

1. 基本使用

打开终端（确保环境变量已生效）
进入项目目录
```
cd your-project-folder
```
启动Claude Code
```
claude
```

2. 常用命令

命令	说明
`claude`	启动Claude Code交互界面
`claude --help`	查看帮助信息
`claude --version`	查看版本号
`claude --debug`	启动调试模式
`claude --model`	指定模型（如claude-3-5-sonnet）

3. 实际使用示例

# 生成一个Python函数 claude > 请写一个Python函数，计算斐波那契数列的第n项 # 修复代码错误 claude > 代码报错：NameError: name 'x' is not defined，请修复 # 重构代码 claude > 请重构以下代码，使其更简洁高效： # [粘贴代码]

六、进阶使用

1. MCP（Multi-Context Protocol）配置

MCP是Claude Code的高级功能，可让Claude访问更多外部工具：

安装MCP工具
```
npm install -g @anthropic-ai/mcp
```
配置MCP
- 创建~/.mcp/config.json文件
- 添加所需的MCP工具配置

2. Skills使用

Skills是Claude Code的"专业技能包"，让Claude在特定领域成为专家：

安装Skills
```
claude skills install <skill-name>
```
常用Skills

七、常见问题解决

1. Windows安装常见问题

问题	解决方案
"git not found"	确保Git已正确安装，且CLAUDE_CODE_GIT_BASH_PATH已设置
"command not found"	重启终端，确保环境变量已生效
安装失败	使用npm镜像源：`npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com`
配置不生效	重启终端或电脑，确保环境变量生效

2. API配置问题

问题	解决方案
"Invalid API Key"	检查API Key是否正确，确保没有空格
"Base URL not set"	确保ANTRHOPIC_BASE_URL已正确设置
无法连接	检查网络，确保能访问API端点

3. 其他问题

问题	解决方案
速度慢	确保使用的是最新版本的Claude Code
功能不全	检查是否启用了MCP和Skills
模型不支持	确认API Key支持的模型，使用`--model`参数指定