🎬 HoRain云小助手：个人主页

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

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

⛳️ 推荐

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

专栏介绍

专栏名称

专栏介绍

《C语言》

本专栏主要撰写C干货内容和编程技巧，让大家从底层了解C，把更多的知识由抽象到简单通俗易懂。

《网络协议》

本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘，一起解密网络协议在运行中协议的基本运行机制！

《docker容器精解篇》

全面深入解析 docker 容器，从基础到进阶，涵盖原理、操作、实践案例，助您精通 docker。

《linux系列》

本专栏主要撰写Linux干货内容，从基础到进阶，知识由抽象到简单通俗易懂，帮你从新手小白到扫地僧。

《python 系列》

本专栏着重撰写Python相关的干货内容与编程技巧，助力大家从底层去认识Python，将更多复杂的知识由抽象转化为简单易懂的内容。

《试题库》

本专栏主要是发布一些考试和练习题库（涵盖软考、HCIE、HRCE、CCNA等）

目录

⛳️ 推荐

专栏介绍

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

一、前置条件准备

1. Node.js 18+（必备）

2. Git（Windows用户必备）

二、安装Claude Code

1. Windows安装步骤

2. macOS/Linux安装步骤

三、配置API Key

1. 获取API Key

2. 配置环境变量（Windows）

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

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

五、启动与使用

1. 基本使用

2. 常用命令

3. 实际使用示例

六、进阶使用

1. MCP（Multi-Context Protocol）配置

2. Skills使用

七、常见问题解决

1. Windows安装常见问题

2. API配置问题

3. 其他问题

八、性能优化建议

九、总结

img

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

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

一、前置条件准备

1. Node.js 18+（必备）

  • 安装方式：

    • 访问 Node.js官网 下载LTS版本（推荐）
    • Windows：安装时选择"全部默认选项"，不要修改安装路径
    • macOS：使用Homebrew安装 brew install node
    • Linux：使用包管理器安装

  • 验证安装：

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

2. Git（Windows用户必备）

  • 安装方式：

    • 访问 Git for Windows官网 下载并安装
    • 安装时选择"全部默认选项"，不要修改安装路径
    • 选择"Use Git from the Windows Command Prompt"选项

  • 验证安装：

    git --version  # 应显示版本号

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

二、安装Claude Code

1. Windows安装步骤

  1. 打开命令提示符（CMD）或PowerShell

    • 按 Win+R 输入 cmd 或 powershell 打开

  2. 全局安装Claude Code

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

    🌐 注意：如果网络有问题，可以使用国内镜像源安装：

    npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com

  3. 验证安装

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

2. macOS/Linux安装步骤

  1. 打开终端
  2. 全局安装Claude Code 
    npm install -g @anthropic-ai/claude-code
  3. 验证安装 
    claude --version

三、配置API Key

1. 获取API Key

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

2. 配置环境变量（Windows）

  1. 按 Win+R 输入 sysdm.cpl 打开系统属性
  2. 点击"高级" → "环境变量"
  3. 在"用户变量"区域点击"新建"
  4. 创建以下三个环境变量：
变量名 变量值 说明
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文件：

  1. 在Git Bash中操作（不是CMD）

    • 在项目文件夹右键 → "Git Bash Here"

  2. 安装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

  3. 执行配置脚本

    # 设置环境变量
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

  4. 修复配置文件

    nano ~/.claude.json
    • 在"userID"行末尾添加逗号
    • 添加以下内容： 
      "customApiKeyResponses": {
  "approved": ["你的API密钥最后20个字符"]
}
    • 保存文件（按 Ctrl+X → Y → 回车）

五、启动与使用

1. 基本使用

  1. 打开终端（确保环境变量已生效）
  2. 进入项目目录 
    cd your-project-folder
  3. 启动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访问更多外部工具：

  1. 安装MCP工具

    npm install -g @anthropic-ai/mcp

  2. 配置MCP

    • 创建~/.mcp/config.json文件
    • 添加所需的MCP工具配置

2. Skills使用

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

  1. 安装Skills

    claude skills install <skill-name>

  2. 常用Skills

    • skills：查看可用的Skills
    • skills install python：安装Python相关技能
    • skills install git：安装Git相关技能

七、常见问题解决

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参数指定

八、性能优化建议

  1. 禁用非必要流量（在环境变量中添加）：

    export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

  2. 使用最新模型：

    • 确保API Key支持Claude 3.5 Sonnet或更高级别模型
    • 通过--model参数指定模型

  3. 定期清理缓存：

    claude cache clear

九、总结

Claude Code已从最初仅支持macOS和Linux，扩展到完整支持Windows系统，无需WSL环境，极大提升了Windows开发者的使用体验。通过合理配置API Key和环境变量，您可以在5分钟内完成安装并开始使用这款强大的AI编程助手。

"Claude Code不是另一个聊天窗口，不是另一个IDE。它在你已经工作的地方与你相遇，使用你正在使用的工具。" —— Claude Code设计理念

现在就行动起来：安装Claude Code，让AI成为您编程的得力助手，告别重复劳动，提升开发效率！

💡 提示：推荐使用智谱GLM Coding Lite，3个月仅需48.6元，性价比极高，适合大多数开发者。

❤️❤️❤️本人水平有限，如有纰漏，欢迎各位大佬评论批评指正！😄😄😄

💘💘💘如果觉得这篇文对你有帮助的话，也请给个点赞、收藏下吧，非常感谢!👍 👍 👍

🔥🔥🔥Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧！🌙🌙🌙

Logo
https://edu.csdn.net/learn/39067/627173?utm_source=2019755004

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

技术周报｜OpenCode登顶GitHub周榜，AI编程工具热度持续飙升

开源编程智能体。

avatar AI编程社区
cover

DeepSeek V4即将发布：中国AI的破局之作，能否颠覆编程领域？

avatar AI编程社区
cover

2026 年 Web 前端开发的 8 个趋势！

avatar AI编程社区