Claude Code 是目前公认的顶尖 AI Agent 软件之一。本教程将指导你在 Windows 系统上完成安装与基础配置。
一、安装 Claude Code
- 回到桌面，右键空白处，选择 “在终端中打开”。
- 在弹出的终端窗口中输入以下命令并回车：
npm install -g @anthropic-ai/claude-code- 等待安装完成即可。
二、基础配置（使用国内模型）
为了让 Claude Code 顺利运行，我们需要创建一份配置文件。
1. 显示隐藏文件
- 进入路径：
C:\Users\你的用户名 - 点击顶部菜单的 “查看”。
- 勾选 “隐藏的项目”（显示隐藏文件夹）。
- 勾选 “文件扩展名”。
2. 创建配置文件
- 在上述目录下，右键 → 新建 → 文本文档。
- 将文件名改为
.claude.json（确保去掉了.txt后缀）。 - 双击该文件，选择用 记事本 打开。
3. 编辑配置内容
将以下内容复制到文件中：
{
"hasCompletedOnboarding": true,
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的API Key",
"ANTHROPIC_BASE_URL": "模型厂商的URL",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
"ENABLE_TOOL_SEARCH": false
}
}三、获取并填写 API 信息
1. 获取 API Key
- 登录任意一家支持 Claude 模型的国内大模型厂商（如deepseek、kimi等）。
- 进入 “控制台” → “API 密钥管理”。
- 点击 “新建 API Key”，随意命名并创建。
- 复制生成的 Key，粘贴替换配置中的
"你的API Key"。
2. 获取 Base URL
- 在该厂商的文档中心，查找 “第三方应用接入” 或 “API 文档”。
- 找到对应的
Base URL（通常形如https://api.xxx.com/v1）。 - 复制该地址，粘贴替换配置中的
"模型厂商的URL"。
3. 保存配置
- 按
Ctrl + S保存文件。 - 关闭记事本。
四、启动与测试
- 再次回到桌面，右键 → 在终端中打开。
- 输入以下命令启动 Claude Code：
claude- 程序启动后，尝试发送一条消息（例如：“你好”）。
- 如果收到回复，恭喜你，配置成功！🎉