最新免费使用Claude Code指南（Windows & macOS/Linux）

免费使用Claude Code指南（Windows & macOS/Linux）

原创 | 本文已参与「新人创作礼」活动，一起开启技术创作之路
标签： AI编程 Claude 开发工具 效率优化

文章目录

注册并获取API密钥
安装Node.js环境
[安装Claude Code CLI](#安装Claude Code CLI)
配置环境变量
开始使用
常见问题排查

1. 注册并获取API密钥

步骤详解：

访问注册页面
打开浏览器 → 进入 [https://www.aicodemirror.com/register?invitecode=T18AM6) → 完成邮箱/手机号注册

注：新用户可获免费额度，足够日常开发使用

创建API密钥
登录后台 → 导航至 API密钥 → 点击 创建API秘钥

密钥格式：sk-xxxxxxxxxxxxxxxx
务必保存密钥 （关闭页面后不可查看）

2. 安装Node.js环境

跨平台安装指南：

系统	安装命令/操作
Windows	官网下载LTS版 → 默认选项安装
macOS	`brew install node`（需提前安装Homebrew）
Linux	`sudo apt update && sudo apt install nodejs npm`（Ubuntu/Debian系适用）

验证安装成功：

bash 复制代码

node -v# 应输出 v18.x 或更高
npm -v# 应输出 9.x 或更高

3. 安装Claude Code CLI

全局安装命令行工具：

bash 复制代码

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配置（永久生效）

cmd 复制代码

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.aicodemirror.com/api/claudecode"

又或者Windows 原生(powershell)

powershell 复制代码

$env:ANTHROPIC_API_KEY="你的API_KEY"; iwr -useb "https://download.aicodemirror.com/env_deploy/env-deploy.ps1" | iex

重启终端或者重新打开新终端窗口后生效

▍ macOS/Linux配置（永久生效）

bash 复制代码

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

bash 复制代码

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

5. 开始使用

操作流程：

bash 复制代码

cd ~/your-project# 进入你的项目文件目录
claude# 启动交互界面

成功运行特征：

复制代码

✅ Claude Code Activated | v1.2.3
> Enter your query: _

常用命令示例：

claude 复制代码

# 解释代码功能
/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$ 技术博客写作方法论