Login
Back to Blog
Claude Code 安装与使用指南 - AI 编程助手配置教程

Claude Code 安装与使用指南 - AI 编程助手配置教程

C
Crazyrouter Team
January 24, 2026
40 views中文Tutorial
Share:

Claude Code 是一款强大的 AI 编程助手,可以让你在终端中直接与 AI 协同工作。本文将带你完成安装和配置的全过程。

系统要求#

在安装 Claude Code 之前,请确认你的系统满足以下要求:

  • Node.js:版本 18.0 或更高
  • 操作系统:macOS、Linux 或 Windows(推荐使用 WSL)

快速开始#

第 1 步:安装 Node.js#

如果你已经安装了 Node.js 18.0 或更高版本,可以跳过此步骤。

Ubuntu / Debian#

bash
# Install Node.js LTS version
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# Verify installation
node --version

macOS#

bash
# Install Xcode command line tools
sudo xcode-select --install

# Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js via Homebrew
brew install node

# Verify installation
node --version

第 2 步:安装 Claude Code#

使用 npm 全局安装 Claude Code:

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

# Verify installation
claude --version

第 3 步:配置 API 访问#

要通过 Crazyrouter API 使用 Claude Code,你需要配置以下两个项目:

ConfigurationDescriptionHow to Obtain
ANTHROPIC_AUTH_TOKENAPI authentication tokenCreate a token on the API Tokens page (starts with sk-)
ANTHROPIC_BASE_URLAPI service addressUse https://crazyrouter.com/

推荐的 Token 设置:

  • 名称:任意有描述性的名称
  • 配额:开发环境建议设置为不限
  • 分组:选择 "Claude Code" 或 "Official Claude 3+"
  • 其他选项:保持默认设置即可

第 4 步:启动 Claude Code#

Linux / macOS#

bash
# Navigate to your project directory
cd your-project-folder

# Set environment variables
export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

# Launch Claude Code
claude

Windows PowerShell#

powershell
# Navigate to your project directory
cd your-project-folder

# Set environment variables
$env:ANTHROPIC_BASE_URL = "https://crazyrouter.com/"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-token-here"
$env:API_TIMEOUT_MS = "300000"

# Launch Claude Code
claude

Windows CMD#

cmd
# Navigate to your project directory
cd your-project-folder

# Set environment variables
set ANTHROPIC_BASE_URL=https://crazyrouter.com/
set ANTHROPIC_AUTH_TOKEN=sk-your-token-here
set API_TIMEOUT_MS=300000

# Launch Claude Code
claude

第 5 步:首次运行配置#

首次启动 Claude Code 后,你会看到如下配置步骤:

  1. 选择主题(Select Theme) - 选择你喜欢的配色主题并按 Enter
  2. 安全提示(Safety Notice) - 阅读并确认安全提示
  3. 终端配置(Terminal Configuration) - 使用默认配置或根据需要自定义
  4. 工作目录信任(Working Directory Trust) - 信任当前目录以允许访问文件

完成以上步骤后,你就可以开始与 AI 编程伙伴一起写代码了。

永久配置(可选)#

为避免每次都手动设置环境变量,可以将其写入你的 Shell 配置文件中:

Bash (~/.bashrc 或 ~/.bash_profile)#

bash
export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Zsh (~/.zshrc)#

bash
export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

添加完成后,重新加载你的 Shell:

bash
source ~/.bashrc  # or source ~/.zshrc

常见问题解答#

“Invalid API Key” 错误#

如果你看到 "Invalid API Key - Please run /login" 提示,请检查:

  • ANTHROPIC_AUTH_TOKEN 是否正确设置(需以 sk- 开头)
  • ANTHROPIC_BASE_URL 是否设置为 https://crazyrouter.com/
  • 设置环境变量后是否重启了终端

“Offline” 状态#

Claude Code 会通过连接 Google 检查网络状态。如果显示 "offline",并不会影响正常使用——这只表示当前无法连接到 Google 的服务器。

Web Fetch 失败#

Claude Code 在访问网页前会进行安全检查。请确保:

  • 网络连接稳定
  • 如有需要,使用全局代理

持续出现 “Fetch Failed” 错误#

这通常由网络问题引起。你可以尝试:

  1. 退出 Claude Code(Ctrl+C)
  2. 重新运行 claude 命令
  3. 若问题仍然存在,稍后再试

API 错误#

如果遇到 API 错误:

  • 退出 Claude Code(Ctrl+C)
  • 等待片刻后重新启动
  • 在控制台检查你的 Token 配额是否充足

重要说明#

  • Crazyrouter 提供到官方 Claude Code 服务的直接转发
  • 请妥善保管你的 API Token,切勿在公共环境中泄露
  • 在控制台监控你的使用量,以避免产生意外费用

价格说明#

Claude Code 通过 Crazyrouter 使用 Claude 模型,价格如下:

ModelInput PriceOutput Price
claude-opus-4-5$2.50/1M tokens$12.50/1M tokens
claude-sonnet-4-5$1.50/1M tokens$7.50/1M tokens
claude-haiku-4-5$0.40/1M tokens$2.00/1M tokens

以上价格在官方基础价的基础上提供约 45% 的折扣。

相关资源#


需要帮助?请联系支持团队,或查看 Crazyrouter documentation 以获取更多信息。

Related Articles