Claude Code 完整安装教程(2026最新版)

Claude Code 是 Anthropic 官方推出的终端 AI 编程助手，基于强大的 Claude 模型，支持自然语言交互式编程、代码生成、调试、Git 操作等。本教程覆盖 macOS / Linux / Windows 全平台安装方法。

一、安装前的环境准备

要求	说明
操作系统	macOS 11+ / Linux (Ubuntu 20.04+) / Windows 10/11
Node.js	≥ v18.0（使用原生安装方式可自动处理）
网络	需要稳定网络连接，国内用户建议配置代理
账号	Claude.ai 账号（Pro $20/月起）或 Anthropic API Key

⚠️ 国内用户注意

Claude Code 有地区检测机制，在国内直接使用可能遇到连接超时或 API 异常。建议提前配置好科学上网环境，或使用第三方中转 API 服务。

二、三种安装方法

方法一：原生一键安装（⭐ 推荐）

无需手动安装 Node.js，脚本自动处理一切依赖：

macOS / Linux：

# 安装稳定版curl -fsSL https://claude.ai/install.sh | bash# 安装最新版curl -fsSL https://claude.ai/install.sh | bash -s latest

Windows PowerShell：

# 安装稳定版irm https://claude.ai/install.ps1 | iex# 安装最新版irm https://claude.ai/install.ps1 | iex

Windows CMD：

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

方法二：包管理器安装

平台	命令
macOS (Homebrew)	`brew install --cask claude-code`
Windows (WinGet)	`winget install Anthropic.ClaudeCode`
npm (通用)	`npm install -g @anthropic-ai/claude-code`

方法三：VS Code / JetBrains 扩展

如果你更习惯在 IDE 中使用：

VS Code
：扩展市场搜索 Claude Code 安装
JetBrains
：Settings → Plugins 搜索 Claude Code 安装

三、验证安装

安装完成后，在终端执行：

claude --version

显示版本号即表示安装成功 ✅

🎉 安装成功！

看到类似 Claude Code v2.x.x 的输出，说明一切就绪。

四、首次启动与认证

进入项目目录

cd your-projectclaude

OAuth 浏览器授权

终端会自动打开浏览器，登录你的 Claude.ai 账号完成授权。

授权完成

令牌自动缓存到本地，后续无需重复登录。

企业用户 / API Key 方式：

# 设置 API Key 环境变量export ANTHROPIC_API_KEY=sk-ant-api03-xxxxxxxxxxxxx# 然后启动claude

五、初始化项目记忆

首次进入项目后，运行：

/init

这会在项目根目录生成 CLAUDE.md 文件，Claude Code 每次启动时会自动读取其中的项目约定、代码风格、技术栈等信息。

花几分钟填写 CLAUDE.md，可以大幅提升 Claude Code 对你项目的理解准确度。

六、常用命令速查表

命令	功能	使用场景
`claude`	启动交互模式	日常开发对话
`claude "描述任务"`	运行一次性任务	快速修复 / 查询
`claude -p "查询"`	运行查询后退出	脚本 / CI 集成
`claude commit`	自动生成 Git 提交	智能提交信息
`claude update`	手动更新	升级到最新版
`/help`	查看帮助	了解可用命令
`/clear`	清除对话历史	开启新话题
`/doctor`	健康检查	排查安装问题
`/init`	初始化 CLAUDE.md	项目配置
`/cost`	查看 Token 用量	费用管理

七、国内用户常见问题与解决方案

❌ 问题一：安装时连接超时

# 解决方案：配置终端代理后再执行安装命令# macOS / Linuxexport https_proxy=http://127.0.0.1:7890# Windows PowerShell$env:https_proxy="http://127.0.0.1:7890"

❌ 问题二：启动后 API 请求失败

方案 A：使用第三方 API 中转服务，设置环境变量：

export ANTHROPIC_BASE_URL="https://your-proxy-api.com"

方案 B：在 ~/.claude.json 中添加：

{  "hasCompletedOnboarding": true}

❌ 问题三：Windows 下 Git Bash 乱码

在 Git Bash 中执行：

export LANG=zh_CN.UTF-8export LC_ALL=zh_CN.UTF-8

八、使用最佳实践 🎯

善用 CLAUDE.md
：将项目规范、技术栈、目录结构写入 CLAUDE.md，Claude Code 会自动参考
任务拆分
：复杂任务拆成小步骤逐个完成，效果远好于一次性描述所有需求
善用 /clear
：上下文过长时及时清理，保持对话聚焦
代码审查习惯
：Claude 生成的代码仍需人工 Review，养成 git diff 检查的习惯
版本管理
：使用 claude commit 自动生成规范的提交信息

✦ ✦ ✦

总结
Claude Code 的安装非常简单，一行命令即可完成。对于国内用户，关键挑战在于网络连接——配置好代理或中转 API 后，就能畅享这款强大的 AI 编程助手了。

🚀 现在就开始你的 Claude Code 之旅吧！

如果觉得有用，欢迎 点赞 + 在看 支持 👇

Claude CodeAI编程开发工具教程

本文由 Claude Code 辅助生成 · 2026年6月