
Claude Code 安装与使用指南 - AI 编程助手配置教程
Claude Code 是一款强大的 AI 编程助手,可以让你在终端中直接与 AI 协同工作。本文将带你完成安装和配置的全过程。
系统要求#
在安装 Claude Code 之前,请确认你的系统满足以下要求:
- Node.js:版本 18.0 或更高
- 操作系统:macOS、Linux 或 Windows(推荐使用 WSL)
快速开始#
第 1 步:安装 Node.js#
如果你已经安装了 Node.js 18.0 或更高版本,可以跳过此步骤。
Ubuntu / Debian#
# 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#
# 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:
npm install -g @anthropic-ai/claude-code
# Verify installation
claude --version
第 3 步:配置 API 访问#
要通过 Crazyrouter API 使用 Claude Code,你需要配置以下两个项目:
| Configuration | Description | How to Obtain |
|---|---|---|
| ANTHROPIC_AUTH_TOKEN | API authentication token | Create a token on the API Tokens page (starts with sk-) |
| ANTHROPIC_BASE_URL | API service address | Use https://crazyrouter.com/ |
推荐的 Token 设置:
- 名称:任意有描述性的名称
- 配额:开发环境建议设置为不限
- 分组:选择 "Claude Code" 或 "Official Claude 3+"
- 其他选项:保持默认设置即可
第 4 步:启动 Claude Code#
Linux / macOS#
# 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#
# 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#
# 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 后,你会看到如下配置步骤:
- 选择主题(Select Theme) - 选择你喜欢的配色主题并按 Enter
- 安全提示(Safety Notice) - 阅读并确认安全提示
- 终端配置(Terminal Configuration) - 使用默认配置或根据需要自定义
- 工作目录信任(Working Directory Trust) - 信任当前目录以允许访问文件
完成以上步骤后,你就可以开始与 AI 编程伙伴一起写代码了。
永久配置(可选)#
为避免每次都手动设置环境变量,可以将其写入你的 Shell 配置文件中:
Bash (~/.bashrc 或 ~/.bash_profile)#
export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000
Zsh (~/.zshrc)#
export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000
添加完成后,重新加载你的 Shell:
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” 错误#
这通常由网络问题引起。你可以尝试:
- 退出 Claude Code(Ctrl+C)
- 重新运行
claude命令 - 若问题仍然存在,稍后再试
API 错误#
如果遇到 API 错误:
- 退出 Claude Code(Ctrl+C)
- 等待片刻后重新启动
- 在控制台检查你的 Token 配额是否充足
重要说明#
- Crazyrouter 提供到官方 Claude Code 服务的直接转发
- 请妥善保管你的 API Token,切勿在公共环境中泄露
- 在控制台监控你的使用量,以避免产生意外费用
价格说明#
Claude Code 通过 Crazyrouter 使用 Claude 模型,价格如下:
| Model | Input Price | Output 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 以获取更多信息。


