国内免费玩转ClaudeCode
Claude Code 是 Anthropic 公司推出的强大 AI 编程助手，通过命令行（CLI）提供代码生成、解释、调试和重构等能力。要在国内免费使用，核心在于解决网络访问和 API 调用问题。以下是一套清晰、可操作的“三步走”方案，结合了多种可行路径供您选择。
核心三步走方案概览
| 步骤 | 核心任务 | 关键操作与选择 |
|---|---|---|
| 第一步 | 准备基础环境 | 安装 Node.js & npm，安装 Claude Code CLI。 |
| 第二步 | 获取访问凭证 | 选择A：通过第三方API中转平台获取免费额度。选择B：配置国内可用的大模型API。 |
| 第三步 | 配置与启动 | 设置环境变量，验证并启动 Claude Code。 |
第一步：准备基础环境
这是使用 Claude Code CLI 的前提，无论后续采用哪种 API 方案，都需要完成此步骤。
安装 Node.js 和 npm
Claude Code 是一个 Node.js 包，因此需要先安装 Node.js 环境（版本建议 18+）。安装完成后，在终端中运行以下命令验证 ：node -v npm -v安装 Claude Code CLI
通过 npm 全局安装 Claude Code 命令行工具。npm install -g @anthropic-ai/claude-code为了提高国内下载速度，可以使用淘宝镜像：
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
第二步：获取访问凭证（关键步骤）
这是在国内顺畅使用的核心。您可以根据自身情况选择以下两种主流方案之一：
方案A：使用第三方API中转服务（推荐，简单快捷）
此方案通过中转平台代理请求，绕开直接访问 Anthropic 官方 API 的限制。
- 注册平台获取API密钥：访问如AnyRouter等提供 Claude API 中转服务的平台（通常为新用户提供免费试用额度）。完成注册后，在控制台创建一个 API 密钥（通常以
sk-开头）。 - 记录关键信息：获取到的
API密钥和该平台提供的API基础地址（例如https://anyrouter.top）。
方案B：配置国内大模型API（灵活，可长期使用）
Claude Code 支持通过 Model Context Protocol (MCP) 集成其他模型。您可以将其配置为使用国内可访问的大模型，如 DeepSeek、通义千问等 。
- 选择模型服务：注册并获得一个国内大模型的 API 密钥和接口地址。
- 安装对应MCP服务器：例如，要使用 DeepSeek，可能需要安装对应的 MCP 服务器包。
npm install -g @modelcontextprotocol/server-deepseek
第三步：配置与启动
根据第二步选择的方案，进行相应的配置。
如果选择方案A（API中转）
需要设置两个环境变量，将 Claude Code 的请求指向中转服务器 。
- ANTHROPIC_AUTH_TOKEN: 您在第二步中获取的 API 密钥。
- ANTHROPIC_BASE_URL: 中转平台提供的 API 基础地址。
以 macOS/Linux 系统永久配置为例：
# 将配置添加到 shell 配置文件（如 ~/.zshrc 或 ~/.bashrc） echo "export ANTHROPIC_AUTH_TOKEN='你的API密钥'" >> ~/.zshrc echo "export ANTHROPIC_BASE_URL='https://anyrouter.top'" >> ~/.zshrc # 使配置立即生效 source ~/.zshrc以 Windows 系统永久配置为例：
在 PowerShell 或 CMD 中执行：
setx ANTHROPIC_AUTH_TOKEN "你的API密钥" setx ANTHROPIC_BASE_URL "https://anyrouter.top"注意：setx设置的环境变量需要重新打开终端才能生效。
如果选择方案B（国内大模型）
配置方式因具体集成的 MCP 服务器而异。通常需要设置该模型特定的环境变量，并在启动 Claude Code 时指定服务器。例如，配置豆包（Doubao）API ：
# 设置豆包API密钥 export DOUBAO_API_KEY='your_doubao_api_key_here' # 启动Claude Code并指定MCP服务器（此处为示例，具体命令需查看服务器文档） # claude --mcp-server @modelcontextprotocol/server-doubao验证与启动
- 打开一个新的终端窗口（确保环境变量已加载）。
- 导航到您的项目目录：
cd /your/project/path - 输入启动命令：
claude - 如果终端出现 Claude Code 的交互提示符（如
Claude>），说明配置成功，您可以开始输入自然语言指令让它协助编码了 。
应用场景示例
- 代码生成：在命令行中输入“用Python写一个快速排序函数”，Claude Code 会直接生成完整代码。
- 代码解释：将一段复杂的代码粘贴到对话中，并询问“这段代码是做什么的？”，它会逐行解释逻辑。
- 错误调试：将错误信息发给它，请求“分析这个错误并给出修复建议”。
- 代码重构：指令“优化这段代码的可读性”或“将这段JavaScript代码转换为TypeScript”。
通过以上三步，您就可以在国内环境下免费或低成本地启动并运用 Claude Code 的强大编程辅助功能。方案A适合希望快速上手、体验原生 Claude 能力的用户；方案B则为需要稳定、长期使用，且倾向于国产模型的用户提供了灵活选择 。