Claude Code 安装指南 (1) | Polaris的小站

type

Post

status

Published

date

Mar 29, 2026

slug

claudecode

summary

5分钟上手 Claude Code —— 从零到命令行 AI 助手。

前置要求

账号要求： Claude Code 需要 Pro、Max、Teams、Enterprise 或 Console 账号，免费版 Claude.ai 不包含 Claude Code 访问权限。

系统要求：

平台	版本要求
macOS	13.0 (Ventura) 或更高
Linux	Ubuntu 20.04+ / Debian 10+
Windows	10 (版本 1809+)

内存：至少 4GB（推荐 8GB）

需要稳定的网络连接

无需 GPU，所有 AI 计算在 Anthropic 服务器上进行

🌐 代理设置（Windows）

在 Windows 环境下，Claude Code 通过读取环境变量来识别代理配置。如果你需要通过特定网络通道访问 Anthropic API，请在安装前完成以下设置。

快速设置（当前会话生效）

临时使用代理时，在 PowerShell 中运行（将 127.0.0.1:7890 替换为你实际的代理地址）：

运行后直接输入 claude 即可。关闭终端后设置失效。

永久设置（推荐）

根据你习惯使用的终端，选择以下任一方式：

方式一：通过系统界面设置（PowerShell / 通用）

将代理写入系统环境变量，适用于所有终端：

按下 Win + R，输入 sysdm.cpl 并回车

点击 「高级」 选项卡 → 「环境变量」

在 「用户变量」 栏点击 「新建」：

变量名：HTTPS_PROXY

变量值：http://127.0.0.1:7890（根据你的代理软件端口修改）

重复步骤 3，添加 HTTP_PROXY

重启终端（PowerShell / VS Code）以生效

方式二：通过 CMD 命令行设置（setx）

如果你习惯使用 CMD（命令提示符），可直接用 setx 命令将代理写入系统：

⚠️ setx 执行后需重新打开一个新的 CMD 窗口才会生效。

执行后可验证是否生效：

若返回 http://127.0.0.1:7890，说明代理已成功注入。

安装方法

截至 2026 年 3 月，推荐使用原生 CLI 安装器，无需任何依赖，支持自动后台更新。

🍎 macOS

打开终端运行以下命令：

验证安装：

如果提示 command not found: claude，说明安装目录未加入 PATH，请按以下步骤操作：

zsh 用户（macOS 默认）：

bash 用户：

执行后再次运行 claude --version 验证是否生效。

可选：通过 Homebrew 安装 brew install claude-code，但需手动运行 brew upgrade claude-code 更新。

🪟 Windows

第一步：安装 Git for Windows

前往 git-scm.com/download/win 下载安装，保持默认设置，安装后重启终端。

第二步：安装 Claude Code（PowerShell）

或通过 WinGet：

⚠️ WinGet 方式不会自动更新，需定期运行 winget upgrade Anthropic.ClaudeCode。

第三步：验证安装

如果提示 'claude' 不是内部或外部命令，说明安装目录未加入系统 PATH。安装器通常会将 Claude Code 放在 %LOCALAPPDATA%\Programs\Claude\ 或类似目录，请将该路径加入系统环境变量：

按 Win + R，输入 sysdm.cpl 回车

点击「高级」→「环境变量」

在「系统变量」或「用户变量」中找到 Path，点击「编辑」

点击「新建」，粘贴 Claude Code 的安装路径（如 C:\Users\你的用户名\AppData\Local\Programs\Claude）

确认保存，重启终端后再次运行 claude --version 验证

🐧 Linux

验证：

如果提示 command not found: claude，请按以下步骤操作：

bash 用户（Linux 默认）：

其他 shell（如 sh / profile）：

执行后再次运行 claude --version 验证是否生效。

Alpine Linux 等基于 musl/uClibc 的发行版需额外安装 libgcc、libstdc++ 和 ripgrep，并设置 USE_BUILTIN_RIPGREP=0。

登录认证

安装完成后运行以下命令启动登录：

首次运行会自动打开浏览器，引导你登录 Anthropic 账号并完成授权。

CI/CD 或无界面环境，使用 API Key 方式：

验证与诊断

claude doctor 会输出系统配置、认证状态和检测到的问题详情，是排查安装问题的最佳起点。

开始使用

进入你的项目目录，启动 Claude Code：

命令	说明
`/help`	查看帮助
`claude doctor`	诊断环境问题
`claude --version`	查看版本

IDE 集成（可选）

VS Code：在扩展市场搜索 "Claude Code" 安装即可，会自动连接已安装的 CLI。

JetBrains：同样支持插件集成。

桌面 App：Anthropic 提供图形界面的桌面应用，登录 claude.ai 后可下载。

⚠️ 安全提醒

请务必只从官方地址（claude.ai）获取安装脚本，切勿使用第三方来源，以防恶意软件风险。

💬 遇到问题？

如果安装过程中遇到任何问题，可以直接去网页端向 Claude 提问：

👉 claude.ai

将报错信息或问题描述发给 Claude，它会帮你一步步排查解决。

📖 相关阅读

安装完成后，建议阅读下一篇：

Claude Code 起手式：用 CLAUDE.md 建立项目方案记忆