Skip to main content

​
💡 准备工作

在开始之前，请确保您的环境满足以下要求：
  • 操作系统: Windows 10/11、macOS 10.15+、Ubuntu 20.04+ 或 Debian 10+
  • Node.js: 版本 18 或更高

​
Claude Code 安装与使用指南

​
1️⃣ 安装 Node.js (已安装可跳过)

注意：请确保您的 Node.js 版本 ≥ 18.0

​
windows 用户

# 下载并安装 Git for Windows
# 访问:https://git-scm.com/download/win
# 下载并安装 nodejs
# https://nodejs.org/zh-cn/download
# 验证版本
node --version

​
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 Command Line Tools
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

​
2️⃣ 安装 Claude Code

# 全局安装 claude-code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

​
3️⃣ 开始使用

​
步骤一：获取配置信息

  • Auth Token (ANTHROPIC_AUTH_TOKEN)
    • 注册后在 API令牌 页面点击 添加令牌 获得（以 sk- 开头）。
    • 名称随意，额度建议设为无限额度，其他保持默认设置即可。
  • API 地址 (ANTHROPIC_BASE_URL)
    • https://api.deerapi.com 是本站的 API 服务地址，与主站地址相同。

​
步骤二：运行 Claude Code (临时)

在您的项目目录下运行以下命令。这种方式只在当前终端会话中有效。 
# 进入你的项目文件夹
cd your-project-folder

# 设置环境变量 (请将 sk-... 替换为你的真实 Token)
export ANTHROPIC_AUTH_TOKEN=sk-... 
export ANTHROPIC_BASE_URL=https://api.deerapi.com

# 启动 Claude Code
claude
首次运行后，根据提示完成初始化设置：
  • 选择你喜欢的主题 + Enter
  • 确认安全须知 + Enter
  • 使用默认 Terminal 配置 + Enter
  • 信任工作目录 + Enter
现在，开始在终端里和你的 AI 编程搭档一起写代码吧！🚀

​
4️⃣ 配置环境变量（推荐）

为避免每次启动终端都重复输入 export 命令，建议将环境变量永久写入配置文件。

​
步骤一：写入配置

执行以下命令，它会自动将配置信息追加到 ~/.bash_profile, ~/.bashrc (用于 Bash) 和 ~/.zshrc (用于 Zsh) 文件中。 
# 将你的 Auth Token 写入配置文件 (请将 sk-... 替换为你的真实 Token)
echo -e '\nexport ANTHROPIC_AUTH_TOKEN="sk-..."' >> ~/.bash_profile
echo -e '\nexport ANTHROPIC_BASE_URL="https://api.deerapi.com"' >> ~/.bash_profile

echo -e '\nexport ANTHROPIC_AUTH_TOKEN="sk-..."' >> ~/.bashrc
echo -e '\nexport ANTHROPIC_BASE_URL="https://api.deerapi.com"' >> ~/.bashrc

echo -e '\nexport ANTHROPIC_AUTH_TOKEN="sk-..."' >> ~/.zshrc
echo -e '\nexport ANTHROPIC_BASE_URL="https://api.deerapi.com"' >> ~/.zshrc

​
步骤二：重启终端后使用

完全关闭并重新打开你的终端，让配置生效。之后，只需进入项目目录并运行 claude 即可。 
cd your-project-folder
claude

​
❓ FAQ

重要说明：本站服务仅作为官方 Claude Code 的转发代理，无法处理非 Claude Code 的 API 请求。
Q: 如遇 API 报错怎么办？
A: 这可能是由于转发代理网络瞬间不稳定导致的，可以尝试退出 Claude Code (/quit 或 Ctrl+C) 然后重试几次。 Q: 网页遇到登录错误怎么办？
A: 尝试清除本站相关的 Cookie，然后重新登录。 Q: 提示 Invalid API Key · Please run /login 怎么解决？
A: 这个错误表明 Claude Code 没有检测到 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 环境变量。请返回 第4步 仔细检查环境变量是否已正确配置并已重启终端。 Q: 为什么状态显示 offline？
A: Claude Code 会通过尝试连接 Google 来检测网络状态。显示 offline 仅仅表明它无法连接到 Google，这并不会影响您通过本代理正常使用 Claude Code 的核心功能。 Q: 为什么浏览网页 (Fetch) 功能会失败？
A: 这是因为 Claude Code 在访问网页前，会先调用 Claude 的一个原生服务来判断网页是否可以访问。这个原生服务需要国际互联网连接（通常需要全局代理）才能正常工作。 Q: 为什么请求总是显示 fetch failed？
A: 这可能是您所在地区的网络环境问题，导致无法稳定连接到我们的代理服务器。可以尝试开启系统代理工具后再试。