Skip to main content

​
安装与更新

Native Install 或 Homebrew 安装检查安装是否成功：
claude doctor
如果提示命令未找到，重新安装：
# macOS Homebrew
brew install --cask claude-code

# macOS/Linux Native Install
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Native Install（自动更新）Native Install 会自动在后台更新，也可以手动更新：
claude update
Homebrew
brew upgrade claude-code
WinGet
winget upgrade Anthropic.ClaudeCode
排查步骤
  1. 检查网络连接
  2. Windows 用户确保已安装 Git for Windows
  3. 查看详细错误信息
  4. 参考 官方文档
Claude Code 在 Windows 上需要 Git Bash 环境安装 Git for Windows
  1. 下载 Git for Windows
  2. 运行安装程序
  3. 重启终端后再运行 claude
或使用 WSL
wsl --install

​
配置问题

  • macOS/Linux: ~/.claude/settings.json
  • Windows: C:\Users\你的用户名\.claude\settings.json
Claude Code 使用 Anthropic 格式，端点不包含 /v1 路径
https://code.rayinai.com
检查环境变量和网络连接
echo $ANTHROPIC_AUTH_TOKEN
curl -I https://code.rayinai.com
确认配置文件 ~/.claude/settings.json 中的配置正确
永久设置环境变量后需要重新打开终端
# 重新加载配置
source ~/.zshrc
# 验证
echo $ANTHROPIC_BASE_URL

​
使用问题

首次启动时 Claude Code 需要初始化配置，这是正常现象。后续启动会快很多
配置步骤
  1. 打开配置目录 ~/.claude（Windows: C:\Users\你的用户名\.claude）
  2. 创建 config.json 文件
  3. 写入以下内容
{
  "primaryApiKey": "any-value"
}
  1. 重启 VS Code
primaryApiKey 值可以任意，只要字段存在即可
如果出现以下错误
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com
解决方法运行以下命令跳过初次配置Windows (PowerShell)
$f="$env:USERPROFILE\.claude\settings.json"
$j=Get-Content $f|ConvertFrom-Json
$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force
$j|ConvertTo-Json|Set-Content $f
macOS/Linux
echo '{"hasCompletedOnboarding":true}' > ~/.claude/settings.json
重启 Claude CLI
命令功能说明
claude启动交互式 REPL
claude "问题"带初始问题启动
claude -p "问题"一次性问答模式
claude -c继续最近会话
claude update更新到最新版本
claude --verbose显示详细日志

​
错误排查

  • 确认密钥已正确复制（无多余空格）
  • 检查密钥是否在有效期内
  • 验证账户权限是否正常
  • Claude Code 使用 https://code.rayinai.com（无 /v1）

​
其他问题

联系技术支持

如果以上方法无法解决问题，请联系技术支持