部署 Claude Code
安装和配置 Claude Code,开始使用 AI 编程助手。
Claude Code 是 Anthropic 官方出品的 AI 编程 CLI 工具,可在终端中使用 Claude 进行代码编写和调试。
安装方式
Windows 平台
使用 PowerShell 安装:
npm install -g @anthropic-ai/claude-code
macOS / Linux 平台
使用终端安装:
npm install -g @anthropic-ai/claude-code
或使用 Homebrew:
brew install claude-code
首次启动
Important Note
使用第三方中转服务时,Claude Code 首次启动可能会报错:“Unable to connect to Anthropic services”。这是正常现象,需要跳过初始确认。
方法一:使用 CC-Switch 工具(推荐)
CC-Switch 是一个图形化配置工具,可以一键完成所有配置。
- 下载并安装 CC-Switch
- 添加 Nebula API 配置
- 切换到 Nebula API 服务商
- 启动 Claude Code
方法二:手动配置
编辑 ~/.claude.json 文件,添加以下内容:
{
"hasCompletedOnboarding": true
}
然后配置环境变量:
# macOS / Linux
export ANTHROPIC_AUTH_TOKEN="your-api-key"
export ANTHROPIC_BASE_URL="https://ai.nebulatrip.com"
# Windows PowerShell
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key"
$env:ANTHROPIC_BASE_URL = "https://ai.nebulatrip.com"
验证安装
启动 Claude Code:
claude
如果看到 Claude Code 界面,说明安装成功。
配置说明
环境变量
| 变量名 | 说明 |
|---|---|
ANTHROPIC_AUTH_TOKEN | 您的 API Key |
ANTHROPIC_BASE_URL | API 端点地址 |
配置文件
配置文件位于 ~/.claude.json,主要参数:
{
"hasCompletedOnboarding": true,
"apiKey": "your-api-key",
"baseUrl": "https://ai.nebulatrip.com"
}
Tip
推荐使用环境变量方式配置,更安全且便于管理。
常见问题
连接失败?
- 检查网络连接是否正常
- 确认 API Key 是否正确
- 确认账户余额是否充足
- 检查是否选择了正确的令牌组
响应慢?
可以尝试:
- 使用 CC-Switch 的速度测试功能选择最快的节点
- 检查网络状况
环境变量不生效?
- Windows: 重启 PowerShell 或命令提示符
- macOS/Linux: 运行
source ~/.zshrc或source ~/.bashrc