我的 Claude Code 安装使用体验分享
大家好！今天我想和大家分享一下我最近安装和使用 Claude Code 的全过程。作为一个热爱在终端中工作的开发者，我发现这个工具真的大大提升了我的编码效率。下面是我详细的安装和配置过程，希望能帮助到同样对 AI 编程助手感兴趣的你！
我的系统环境要求
在开始安装前，我确认了我的系统满足以下要求：
- Node.js 版本 ≥ 18.0
- 支持的操作系统：macOS、Linux、Windows (WSL)
小贴士：我使用的是 macOS 系统，但这篇教程同样适用于 Linux 和 Windows(WSL) 用户。
我的安装之旅
1. 我是如何安装 Node.js 的
提示：如果你已经安装了 Node.js 18.0 或更高版本，可以跳过这一步，我当时是全新安装的。
作为 Ubuntu / Debian 用户的我
bash
# 我安装了 Node.js LTS 版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs
# 验证安装
node --version作为 macOS 用户的我（我的主要开发环境）
bash
# 首先，我安装了 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这一步我花了点时间，因为 Homebrew 的安装过程需要下载一些东西，但整体很顺利。安装完成后，我确认我的 Node.js 版本是 18.17.0，满足要求。
2. 安装 Claude Code 的过程
使用 npm 全局安装对我来说很简单：
bash
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version这一步执行后，我看到了版本号输出，证明安装成功了！我特别喜欢这种简洁的安装方式。
3. 配置并开始使用 Claude Code
获取必要的配置信息
为了使用 Claude Code，我需要准备两个关键的配置项：
| 配置项 | 说明 | 我的获取方式 |
|---|---|---|
| ANTHROPIC_AUTH_TOKEN | API 认证令牌 | 我在官网注册后进入API令牌页面，点击添加令牌获得（以sk-开头） |
| ANTHROPIC_BASE_URL | API 服务地址 | 我使用了https://makerend.com 价格相当实惠，对比官方还是十分推荐的！ |
我创建令牌时的设置：
- 名称：我命名为"claude-code-terminal"
- 额度：设为无限额度（因为我是重度用户）
- 分组：选择了Claude code专属分组
- 其他选项：保持默认设置
启动 Claude Code
在我的项目目录下，我是这样启动的：
bash
# 进入我的项目目录
cd ~/projects/my-awesome-app
# Linux/Unix设置环境变量
export ANTHROPIC_AUTH_TOKEN=sk-... # 替换为我的实际令牌
export ANTHROPIC_BASE_URL=https://makerend.com
export API_TIMEOUT_MS=300000 # 设置为 300 秒超时，因为大项目需要更长时间
# 启动 Claude Code
claude
bash
# Windows PowerShell 用户的我这样设置
$env:ANTHROPIC_BASE_URL = "https://makerend.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-..."
$env:API_TIMEOUT_MS = "300000" # 300秒超时
# Windows cmd 用户的备用方案
set ANTHROPIC_BASE_URL=https://makerend.com
set ANTHROPIC_AUTH_TOKEN=sk-...
set API_TIMEOUT_MS=300000
# 启动 Claude Code
claude我的初次运行配置体验
启动后，我经历了以下配置步骤，整个过程非常直观：
- 选择主题 → 我选择了深色主题 + 按 Enter
- 安全须知 → 我阅读并确认了安全须知 + 按 Enter
- Terminal 配置 → 我使用了默认配置 + 按 Enter
- 工作目录信任 → 我信任了当前项目目录 + 按 Enter
那一刻的感觉！当我看到 Claude Code 的界面出现在我的终端中时，我真的感到很兴奋。现在，我终于可以开始与我的 AI 编程搭档一起写代码了！
我在使用过程中遇到的问题及解决方案
在使用 Claude Code 的过程中，我也遇到了一些小问题，下面分享我的解决方法：
Q: 我遇到 "Invalid API Key · Please run /login" 错误？
我的解决方法：这表明 Claude Code 没有检测到我的环境变量。我检查了以下几点：
- 确保正确设置了
ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL - 验证环境变量值是否正确（我的令牌确实以
sk-开头） - 重新打开终端窗口，确保环境变量生效
Q: 为什么显示 "offline" 状态？
我发现：Claude Code 通过连接 Google 来判断网络状态。显示 "offline" 并不影响正常使用，只是表明无法连接到 Google。我在国内使用时经常看到这个状态，但功能完全正常。
Q: 为什么浏览网页的 Fetch 会失败？
我的经验：Claude Code 在访问网页前需要调用 Claude 服务进行安全检查。为了解决这个问题，我：
- 确保有稳定的网络连接
- 在必要时使用了代理工具
Q: 请求总是显示 "fetch failed"？
我的解决方案：这通常是网络环境导致的问题。我尝试了：
- 使用代理工具改善网络连接
- 检查防火墙设置，确保没有阻止 Claude Code 的连接
Q: API 报错如何处理？
我的应对策略：当遇到 API 报错时，我通常：
- 先按 Ctrl+C 退出 Claude Code
- 重新运行
claude命令 - 如果问题持续，我会稍后再试，或者检查是否有服务维护通知
我总结的注意事项
通过这段时间的使用，我总结了以下几点重要注意事项：
- 该服务直接接入官方 Claude Code 转发服务
- 仅支持 Claude Code 的 API 流量，不支持其他 API 调用
- 务必妥善保管 API 令牌，避免泄露（我将其保存在密码管理器中）
- 大型项目建议设置较长的超时时间（我设置为 300000 毫秒）
🔗 我常用的参考链接
在安装和使用过程中，我经常参考以下资源：
我的最后建议：如果你也喜欢在终端中工作，Claude Code 绝对值得尝试。虽然初期配置需要一些时间，但一旦设置好，它将成为你编码过程中不可或缺的伙伴。我在使用过程中遇到问题时，通常查阅官方文档或在社区中寻求帮助，大多数问题都能很快解决。
希望我的分享对你有所帮助！如果你有任何问题或想交流使用心得，欢迎在评论区留言讨论。Happy Coding! 🚀