Claude Code是Anthropic官方推出的 AI 编程助手命令行工具,可以在 MacOS 和 Linux 系统上直接安装使用(Windows环境安装需查阅其他资料操作)。但在国内网络情况下,无法直接使用。并且,Claude价格还是有点贵,替换方案就是用官方的Claude Code,集合成本更低的DeepSeek v3.1、Qwen Coder等模型来使用。
下面以macOS为例,告诉大家如何安装和使用Claude Code,并对接第三方模型。(如果已经有Claude,可以直接跳到 第3步 配置环境变量)
1 安装 Node.js 环境
Claude Code需要Node.js环境才能运行。MacOS上有多种安装 Node.js 的方式:
1.1 官方安装包(推荐)
-
打开浏览器访问 nodejs.org
-
下载 macOS 版本的安装包 (.pkg)
-
运行下载的安装包,按照向导完成安装
-
打开终端(Terminal)验证安装:
node --version
npm --version
如果显示正确的版本号,则说明安装成功。
1.2 使用Homebrew安装
如果您已经安装 Homebrew,您可以通过以下命令安装:
brew installnode
2 安装Claude Code程序
默认情况下,原版Claude Code无法在国内网络环境中使用。现在您可以通过TokenPony来正常使用Claude Code,但无法使用Claude官方模型,只能使用TokenPony提供的各类AI模型进行替代。
在终端中以全局方式安装Claude Code官方原版程序:
npm install -g @anthropic-ai/claude-code
3 配置环境变量(重要)
这个步骤非常重要,是您可以在国内正常使用Claude Code的重要步骤。直接使用DeepSeek、Qwen的API,会因为和Claude的协议不同,导致无法使用,这里推荐使用国内的小马算力 TokenPony.cn 的大模型API服务,官方提供了兼容claude的API,用 api-claude.tokenpony.cn + 平台的API Key 就可以直接在Claude Code里使用各类大模型。
打个小广告,通过 tokenpony.cn/jDoJO 注册可以拿到20元体验金,加上平台百万Token的价格基本是市场价的8折,相当于送了200多万的Tokens,可以体验下。
言归正传,MacOS上配置环境变量有多种方式:
3.1 使用 .bash_profile 或 .zshrc(推荐)
- 如果您使用的是Zsh(Z-shell,macOS Catalina及以后版本默认):
echo 'export ANTHROPIC_BASE_URL="https://api-claude.tokenpony.cn"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的TokenPony API Key"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="替换为您选择的模型名称"' >> ~/.zshrc
echo 'export ANTHROPIC_SMALL_FAST_MODEL="替换为您选择的模型名称"' >> ~/.zshrc
source ~/.zshrc
- 如果您使用的是bash(较老的macOS版本):
echo 'export ANTHROPIC_BASE_URL="https://api-claude.tokenpony.cn"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的TokenPony API Key"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="替换为您选择的模型名称"' >> ~/.bash_profile
echo 'export ANTHROPIC_SMALL_FAST_MODEL="替换为您选择的模型名称"' >> ~/.bash_profile
source ~/.bash_profile
3.2 手动编辑配置文件
3.2.1 使用文本编辑器打开配置文件:
- Zsh(Z-shell)用户
open -e ~/.zshrc
- bash用户
open -e ~/.bash_profile
3.2.2 在文件末尾添加:
export ANTHROPIC_BASE_URL="https://api-claude.tokenpony.cn"
export ANTHROPIC_AUTH_TOKEN="替换为您的TokenPony API Key"
export ANTHROPIC_MODEL="替换为您选择的模型名称"
export ANTHROPIC_SMALL_FAST_MODEL="替换为您选择的模型名称"
3.2.3 保存文件后重新加载配置:
- Zsh(Z-shell)用户
source ~/.zshrc
- bash用户
source ~/.bash_profile
3.2.4 验证环境变量
在终端中验证环境变量是否设置成功:
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_MODEL
echo $ANTHROPIC_SMALL_FAST_MODEL
正常结果:
https://api-claude.tokenpony.cn
您的TokenPony API Key
您选择的模型名称
您选择的模型名称
4 开始使用Claude Code
完成上述配置后,您就可以在国内使用Claude Code了。
在终端中创建并进入你的项目目录:
mkdir your-project-name
cd your-project-name
启动Claude Code:
claude
然后就可以流畅的使用Claude Code了。