1
系统要求
- Node.js 18+
- npm 9+
- Windows 10/11 / macOS / Linux
2
安装 Claude Code
bashnpm install -g @anthropic-ai/claude-code
验证:
bashclaude --version
3
配置环境变量
Claude Code 通过环境变量读取 API 配置。设置以下三个环境变量:
macOS / Linux(添加到 ~/.zshrc 或 ~/.bashrc)
bashexport ANTHROPIC_BASE_URL="https://linksapi.cn" export ANTHROPIC_AUTH_TOKEN="sk-你的_LinksAPI_令牌" export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"
Windows(PowerShell)
powershell[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://linksapi.cn", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的_LinksAPI_令牌", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5-20250929", "User")
注意 Base URL 不带 /v1 后缀,Claude Code 会自动拼接路径。
4
启动 Claude Code
关闭并重新打开终端使环境变量生效,然后在项目目录运行:
bashcd 你的项目目录 claude
首次启动会要求确认权限设置,按提示完成即可。
5
常用命令
# 询问代码相关问题
> 这个项目用了什么框架?
# 让 Claude 修改代码
> 给 src/api.ts 加上错误处理
# 跑命令并让 Claude 看结果
> 运行 npm test,根据失败的用例帮我修
# 创建新文件
> 写一个 Python 脚本,把 logs/ 目录下所有 .log 文件按日期归档6
模型切换
修改环境变量 ANTHROPIC_MODEL 可切换模型:
| 模型 ID | 适用场景 | 售价 / 1M tokens |
|---|---|---|
| claude-opus-4-7 | 复杂推理、大型代码重构 | $7.00 / $35 |
| claude-sonnet-4-5-20250929 | 日常开发、平衡性价比 ⭐ | $4.20 / $21 |
| claude-haiku-4-5-20251001 | 快速响应、简单任务 | $1.40 / $7 |
7
常见问题
Q: 401 Unauthorized?
检查 ANTHROPIC_AUTH_TOKEN 是否设对,并且不要写错变量名(Claude Code 用 AUTH_TOKEN 不是 API_KEY)。
Q: 模型超时?
把模型切换成更快的 claude-sonnet-4-5 或 claude-haiku-4-5。
Q: 想用 Opus 又怕贵?
开普通对话用 Sonnet,只在大型重构时手动切换到 Opus。可以在会话内输入 /model claude-opus-4-7 临时切换。