免费使用Claude Code指南（Windows & macOS/Linux）
原创 | 本文已参与「新人创作礼」活动，一起开启技术创作之路 标签： AI编程 Claude 开发工具 效率优化
文章目录
1. 注册并获取API密钥
步骤详解：
注：新用户可获免费额度，足够日常开发使用
- 密钥格式：sk-xxxxxxxxxxxxxxxx
- 务必保存密钥（关闭页面后不可查看）
2. 安装Node.js环境
跨平台安装指南：
| Windows | 官网下载LTS版 → 默认选项安装 |
| macOS | brew install node（需提前安装Homebrew） |
| Linux | sudo apt update && sudo apt install nodejs npm（Ubuntu/Debian系适用） |
验证安装成功：
node -v# 应输出 v18.x 或更高
npm -v# 应输出 9.x 或更高
3. 安装Claude Code CLI
全局安装命令行工具：
npm install -g @anthropic-ai/claude-code
安装过程约1-3分钟，依赖网络稳定性
4. 配置环境变量
关键变量说明：
| ANTHROPIC_AUTH_TOKEN | 你的API密钥（sk-开头） | 身份验证 |
| ANTHROPIC_BASE_URL | https://api.aicodemirror.com/api/claudecode | 路由平台API地址 |
▍ Windows配置（永久生效）
setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.aicodemirror.com/api/claudecode"
又或者Windows 原生(powershell)
$env:ANTHROPIC_API_KEY="你的API_KEY"; iwr –useb "https://download.aicodemirror.com/env_deploy/env-deploy.ps1" | iex
重启终端或者重新打开新终端窗口后生效
▍ macOS/Linux配置（永久生效）
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.aicodemirror.com/api/claudecode"' >> ~/.zshrc
source ~/.zshrc# 立即生效
或者使用环境变量一键配置 macOS / Windows WSL / Linux
curl -fsSL https://download.aicodemirror.com/env_deploy/env-deploy.sh | bash -s — "你的API_KEY"
5. 开始使用
操作流程：
cd ~/your-project# 进入你的项目文件目录
claude# 启动交互界面
成功运行特征：
✅ Claude Code Activated | v1.2.3
> Enter your query: _
常用命令示例：
# 解释代码功能
/explain path/to/file.js
# 生成Python爬虫
/generate python scraper for news website
6. 常见问题排查
| 命令未找到 | 重装CLI：npm reinstall -g @anthropic-ai/claude-code |
| Invalid API Key | 检查密钥格式：需以sk-开头，且无空格 |
| Connection refused | 关闭代理或检查ANTHROPIC_BASE_URL拼写 |
| 响应速度慢 | 切换终端节点：export ANTHROPIC_BASE_URL=https://api.aicodemirror.com/api/claudecode |
下一步推荐：
- 高级玩法：《Claude Code插件开发实战》
- 成本优化：《用Qwen本地模型替代API调用》
创作声明：本文实测环境为 Windows 11 + Node 18.17 / macOS Ventura + Node 20.3，转载需附原文链接 👍 原创不易，点赞关注获取更新！ #ClaudeCode入门 #AI编程神器
引用来源： [1] Claude Code官方接入指南 [2] CSDN Markdown排版规范 [11] 技术文档模板实践 [12] 技术博客写作方法论
