Claude Code 是一个强大的 AI 编程助手，Claude Code 是一种创新的编程工具，设计用于简化开发者的工作流程。通过其强大的功能和直观的界面，Claude Code 为各种项目提供了高效的解决方案。
主要特性
智能代码补全：借助AI技术，实时建议代码补全，提高编码效率。
跨平台支持：兼容多种操作系统，方便开发者在不同环境中使用。
灵活的插件系统：支持各种插件，扩展功能以满足特定需求。
易于集成：与常用开发工具无缝集成，简化开发流程。
使用场景：
Claude Code 适用于从Web开发到数据科学的广泛领域，帮助初学者和专业人员更快实现项目目标。
本教程将指导您完成安装和配置过程。
Node.js 版本 ≥ 18.0 支持的操作系统：macOS、Linux、Windows
提示：如果您已经安装了 Node.js 18.0 或更高版本，可以跳过此步骤。
Windows用户
打开node.js官方进行下载安装
Ubuntu / Debian 用户
#安装 Node.js LTS 版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs
# 验证安装
node --version
macOS 用户
# 安装 Xcode 命令行工具
sudo xcode-select --install
# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 通过 Homebrew 安装 Node.js
brew install node
# 验证安装
node --version
Windows用户
使用快捷键 WINDOWS + R，然后输入cmd，打开电脑终端
然后使用 npm 全局安装 Claude Code：
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version
然后好Claude Code后，我们还需要获取必要的配置信息，不然无法启动使用
前往https://xinghuapi.com/ 注册并登录，前往 控制台 -> API令牌 页面复制令牌备用。
您需要准备两个重要的配置项：
| 配置项 | 说明 | 获取方式 |
|---|---|---|
| ANTHROPIC_AUTH_TOKEN | API 认证令牌 | 注册后在 API令牌 页面点击 添加令牌 获得（以 sk- 开头） |
| ANTHROPIC_BASE_URL | API 服务地址 | 使用 https://xinghuapi.com（与主站地址相同） |
📝 创建令牌时的建议设置：
名称：随意命名 额度：设为无限额度 其他选项：保持默认设置
启动 Claude Code 在您的项目目录下运行：
Windows系统，使用终端cmd运行
进入项目目录
cd your-project-folder
#设置环境变量
set ANTHROPIC_AUTH_TOKEN=sk-... # 替换为您的实际令牌
set ANTHROPIC_BASE_URL=https://xinghuapi.com
# 启动 Claude Code
claude
初次运行配置
启动后，您将看到以下配置步骤：
- 选择主题 → 选择您喜欢的主题 + 按 Enter
- 安全须知 → 确认安全须知 + 按 Enter
- Terminal 配置 → 使用默认配置 + 按 Enter
- 工作目录信任 → 信任当前目录 + 按 Enter
✨ 恭喜！ 现在您可以开始与您的 AI 编程搭档一起写代码了！
在这里插入图片描述
Q: 遇到 "Invalid API Key · Please run /login" 错误？
A: 这表明 Claude Code 未检测到环境变量。请检查：
- 是否正确设置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
- 环境变量值是否正确（令牌以 sk- 开头）
- 如果使用了永久配置，是否重启了终端
Q: 为什么显示 "offline" 状态？
A: Claude Code 通过连接 Google 来判断网络状态。显示 "offline" 不影响正常使用，只是表明无法连接到 Google。
Q: 为什么浏览网页的 Fetch 会失败？
A: Claude Code 在访问网页前需要调用 Claude 服务进行安全检查。您需要：
- 保持稳定的国际互联网连接
- 必要时使用全局代理
Q: 请求总是显示 "fetch failed"？
A: 可能是网络环境导致的问题。解决方案：
尝试使用代理工具
Q: API 报错如何处理？
A: 可能是转发代理不稳定导致的，建议：
- 退出 Claude Code（Ctrl+C）
- 重新运行 claude 命令
- 如果问题持续，请稍后再试
Q: 网页登录错误？
A: 尝试清除本站的 Cookie，然后重新登录。
请妥善保管您的 API 令牌，避免泄露
🔗 相关链接
Claude Code 官方文档
Node.js 官方网站
💡 提示：如遇到其他问题，请查看官方文档或联系技术支持。