新增国内直连 Base URL： https://api.highwayapi.ai/openai，原域名继续提供服务，详见产品文档

Claude Code国内安装配置完整教程：免翻墙使用指南

分类：技术交流发布时间：建议阅读时长：13分钟
作者：sodope llm

引言

Claude Code 是目前代码理解能力最强的 AI 编程助手之一，但国内开发者直接使用面临两道坎：安装依赖 npm 环境、API 调用需要翻墙且费用高。本文提供 2026 年最新的完整安装配置方案，从环境准备到 API 配置，手把手带你搞定，配合 jiekou.ai 中转 API 实现免翻墙、低成本使用。

环境准备

系统要求

Claude Code 支持以下系统：

  • macOS 10.15+
  • Linux（Ubuntu 18.04+、Debian 10+、CentOS 7+）
  • Windows 10/11（需通过 WSL2）

安装 Node.js

Claude Code 基于 Node.js，推荐使用 Node.js 18 或更高版本。

macOS / Linux（推荐用 nvm）：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载配置
source ~/.zshrc  # 或 source ~/.bashrc
# 安装并使用 Node.js 20
nvm install 20
nvm use 20
# 验证
node --version  # 应显示 v20.x.x
npm --version

Windows（WSL2）：

先在 Windows 应用商店安装 “Ubuntu”，然后在 WSL2 终端中执行上述 Linux 命令。

使用国内镜像加速 npm：

npm config set registry https://registry.npmmirror.com

安装 Claude Code

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

安装完成后验证：

claude --version

如果出现权限错误（macOS/Linux），尝试：

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

或者配置 npm 全局目录到用户目录（推荐）：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

获取 jiekou.ai API Key

国内使用 Claude Code，强烈推荐通过 jiekou.ai 中转 API，原因：

  • 无需翻墙：国内直连，延迟低
  • 价格低廉：比官方便宜 60%~90%
  • 支持支付宝/微信：无需海外信用卡

注册步骤：

  1. 访问 https://jiekou.ai，点击注册
  2. 完成手机号验证
  3. 进入控制台 → API Keys，创建新的 Key
  4. 复制 API Key（格式：sk-jk-xxxxxxxxxxxxxxxx）
  5. 记录 Base URL：https://api.hignwayapi.ai/openai

配置 API 密钥

方法一：环境变量（推荐）

这是最推荐的方式，一次配置，全局生效。

macOS / Linux：

# 编辑配置文件（根据你的 Shell 选择）
nano ~/.zshrc    # zsh 用户
# 或
nano ~/.bashrc   # bash 用户
# 添加以下两行
export ANTHROPIC_API_KEY="你的密钥"
export BASE_URL="https://api.highwayapi.ai/openai"
# 保存后执行
source ~/.zshrc  # 或 source ~/.bashrc

Windows（WSL2）：

echo 'export ANTHROPIC_API_KEY="你的密钥"' >> ~/.bashrc
echo 'export BASE_URL="https://api.highwayapi.ai/openai"' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell（原生，不推荐但可用）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的接口密钥", "User")
[System.Environment]::SetEnvironmentVariable("BASE_URL", "https://api.highwayapi.ai/openai", "User")

方法二：项目级 .env 文件

在项目根目录创建 .env 文件（注意加入 .gitignore）：

ANTHROPIC_API_KEY=你的接口密钥
BASE_URL=https://api.highwayapi.ai/openai

验证安装

执行以下命令测试：

claude "请用 Python 写一个读取 CSV 文件的函数"

正常情况下会看到类似：

Claude Code v1.x.x
> 好的，以下是一个读取 CSV 文件的 Python 函数：
def read_csv(file_path):
    import csv
    ...

如果看到类似报错，排查方法见下方。

常见安装问题解决

问题1：command not found: claude

原因：npm 全局目录不在 PATH 中

解决：

# 找到 npm 全局目录
npm root -g
# 将其上级目录加入 PATH
echo 'export PATH="$(npm root -g)/../bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

问题2：401 Unauthorized

原因：API Key 错误或 Base URL 未设置

解决：

# 检查环境变量是否正确设置
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_BASE_URL
# 确保没有多余空格或引号

问题3：Connection timeout 或连接超时

原因：网络问题或 Base URL 填写错误

解决：

# 测试 API 是否可达
curl https://api.jiekou.ai/v1/models \
  -H "Authorization: Bearer sk-jk-你的密钥"

如果 curl 也超时，检查 Base URL 是否正确。

问题4：Windows 下乱码

原因：终端编码问题

解决：在 PowerShell 中执行：

chcp 65001

或直接使用 WSL2 中的 Ubuntu 终端。

基础使用入门

安装配置好之后，进入你的项目目录开始使用：

cd my-project
claude

常用命令：

  • claude "问题或任务" — 单次对话
  • claude — 进入交互模式
  • /help — 查看所有可用命令
  • /compact — 压缩上下文（节省 Token）
  • /clear — 清空对话历史
  • Ctrl+C — 中断当前任务

总结

Claude Code 的国内安装配置并不复杂，关键是两点：Node.js 环境要装好，API 配置要用 jiekou.ai 中转。配置完成后，你就拥有了一个强大的 AI 编程助手，无需翻墙、费用透明可控。现在就去 jiekou.ai 注册，充值少量余额，马上开始你的 AI 编程之旅。

分享：
联系我们