AI大模型ClaudeCode CLI全平台安装指南

ClaudeCode安装指南

国内不能访问外网的用户，可以通过这里安装：

https://www.aicodemirror.com/register?invitecode=BOJ5C0

邀请码 BOJ5C0

1 macOS/Linux ClaudeCode安装指南

1.1 系统要求

macOS 10.15+ 系统或 Linux 系统

1.2 安装步骤

（1）打开终端

使用 Cmd+Space 搜索 "Terminal" 或在应用程序 > 实用工具中找到终端

（2）复制并执行环境检查脚本

复制代码

$ curl -fsSL https://download.aicodemirror.com/env_deploy/env-install.sh | bash

（3）卸载已安装的Claude Code（未安装请跳过）

复制代码

$ npm uninstall -g @anthropic-ai/claude-code

（4）安装官方原版包

复制代码

$ npm install -g @anthropic-ai/claude-code

（5）在「API密钥」界面配置一个API Key

访问仪表板的「API密钥」页面，创建并复制一个新的API密钥

（6）复制并执行环境变量配置脚本

复制代码

$ curl -fsSL https://download.aicodemirror.com/env_deploy/env-deploy.sh | bash -s -- "你的API_KEY"

（7）重启终端，验证安装结果

重启终端后运行以下命令，确认安装成功

复制代码

$ claude -v

1.3 开始使用

安装完成后，您可以在任何项目目录中开始使用 Claude Code：

复制代码

# 导航到您的项目
$ cd your-project-folder

# 启动 Claude Code
$ claude

2 Windows ClaudeCode安装指南

2.1 系统要求

Windows 10 (版本 1809 / build 17763) 及以上

2.2 安装步骤

（1）【此步骤在桌面】下载git

访问 https://git-scm.com/downloads/win，安装时全都下一步，不要修改路径

（2）【此步骤在桌面】下载nodejs

访问 https://nodejs.org/zh-cn/download，安装时全都下一步，不要修改路径

（3）【此步骤在Windows PowerShell】验证安装情况

打开Windows PowerShell（蓝色图标），执行以下命令验证安装情况：

复制代码

PS> node -v
PS> npm -v

若提示「No suitable shell found」，是git没装好。请将 CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\git\bin\bash.exe 设置到系统环境变量中，重启终端再试。依旧无效，重装git，重启终端后再试

（4）【此步骤在Windows PowerShell】卸载已安装的Claude Code（未安装请跳过）

复制代码

PS> npm uninstall -g @anthropic-ai/claude-code

（5）【此步骤在Windows PowerShell】安装官方原版包

复制代码

PS> npm install -g @anthropic-ai/claude-code

（6）【此步骤在控制面板】设置Windows系统环境变量

需要设置以下三个环境变量：

变量名：ANTHROPIC_BASE_URL，变量值：https://api.aicodemirror.com/api/claudecode
变量名：ANTHROPIC_API_KEY，变量值：你的密钥
变量名：ANTHROPIC_AUTH_TOKEN，变量值：你的密钥

设置方法见上文「预备知识：修改环境变量」

（7）【此步骤在Windows PowerShell】重启Windows PowerShell，验证安装结果

重启Windows PowerShell后运行以下命令，确认安装成功

复制代码

PS> claude -v

2.3 开始使用

安装完成后，您可以在任何项目目录中开始使用 Claude Code：

复制代码

# 导航到您的项目
$ cd your-project-folder

# 启动 Claude Code
$ claude

2.4 常见问题

问题1: Unable to connect to Anthropic services

问题2: 401 Invalid token

• Win原生用户若配置完环境变量但不生效，请尝试以下步骤：

备份「C:\users\你的用户\.claude.json」文件
删除「C:\users\你的用户\.claude.json」文件
重新打开claude code，并在弹出的交互页「yes/no(recommended)」选项里选yes

• 若上述步骤执行完后依旧存在问题1，则执行下面步骤：

修改「C:\users\你的用户\.claude.json」文件，在最外层json中增加「"hasCompletedOnboarding": true」