Claude Code 安装使用教程

Claude Code 是一个强大的 AI 编程助手，让您可以直接在终端中与 AI 协作编程。本教程将指导您完成安装和配置过程。

📺 视频讲解：

https://www.bilibili.com/video/BV1USw1zYE7e/?spm_id_from=333.1387.homepage.video_card.click&vd_source=3242ad7662aff0ee7a54be6044f2b7c0

📋 系统要求

操作系统：macOS 10.15+、Ubuntu 20.04+/Debian 10+ 或 Windows 10+（带 WSL 或 Git for Windows）
硬件：4GB+ RAM
软件：Git（Windows 安装需要）、Node.js 18+（仅 NPM 安装需要）
网络：Anthropic 支持国家/地区的网络连接

🚀 安装 Claude Code

原生安装是最推荐的安装方法，拥有以下优势：

✅ 一个自包含的可执行文件
✅ 无 Node.js 依赖
✅ 改进的自动更新程序稳定性

💡 如果您已有 Claude Code 的现有安装，请使用 claude install 迁移到原生二进制安装。

🪟 Windows 系统安装

步骤 1：安装 Git For Windows

在 Windows 上原生安装 Claude Code 需要通过 Git Bash。

下载地址：

https://git-scm.com/install/windows

下载系统对应版本，默认选项安装即可。验证安装命令：

git --version

步骤 2：安装 Claude Code

打开 PowerShell 或 CMD 终端运行以下安装命令：

PowerShell 安装命令：

irm https://claude.ai/install.ps1 | iex

CMD 安装命令：

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

以上都不行的话，就用这个命令：

winget install Anthropic.ClaudeCode

步骤 3：添加 PATH 环境变量

Claude 可执行文件所在的目录需要加入系统 PATH，否则 PowerShell 无法识别 claude 命令。参考路径：

C:\Users\你的用户名\.local\bin

添加步骤：打开系统属性 → 环境变量 → 编辑用户 PATH → 新建 → 添加上方的 Claude 安装路径。

完成后重启 PowerShell 终端或电脑即可。

🍎 macOS / 🐧 Linux 系统安装

Shell 安装命令（macOS / Linux / WSL）：

curl -fsSL https://claude.ai/install.sh | bash

Homebrew 安装命令（macOS / Linux）：

brew install --cask claude-code

💡 如果您已经安装了 Node.js 18.0 或更高版本，也可以使用 NPM 方式安装：

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

验证安装：

在新的终端输入以下命令验证是否成功安装：

claude --version

⚙️ 配置并开始使用

您需要准备两个重要的配置项：

ANTHROPIC_AUTH_TOKEN：API 认证令牌，注册后在「接口密钥」页面点击「创建新密钥」获得，选择 claude code 类型（以 sk- 开头）
ANTHROPIC_BASE_URL：API 服务地址，使用 https://letaicode.cn/claude

配置 settings.json

新建或修改 settings.json 配置文件：

Windows：C:\Users\用户名文件夹\.claude\settings.json
Mac / Linux：~/.claude/settings.json

写入以下配置信息（将 sk-你的API令牌 替换为您的实际令牌，ANTHROPIC_MODEL 可替换为其他模型 ID）：

{"env": {"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌","ANTHROPIC_BASE_URL": "https://letaicode.cn/claude","ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929","ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5-20251001"}}

Ubuntu/macOS 可通过 vi 或 vim 命令直接创建或修改：
vim ~/.claude/settings.json

启动 Claude Code

在您的项目目录下输入 claude 即可启动：

cd /path/to/your/projectclaude

初次运行配置

启动后，您将看到以下配置步骤：

选择主题 → 选择您喜欢的主题 + 按 Enter
安全须知 → 确认安全须知 + 按 Enter
Terminal 配置 → 使用默认配置 + 按 Enter
工作目录信任 → 信任当前目录 + 按 Enter

✨ 恭喜！ 现在您可以开始与您的 AI 编程搭档一起写代码了！

❓ 常见问题解答

Q：遇到 "Invalid API Key · Please run /login" 错误？

这表明 Claude Code 未检测到环境变量。请检查：

是否正确设置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
环境变量值是否正确（令牌以 sk- 开头）
如果使用了永久配置，是否重启了终端

Q：PowerShell 无法安装脚本，遇到执行策略报错？

以管理员身份启动 PowerShell，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

Q：为什么显示 "offline" 状态？

Claude Code 通过连接 Google 来判断网络状态。显示 "offline" 不影响正常使用，只是表明无法连接到 Google。

Q：为什么浏览网页的 Fetch 会失败？

Claude Code 在访问网页前需要调用 Claude 服务进行安全检查。您需要：

保持稳定的国际互联网连接
必要时使用全局代理

Q：请求总是显示 "fetch failed"？

可能是网络环境导致的问题，建议尝试使用代理工具。

Q：API 报错如何处理？

可能是转发代理不稳定导致的，建议：

退出 Claude Code（Ctrl+C）
重新运行 claude 命令
如果问题持续，请稍后再试

Q：网页登录错误？

尝试清除本站的 Cookie，然后重新登录。

🔗 相关链接

Claude Code 官方文档：https://docs.anthropic.com
Node.js 官方网站：https://nodejs.org

💡 如遇到其他问题，请查看官方文档或联系技术支持。