Claude Code官方推出的 AI 编程助手命令行工具,可以在 MacOS 和 Linux 系统上直接安装使用(Windows环境安装需查阅其他资料操作)。
添加图片注释,不超过 140 字(可选)
本手册将教您在MAC和Linux系统中安装Claude,并让其接入其他API平台,以使用包括DeepSeek、Qwen、Kimi 等在内的 AI 模型。
在macOS中安装和使用Claude Code
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的重要步骤。
MacOS上配置环境变量有多种方式:
3.1 使用 .bash_profile 或 .zshrc(推荐)
- 如果您使用的是Zsh(Z-shell,macOS Catalina及以后版本默认):
echo 'export ANTHROPIC_BASE_URL="http://codingplan.cn/v1"' >> ~/.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="http://codingplan.cn/v1"' >> ~/.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="http://codingplan.cn/v1"
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
正常结果:
http://codingplan.cn/v1
您的TokenPony API Key
您选择的模型名称
您选择的模型名称
4 开始使用Claude Code
完成上述配置后,您就可以在国内使用Claude Code了。
在终端中创建并进入你的项目目录:
mkdir your-project-name
cd your-project-name
启动Claude Code:
claude
特别提醒: · Claude Code中配置的请求地址为
,而非TokenPony常规的请求地址
· 您可以在 控制面板 中获取API Key。 · 您可以在 模型列表 中选择您要使用的模型。
如有任何问题,请随时留言,我会无偿为大家解决