Claude Code 是一个运行在终端里的 AI 编程助手。
Claude Code 是基于 Node.js 的命令行工具,必须先装好它。
1)Windows
node -v
如果显示版本号(如 v20.11.0),说明安装成功。
2)macOS
3)Linux
# Ubuntu / Debian
sudo apt update && sudo apt install -y nodejs npm
# CentOS / RHEL
sudo yum install -y nodejs npm
# 也可以用 nvm(推荐,灵活切版本)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
验证:终端输入 node -v,显示版本号即成功。
| 系统 | 操作 |
|---|---|
| Windows | 按 Win + R,输入 powershell,回车 |
| macOS | 打开"启动台"→"其他"→"终端"(或搜索"Terminal") |
| Linux | 直接打开系统自带的终端 |
在终端里执行以下命令(三平台命令完全相同,直接复制粘贴):
npm install -g @anthropic-ai/claude-code
等待安装完成(约 1~2 分钟)。然后验证:
claude --version
显示版本号即安装成功。如果提示"不是内部或外部命令",说明 Node.js 没装好或没重启终端,回到前面重装 Node.js。
Windows版本:如果提示”程序’claude.exe’无法运行:拒绝访问。“,则在命令前增加sudo前缀。
| 对比维度 | 方式一 settings.json(推荐) | 方式二 Windows 注册表 | 方式三 shell 配置文件 | 方式四 临时变量 |
|---|---|---|---|---|
| API Key是否落入终端历史 | 否(在编辑器里粘贴) | 是 | 是 | 是 |
| API Key存放位置 | 单个 JSON 文件 | 注册表 | .zshrc/.bashrc | 进程内存 |
| 生效范围 | 全部项目 | 全部项目 | 全部项目 | 仅当前窗口 |
| 重开终端后是否生效 | 是 | 是 | 是 | 否 |
| 清除凭据难度 | 删一个文件即可 | 逐条清理注册表 | 逐行删配置 | 关窗即清 |
结论:优先用方式一,安全、集中、好清理;方式四仅用于快速测试。方式之间不要重复配置同名变量,换方式时先清掉旧配置。
1)方式一:用户级 settings.json(推荐)
配置文件位置:
| 系统 | 文件路径 |
|---|---|
| Windows | C:\Users\你的用户名\.claude\settings.json |
| macOS | ~/.claude/settings.json |
| Linux | ~/.claude/settings.json |
.claude 文件夹或 settings.json 不存在时,手动新建即可。用记事本、VS Code 等任意编辑器打开该文件,粘贴以下模板内容:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api-maas.teleai.com.cn/v1",
"ANTHROPIC_AUTH_TOKEN": "把这里替换成你的API Key",
"ANTHROPIC_MODEL": "TeleChat3-438B-A24B",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "TeleChat3-438B-A24B",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "TeleChat3-438B-A24B",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "TeleChat3-438B-A24B",
"CLAUDE_CODE_SUBAGENT_MODEL": "TeleChat3-438B-A24B",
"CLAUDE_CODE_EFFORT_LEVEL": "max",
"CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT": "1"
}
}
修改两处:
修改并保存后,新启动的 claude 自动加载,无需重启终端;已开着的 claude 会话需退出重进一次。
2)方式二:Windows 环境变量(写入注册表,永久生效)
打开 PowerShell,整段复制以下 9 行回车执行(先把 API Key 替换好):
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api-maas.teleai.com.cn/v1", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "把这里替换成你的API Key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "TeleChat3-438B-A24B", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "TeleChat3-438B-A24B", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "TeleChat3-438B-A24B", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "TeleChat3-438B-A24B", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_SUBAGENT_MODEL", "TeleChat3-438B-A24B", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_EFFORT_LEVEL", "max", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT", "1", "User")
写入注册表后,必须关闭当前终端,重新打开才能生效。
安全提醒:此命令会带着 API Key 进入 PowerShell 历史文件(%APPDATA%\Microsoft\Windows\PowerShell\PSReadLine\ConsoleHost_history.txt),介意的话请用方式一。
在终端逐行执行以下命令(先把 API Key 替换好;bash 用户把 .zshrc 全部换成 .bashrc):
echo 'export ANTHROPIC_BASE_URL="https://api-maas.teleai.com.cn/v1"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="把这里替换成你的API Key"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="TeleChat3-438B-A24B"' >> ~/.zshrc
echo 'export ANTHROPIC_DEFAULT_OPUS_MODEL="TeleChat3-438B-A24B"' >> ~/.zshrc
echo 'export ANTHROPIC_DEFAULT_SONNET_MODEL="TeleChat3-438B-A24B"' >> ~/.zshrc
echo 'export ANTHROPIC_DEFAULT_HAIKU_MODEL="TeleChat3-438B-A24B"' >> ~/.zshrc
echo 'export CLAUDE_CODE_SUBAGENT_MODEL="TeleChat3-438B-A24B"' >> ~/.zshrc
echo 'export CLAUDE_CODE_EFFORT_LEVEL="max"' >> ~/.zshrc
echo 'export CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT="1"' >> ~/.zshrc
source ~/.zshrc
API Key 会随命令进入终端历史(~/.zsh_history / ~/.bash_history),介意的话请用方式一。
Windows PowerShell:
$env:ANTHROPIC_BASE_URL="https://api-maas.teleai.com.cn/v1"
$env:ANTHROPIC_AUTH_TOKEN="把这里替换成你的API Key"
$env:ANTHROPIC_MODEL="TeleChat3-438B-A24B"
macOS / Linux:
export ANTHROPIC_BASE_URL="https://api-maas.teleai.com.cn/v1"
export ANTHROPIC_AUTH_TOKEN="把这里替换成你的API Key"
export ANTHROPIC_MODEL="TeleChat3-438B-A24B"
关闭终端即失效。需要 opus/sonnet/haiku 映射等其他变量时,参照方式一模板按需补齐。
| 配置方式 | 环境检查 | 说明 |
|---|---|---|
| 方式一 | 无需环境检查,直接做功能验证 | settings.json 的变量注入 claude 进程,echo 看不到是正常的 |
| 方式二 | 重开 PowerShell 后执行 echo$env:ANTHROPIC_AUTH_TOKEN | 输出API Key即生效 |
| 方式三 | 新开终端执行 echo$ANTHROPIC_AUTH_TOKEN | 输出API Key即生效 |
| 方式四 | 当前窗口直接做功能验证 | 关窗即失效 |
统一功能验证(最可靠):在任意终端执行
claude -p "回复:配置成功"
模型返回“配置成功”即表示配置生效。
"项目目录"就是你要让它帮你写代码的文件夹。
cd 你的文件夹路径
claude
比如你的代码在 D:\myproject,就输入 cd D:\myproject,再输入 claude 回车。
第一次启动可能需要确认一些提示,按提示输入 y 回车即可。启动后你就可以直接用自然语言和它对话了。
运行效果(启动后的界面长这样):
如果你已经安装了 Claude Code(正在用其他模型),只需修改环境变量即可切换到星辰模型,无需重装。
export ANTHROPIC_BASE_URL="https://api-maas.teleai.com.cn/"
export ANTHROPIC_AUTH_TOKEN="把这里替换成你的API Key"
export ANTHROPIC_MODEL="TeleChat3-438B-A24B"
export ANTHROPIC_DEFAULT_OPUS_MODEL="TeleChat3-438B-A24B"
export ANTHROPIC_DEFAULT_SONNET_MODEL="TeleChat3-438B-A24B"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="TeleChat3-438B-A24B"
export CLAUDE_CODE_SUBAGENT_MODEL="TeleChat3-438B-A24B"
export CLAUDE_CODE_EFFORT_LEVEL="max"
export CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT="1"
$env:ANTHROPIC_BASE_URL="https://api-maas.teleai.com.cn/"
$env:ANTHROPIC_AUTH_TOKEN="把这里替换成你的API Key"
$env:ANTHROPIC_MODEL="TeleChat3-438B-A24B"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="TeleChat3-438B-A24B"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="TeleChat3-438B-A24B"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="TeleChat3-438B-A24B"
$env:CLAUDE_CODE_SUBAGENT_MODEL="TeleChat3-438B-A24B"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
$env:CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT="1"
说明:以上是临时变量方式,关闭终端即失效,适合立即验证。
想长期生效请用下方「3.2.3 配置环境变量」的方式一(settings.json,推荐);
验证方法见「3.2.4 验证配置是否生效」小节。
"项目目录"就是你要让它帮你写代码的文件夹。
配置完成后,执行(把 D:\myproject 替换为你的项目路径)启动使用:
cd D:\myproject #你的文件夹路径
claude
比如你的代码在 D:\myproject,就输入 cd D:\myproject,再输入 claude 回车。
第一次启动可能需要确认一些提示,按提示输入 y 回车即可。启动后你就可以直接用自然语言和它对话了。
运行效果(启动claude后 ,界面如下图):