Claude Code(命令行)#
通过配置文件的方式在电脑上安装和配置 Claude Code CLI(命令行工具)。Windows#
1. 安装 Node.js / Git#
如果出现版本号提示,就说明 Node.js 已经安装成功。需要注意的是,Node.js 的版本必须为 18+。如果低于这个版本,可以问一下 AI 如何升级 Node.js 版本,让 AI 先给您命令收集系统信息,之后它就会提供最快最准确的指导。
2. 安装 Claude Code CLI#
打开 PowerShell(建议以管理员身份运行)并执行:如果遇到“在此系统上禁止运行脚本”,需要用管理员权限运行 PowerShell,然后执行:Set-ExecutionPolicy Unrestricted
3. 创建配置文件#
打开 PowerShell(建议以管理员身份运行)并执行:
$dir = Join-Path $env:USERPROFILE ".claude"
$settingsFile = Join-Path $dir "settings.json"
$claudeJsonFile = Join-Path $env:USERPROFILE ".claude.json"
New-Item -ItemType Directory -Path $dir -Force | Out-Null
$settingsJson = @'
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "在这里替换成你的_API_KEY",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_BASE_URL": "https://api.moteapi.com"
}
}
'@
[System.IO.File]::WriteAllText($settingsFile, $settingsJson, (New-Object System.Text.UTF8Encoding($false)))
$claudeJson = @'
{
"hasCompletedOnboarding": true
}
'@
[System.IO.File]::WriteAllText($claudeJsonFile, $claudeJson, (New-Object System.Text.UTF8Encoding($false)))
Write-Host "配置完成!"
Write-Host " - settings.json: $settingsFile"
Write-Host " - .claude.json: $claudeJsonFile"
4. 验证安装#
重新打开 PowerShell 或者 IDE,运行:如果遇到下面的提示,选择第一个 yes,然后按回车即可。这是在提示你授权 Claude Code 访问并执行当前文件夹里的代码,用于读取、修改和运行项目文件。如果正常回复,并且后台有正确的调用记录,则说明配置成功。macOS#
1. 安装 Node.js#
首先需要确认您的电脑上有 Homebrew。如果没有,可以点击进入 Homebrew 官网,复制页面中的安装命令一键安装。安装 Homebrew 的时候,有一部分资源在海外,需要设置 TUN 代理。
安装好之后,使用 Homebrew 安装 Node.js(如果已经安装可以跳过):如果出现版本号提示,就说明 Node.js 已经安装成功。需要注意的是,Node.js 的版本必须为 18+。如果低于这个版本,可以问一下 AI 如何升级 Node.js 版本,让 AI 先给您命令收集系统信息,之后它就会提供最快最准确的指导。
2. 安装 Claude Code CLI#
3. 创建配置文件#
使用下面命令查看配置文件里的内容,一定别忘了替换 API Key:4. 验证安装#
如果遇到下面的提示,选择第一个 yes,然后按回车即可。这是在提示你授权 Claude Code 访问并执行当前文件夹里的代码,用于读取、修改和运行项目文件。如果正常回复,并且后台有正确的调用记录,则说明配置成功。Linux#
1. 安装 Node.js#
安装 Node.js 的命令(如果已经安装可以跳过):需要注意的是,Node.js 的版本必须为 18+。如果低于这个版本,可以问一下 AI 如何升级 Node.js 版本,让 AI 先给您命令收集系统信息,之后它就会提供最快最准确的指导。
2. 安装 Claude Code CLI#
最后那个提示是说当前 npm 的版本比较低,大家的可能没有,忽略即可。3. 创建配置文件#
使用下面命令查看配置文件里的内容,一定别忘了替换 API Key:4. 验证安装#
如果遇到下面的提示,选择第一个 yes,然后按回车即可。这是在提示你授权 Claude Code 访问并执行当前文件夹里的代码,用于读取、修改和运行项目文件。如果正常回复,并且后台有正确的调用记录,则说明配置成功。常见问题#
1. 无法连接到 Anthropic 服务#
错误截图#
解 决办法#
在 ~/.claude.json 文件中,添加一行:"hasCompletedOnboarding": true,
需要注意这行末尾有逗号,添加在 JSON 中间即可。2. 无效的 API 密钥 · 请运行 /login#
错误截图#
解决办法#
这个问题是因为环境变量没有设置好,可以参考前面的教程,重新设置环境变量。3. 401 {"error":"Invalid API key"}#
错误截图#
解决办法#
这个问题是因为 API Key 设置错了。可以去网站重新生成一个 API Key,然后参考前面的教程,重新设置 ANTHROPIC_AUTH_TOKEN 这个环境变量。