Claude Code

安装与更新

命令未找到

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

如何更新 Claude Code

Native Install（自动更新）Native Install 会自动在后台更新，也可以手动更新：

claude update

Homebrew

brew upgrade claude-code

WinGet

winget upgrade Anthropic.ClaudeCode

安装失败

排查步骤

检查网络连接
Windows 用户确保已安装 Git for Windows
查看详细错误信息
参考官方文档

Windows 需要 Git Bash

Claude Code 在 Windows 上需要 Git Bash 环境安装 Git for Windows

下载 Git for Windows
运行安装程序
重启终端后再运行 claude

或使用 WSL

wsl --install

配置问题

配置文件在哪里

macOS/Linux: ~/.claude/settings.json
Windows: C:\Users\你的用户名\.claude\settings.json

API 端点配置

Claude Code 使用 Anthropic 格式，端点不包含 /v1 路径

https://code.rayinai.com

API 连接失败

检查环境变量和网络连接

echo $ANTHROPIC_AUTH_TOKEN
curl -I https://code.rayinai.com

确认配置文件 ~/.claude/settings.json 中的配置正确

环境变量未生效

永久设置环境变量后需要重新打开终端

# 重新加载配置
source ~/.zshrc
# 验证
echo $ANTHROPIC_BASE_URL

使用问题

首次启动很慢

首次启动时 Claude Code 需要初始化配置，这是正常现象。后续启动会快很多

VS Code 扩展配置

配置步骤

打开配置目录 ~/.claude（Windows: C:\Users\你的用户名\.claude）
创建 config.json 文件
写入以下内容

{
  "primaryApiKey": "any-value"
}

重启 VS Code

primaryApiKey 值可以任意，只要字段存在即可

无法连接到 Anthropic 服务

如果出现以下错误

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`	显示详细日志

错误排查

API 密钥无效

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

其他问题

联系技术支持

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

快速开始

CLI 配置

常见问题

安装与更新

配置问题

使用问题

错误排查

其他问题

联系技术支持

​安装与更新

​配置问题

​使用问题

​错误排查

​其他问题

联系技术支持

安装与更新

配置问题

使用问题

错误排查

其他问题