Claude Code
通过配置文件的方式在电脑上安装和配置 Claude Code CLI （命令行工具）
如果遇到问题，可以将本页全部内容和问题截图，复制给 豆包 或者 deepseek 等AI，按照他的提示执行对应命令即可
如果 AI 也无法解决，可以联系我们的工程师，为您提供技术上的支持与帮助
Windows
1. 安装 Node.js / Git
前往 Node.js 官网 下载并安装 LTS 版本。（如果已经安装可以跳过）
验证安装：
如果出现下面的提示就说明 node 已经安装成功了
需要注意的是，Nodejs 的版本必须为 18+
如果低于这个版本，可以问一下 AI 如何升级 Nodejs 版本，让 AI 先给您命令收集系统信息，之后它就会提供最快最准确的指导
前往 Git 官网，下载安装包，然后一路 yes 就行，都是英文的，不用管
2. 安装 Claude Code CLI
打开 PowerShell（建议以管理员身份运行）并执行：
1npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com/
如果遇到在此系统上禁止运行脚本，需要用管理员权限运行powershell，然后执行 Set-ExecutionPolicy Unrestricted 命令
3. 创建配置文件
打开 PowerShell（建议以管理员身份运行）并执行：
1# 目标目录：C:\Users\<you>\.claude
2$dir = Join-Path $env:USERPROFILE ".claude"
3$settingsFile = Join-Path $dir "settings.json"
4$claudeJsonFile = Join-Path $env:USERPROFILE ".claude.json"
5
6# 创建目录（存在不报错）
7New-Item -ItemType Directory -Path $dir -Force | Out-Null
8
9# 1. 写入 settings.json（API 配置）
10$settingsJson = @'
11{
12 "env": {
13 "ANTHROPIC_AUTH_TOKEN": "在这里替换成你的_API_KEY",
14 "ANTHROPIC_BASE_URL": "https://api.aicodewith.com"
15 }
16}
17'@
18[System.IO.File]::WriteAllText($settingsFile, $settingsJson, (New-Object System.Text.UTF8Encoding($false)))
19
20# 2. 写入 .claude.json（跳过登录）- 注意这个文件在用户根目录
21$claudeJson = @'
22{
23 "hasCompletedOnboarding": true
24}
25'@
26[System.IO.File]::WriteAllText($claudeJsonFile, $claudeJson, (New-Object System.Text.UTF8Encoding($false)))
27
28Write-Host "配置完成！"
29Write-Host " - settings.json: $settingsFile"
30Write-Host " - .claude.json: $claudeJsonFile"
4. 验证安装
重新打开 PowerShell 或者 IDE，运行：
如果遇到下面的提示，选择第一个 yes ，然后按回车即可
这是在提示你授权 Claude Code 访问并执行当前文件夹里的代码，用于读取、修改和运行项目文件
接下来在对话框里面可以输入：您好！如果正常回复，并且后台有正确的调用记录，则说明配置成功
macOS
1. 安装 Node.js
首先需要确认您的电脑上有 Homebrew ，如果没有的话，可以点击进去，有一行命令，一键复制就可以安装
安装 Homebrew 的时候，有一部分资源在海外，需要设置 TUN 代理
安装好之后，使用 Homebrew 安装 Nodejs（如果已经安装可以跳过）
请使用下面的命令，验证安装，如果出现下面的提示就说明 node 已经安装成功了
需要注意的是，Nodejs 的版本必须为 18+
如果低于这个版本，可以问一下 AI 如何升级 Nodejs 版本，让 AI 先给您命令收集系统信息，之后它就会提供最快最准确的指导
2. 安装 Claude Code CLI
新建终端，然后执行下面的命令：
1npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com/
3. 创建配置文件
新建终端，然后执行下面的命令：
1# 目标目录：~/.claude
2dir="$HOME/.claude"
3settingsFile="$dir/settings.json"
4claudeJsonFile="$HOME/.claude.json"
5
6# 创建目录（存在不报错）
7mkdir -p "$dir"
8
9# 1. 写入 settings.json（API 配置）
10cat > "$settingsFile" << 'EOF'
11{
12 "env": {
13 "ANTHROPIC_AUTH_TOKEN": "在这里替换成你的_API_KEY",
14 "ANTHROPIC_BASE_URL": "https://api.aicodewith.com"
15 }
16}
17EOF
18
19# 2. 写入 .claude.json（跳过登录）- 注意这个文件在用户根目录
20cat > "$claudeJsonFile" << 'EOF'
21{
22 "hasCompletedOnboarding": true
23}
24EOF
25
26echo "配置完成！"
27echo " - settings.json: $settingsFile"
28echo " - .claude.json: $claudeJsonFile"
使用下面命令，查看配置文件里的内容，一定别忘了替换 API KEY！
1cat "$HOME/.claude/settings.json"
4. 验证安装
重新打开 终端 或者 IDE，运行：
如果遇到下面的提示，选择第一个 yes ，然后按回车即可
这是在提示你授权 Claude Code 访问并执行当前文件夹里的代码，用于读取、修改和运行项目文件
接下来在对话框里面可以输入：您好！如果正常回复，并且后台有正确的调用记录，则说明配置成功
Linux
1. 安装 Node.js
安装 Nodejs 的命令（如果已经安装可以跳过）：
1curl -fsSL https://deb.nodesource.com/setup_lts.x | bash -
2apt-get install -y nodejs
验证安装：
需要注意的是，Nodejs 的版本必须为 18+
如果低于这个版本，可以问一下 AI 如何升级 Nodejs 版本，让 AI 先给您命令收集系统信息，之后它就会提供最快最准确的指导
2. 安装 Claude Code CLI
1npm install -g @anthropic-ai/claude-code
最后那个提示是说我当前npm的版本比较低，大家的可能没有，忽略就好
如果出现了其他问题，可以问一下 AI
3. 创建配置文件
新建终端，然后执行下面的命令：
1# 目标目录：~/.claude
2dir="$HOME/.claude"
3settingsFile="$dir/settings.json"
4claudeJsonFile="$HOME/.claude.json"
5
6# 创建目录（存在不报错）
7mkdir -p "$dir"
8
9# 1. 写入 settings.json（API 配置）
10cat > "$settingsFile" << 'EOF'
11{
12 "env": {
13 "ANTHROPIC_AUTH_TOKEN": "在这里替换成你的_API_KEY",
14 "ANTHROPIC_BASE_URL": "https://api.aicodewith.com"
15 }
16}
17EOF
18
19# 2. 写入 .claude.json（跳过登录）- 注意这个文件在用户根目录
20cat > "$claudeJsonFile" << 'EOF'
21{
22 "hasCompletedOnboarding": true
23}
24EOF
25
26echo "配置完成！"
27echo " - settings.json: $settingsFile"
28echo " - .claude.json: $claudeJsonFile"
使用下面命令，查看配置文件里的内容，一定别忘了替换 API KEY！
1cat "$HOME/.claude/settings.json"
4. 验证安装
重新打开 终端 或者 IDE，运行：
如果遇到下面的提示，选择第一个 yes ，然后按回车即可
这是在提示你授权 Claude Code 访问并执行当前文件夹里的代码，用于读取、修改和运行项目文件常见问题
接下来在对话框里面可以输入：hi，如果正常回复，并且后台有正确的调用记录，则说明配置成功
常见问题
1. 无法连接到 Anthropic 服务
错误截图
解决办法
在 ~/.claude.json 文件中，添加一行："hasCompletedOnboarding": true,
需要注意这行末尾有逗号，添加在 JSON 中间就好，如下图
2. 无效的 API 密钥 · 请运行 /login
错误截图
解决办法
这个问题是因为环境变量没有设置好，可以参考前面的教程，重新设置下环境变量
主要是这两个
ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN
3. 401 {"error":"Invalid API key"}
错误截图
解决办法
这个问题是因为 key 设置错了，可以去网站重新生成一个 key ，然后参考前面的教程，重新设置下环境变量 ANTHROPIC_AUTH_TOKEN 这个环境变量