Claude Code

Claude Code 快速接入 OpenAI Hub 教程

这篇教程的目的很简单：让你在国内也能顺畅使用 Claude Code，通过 OpenAI Hub 接入最新的主流模型，不用折腾代理。

1. 环境准备

Claude Code 依赖 Node.js 运行，所以你的系统必须先装好 Node.js。打开终端输入：

node -v

如果能看到版本号就说明装好了，建议 Node.js v18 或更高版本（2026年一般都是 v20+）。

如果没有安装，去 Node.js 官网 下载对应系统的版本就行。

搞定 Node.js 接下来就能安装 Claude Code。

2. 安装 Claude Code CLI

推荐用官方新推出的 原生安装方式（Native Install），更稳定，也能自动更新。

macOS / Linux / WSL 用户：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell 用户：

irm https://claude.ai/install.ps1 | iex

安装完后，输入下面命令验证：

claude --version

出现版本号就说明安装成功。

注意这里有个坑：部分 Windows 用户安装后需要重启终端，不然命令识别不了。

3. 配置第三方模型接入（核心步骤）

默认情况下，Claude Code 只认 Anthropic 官方模型，但我们能通过环境变量让它访问 OpenAI Hub 的兼容接口。

想象一下，你在家门口装了一个“快递柜”，Claude 原本只往官方柜投件，现在我们告诉它你的柜子其实在 Hub 上。

在终端配置环境变量：

macOS / Linux：

export ANTHROPIC_BASE_URL=https://api.openai-hub.com
export ANTHROPIC_API_KEY=sk-your-api-key
export ANTHROPIC_MODEL=claude-3-opus

Windows PowerShell：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.openai-hub.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-your-api-key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-3-opus", "User")

然后关闭终端重新打开，让配置生效。

注意这里有个坑：如果你之前跑过 claude 登录过官方账号，要执行 /logout 清理旧会话，否则会冲突。

4. 创建本地配置文件（可选但推荐）

Claude Code 安装后会在用户目录下创建一个 .claude 文件夹。 如果没有，自己建一个配置文件：

Windows： C:\Users\你的用户名\.claude\config.json

macOS / Linux： ~/.claude/config.json

写入内容：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.openai-hub.com",
    "ANTHROPIC_API_KEY": "sk-*****"
  }
}

这样做的好处是每次启动就不用重复设置环境变量。

5. 启动 Claude Code

进入你的项目目录，运行：

claude

第一次启动会提醒登录，直接跳过就行，它会自动使用你配置的 API。

看到 Claude Code 的 CLI 界面并能响应输入，就说明你已经成功接入了 OpenAI Hub。

6. 常见问题与排查

• 如果提示找不到模型，检查模型名称是否拼写正确（OpenAI Hub 兼容官方命名，比如 claude-opus-4-6、claude-sonnet-4-6 等）
• 如果提示密钥错误，确认你在 OpenAI Hub 控制台生成的是有效的 Key
• 如果运行 claude doctor 显示网络异常，一般是终端没重启或环境变量没生效

搞完这些你就可以直接在本地用 Claude Code 辅助写代码了。

下一步可以试试

把 Claude Code 接入 VSCode，装个插件后直接在编辑器里用 AI 生成或重构代码，体验会比 CLI 更爽。