2026国内快速上手Claude Code

国内使用 Claude Code 的核心是：安装 Node.js + 安装 CLI + 配置国内中转/兼容 API 地址与密钥，无需翻墙即可稳定使用。以下是 2026 年实测可用的完整方案。

一、前置准备（必做）

1. 安装 Node.js（v18+，推荐 LTS）

   • Windows：官网下载 .msi 安装包，或 winget install OpenJS.NodeJS.LTS

   • macOS： brew install node

   • 验证： node -v 、 npm -v

2. 安装 Claude Code CLI

   npm install -g @anthropic-ai/claude-code
   

   验证： claude --version

用智谱 GLM / 通义千问 Code 等兼容 Anthropic 协议的国产模型，无需海外账号、国内支付。

1. 获取 API Key

   • 智谱 AI：https://open.bigmodel.cn/ → 注册实名 → 创建 API Key

   • 阿里云百炼 / 通义千问：https://www.aliyun.com/product/bailian → 开通 Code 服务

2. 配置环境变量（永久生效）

   • macOS/Linux （终端执行）

     export ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic
     export ANTHROPIC_AUTH_TOKEN=你的智谱API密钥
     export ANTHROPIC_MODEL=glm-5
     # 写入配置文件（永久）
     echo 'export ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic' >> ~/.zshrc
     echo 'export ANTHROPIC_AUTH_TOKEN=你的密钥' >> ~/.zshrc
     echo 'export ANTHROPIC_MODEL=glm-5' >> ~/.zshrc
     source ~/.zshrc
     

   • Windows （以管理员身份运行 PowerShell）

     [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.z.ai/api/anthropic", "User")
     [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的智谱API密钥", "User")
     [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "glm-5", "User")
     # 重启终端生效
     

3. 启动使用

   cd 你的项目目录
   claude
   

通过合规中转服务商（如灵芽 API、API易）调用 Claude 3.5/Opus，适合需要长上下文、复杂代码场景。

1. 获取中转密钥

   • 灵芽 API：https://api.lingyaai.cn/ → 注册 → 创建 Claude 专用 Token

   • API易：https://apiyi.com/ → 选择 Claude Code 模板

2. 配置环境变量

   • macOS/Linux

     export ANTHROPIC_BASE_URL=https://api.lingyaai.cn/v1
     export ANTHROPIC_AUTH_TOKEN=sk-你的中转密钥
     export ANTHROPIC_MODEL=claude-3-5-sonnet-20240620
     

   • Windows

     [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.lingyaai.cn/v1", "User")
     [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的中转密钥", "User")
     [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-3-5-sonnet-20240620", "User")
     

3. 启动

   claude
   

1. 连接失败/超时 ：检查 ANTHROPIC_BASE_URL 是否正确，重启终端；优先用国内兼容模型。

2. 密钥无效 ：中转服务商 Token 以 sk- 开头，确认复制完整、无空格。

3. 模型不响应 ：指定 ANTHROPIC_MODEL （如 claude-3-5-sonnet / glm-5 ）。

4. 安全提醒 ：仅在可信项目目录执行 claude ，避免授权敏感文件访问。

                                              # 测试连接
claude --check-connection
# 简单代码生成
claude "写一个Python快速排序函数"