主题
Claude Code 部署指南
前提条件
- 已安装 Node.js 18+
- 已 注册账号 并 创建 Key
推荐：使用 CC-Switch 配置（图形化）
推荐使用 CC-Switch 图形界面管理 Claude Code 配置，无需手动编辑文件。
配置步骤
- 全局安装 Claude Code：
bash
npm install -g @anthropic-ai/claude-code- 打开 CC-Switch，添加 Claude 配置
- 输入 API Base URL：
https://api.codekey.cc - 粘贴从 CodeKey 平台获取的 API Key
- 启用并重启 Claude Code
手动命令行配置
Windows
安装：
powershell
npm install -g @anthropic-ai/claude-code配置环境变量：
powershell
# PowerShell（当前会话）
$env:ANTHROPIC_AUTH_TOKEN="your-key"
$env:ANTHROPIC_BASE_URL="https://api.codekey.cc"
# 永久设置
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-key", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.codekey.cc", "User")启动：
powershell
claudemacOS
安装：
bash
npm install -g @anthropic-ai/claude-code配置环境变量：
bash
# 添加到 ~/.bash_profile 或 ~/.zshrc
export ANTHROPIC_AUTH_TOKEN="your-key"
export ANTHROPIC_BASE_URL="https://api.codekey.cc"
# 使配置生效
source ~/.zshrc启动：
bash
claudeLinux
安装：
bash
sudo npm install -g @anthropic-ai/claude-code配置环境变量：
bash
# 添加到 ~/.bashrc 或 ~/.zshrc
export ANTHROPIC_AUTH_TOKEN="your-key"
export ANTHROPIC_BASE_URL="https://api.codekey.cc"
# 使配置生效
source ~/.bashrc启动：
bash
claude系统要求
| 操作系统 | 最低版本 |
|---|---|
| Windows | Windows 10 |
| macOS | macOS 10.15+ |
| Linux | Ubuntu 18.04+ / CentOS 7+ / Debian 9+ |
常见问题
提示 command not found
- 检查 Node.js 是否正确安装
- 确认 npm 全局路径在 PATH 中
- 重新打开终端
连接失败
- 检查网络连接
- 确认 API Key 正确
- 验证环境变量设置
- 检查账户余额
API Key 无效
- 确认使用了 Claude Code 专用令牌组
- 检查 Key 是否过期或被禁用
- 重新创建 Key 并更新环境变量