国内免费玩转ClaudeCode

Claude Code 是 Anthropic 公司推出的强大 AI 编程助手，通过命令行（CLI）提供代码生成、解释、调试和重构等能力。要在国内免费使用，核心在于解决网络访问和 API 调用问题。以下是一套清晰、可操作的“三步走”方案，结合了多种可行路径供您选择。

核心三步走方案概览

步骤	核心任务	关键操作与选择
第一步	准备基础环境	安装 Node.js & npm，安装 Claude Code CLI。
第二步	获取访问凭证	选择A： 通过第三方API中转平台获取免费额度。选择B： 配置国内可用的大模型API。
第三步	配置与启动	设置环境变量，验证并启动 Claude Code。

---

第一步：准备基础环境

这是使用 Claude Code CLI 的前提，无论后续采用哪种 API 方案，都需要完成此步骤。

1. 安装 Node.js 和 npm
   Claude Code 是一个 Node.js 包，因此需要先安装 Node.js 环境（版本建议 18+）。安装完成后，在终端中运行以下命令验证 ：

   node -v
   npm -v
   

2. 安装 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 的限制。

1. 注册平台获取API密钥：访问如 AnyRouter 等提供 Claude API 中转服务的平台（通常为新用户提供免费试用额度）。完成注册后，在控制台创建一个 API 密钥（通常以 sk- 开头）。
2. 记录关键信息：获取到的 API密钥 和该平台提供的 API基础地址（例如 https://anyrouter.top）。

方案B：配置国内大模型API（灵活，可长期使用）

Claude Code 支持通过 Model Context Protocol (MCP) 集成其他模型。您可以将其配置为使用国内可访问的大模型，如 DeepSeek、通义千问等 。

1. 选择模型服务：注册并获得一个国内大模型的 API 密钥和接口地址。
2. 安装对应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

验证与启动

1. 打开一个新的终端窗口（确保环境变量已加载）。
2. 导航到您的项目目录：cd /your/project/path
3. 输入启动命令：

   claude
   

4. 如果终端出现 Claude Code 的交互提示符（如 Claude>），说明配置成功，您可以开始输入自然语言指令让它协助编码了 。

应用场景示例

• 代码生成：在命令行中输入“用Python写一个快速排序函数”，Claude Code 会直接生成完整代码。
• 代码解释：将一段复杂的代码粘贴到对话中，并询问“这段代码是做什么的？”，它会逐行解释逻辑。
• 错误调试：将错误信息发给它，请求“分析这个错误并给出修复建议”。
• 代码重构：指令“优化这段代码的可读性”或“将这段JavaScript代码转换为TypeScript”。

通过以上三步，您就可以在国内环境下免费或低成本地启动并运用 Claude Code 的强大编程辅助功能。方案A适合希望快速上手、体验原生 Claude 能力的用户；方案B则为需要稳定、长期使用，且倾向于国产模型的用户提供了灵活选择 。

---