在 VS Code 内通过终端运行 Claude Code,并接入 AI Click 的 Anthropic 兼容网关。适合用 Claude 直接读取项目、改代码、跑测试和做代码审查。
核心参数
Gateway https://ai.aiclick.cc
Protocol Anthropic Messages
Model claude-sonnet-4-6 / claude-opus-4-8
Tool VS Code Terminal + claude CLI
开始前准备
Claude Code 本质是一个命令行工具。VS Code 里的最佳用法,是在项目根目录打开集成终端,然后运行 claude。
1
安装 Node.js
Claude Code 通过 npm 安装,建议 Node.js 18+。
node -v
npm -v
2
准备中转 Key
在 AI Click 后台生成 API Key。
Key 使用中转站生成的 sk- 开头密钥
3
选择模型
日常用 Sonnet,复杂任务用 Opus。
日常 claude-sonnet-4-6
复杂 claude-opus-4-8
安装 Claude Code
在 VS Code 终端或系统终端执行都可以。安装完成后先检查版本和健康状态。
NPM
全局安装
这是官方 CLI 的常用安装方式。
npm install -g @anthropic-ai/claude-code
claude --version
claude doctor
Check
确认命令可用
如果找不到 claude,通常是 npm global bin 没进 PATH。
which claude
claude --help
Windows PowerShell 可用 where claude 检查。
配置 AI Click 中转站
Claude Code 走 Anthropic 兼容环境变量。把 Key 和 Base URL 写进 shell profile,重开 VS Code 后生效。
mac
macOS / Linux
先在当前终端测试,再写入 zshrc。
export ANTHROPIC_API_KEY="这里换成你申请的 KEY"
export ANTHROPIC_BASE_URL="https://ai.aiclick.cc"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_API_KEY="这里换成你申请的 KEY"
export ANTHROPIC_BASE_URL="https://ai.aiclick.cc"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
EOF
source ~/.zshrc
Win
Windows PowerShell
用户级环境变量,重启 VS Code 后生效。
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "这里换成你申请的 KEY", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://ai.aiclick.cc", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-6", "User")
设置后关闭所有 VS Code 窗口,再重新打开项目。
Models
可选模型
如果需要更强能力,把 ANTHROPIC_MODEL 换成下面任意一个。
Haiku claude-haiku-4-5
Sonnet claude-sonnet-4-5 / claude-sonnet-4-6
Opus claude-opus-4-5 / claude-opus-4-6 / claude-opus-4-7 / claude-opus-4-8
Thinking claude-opus-4-6-thinking
在 VS Code 中使用
重点是从项目根目录启动 Claude Code,这样它才能读取当前项目文件、运行命令和理解工程结构。
1
打开项目根目录
不要只打开单个文件。
- 1VS Code 选择 File -> Open Folder。
- 2打开你的项目根目录。
- 3打开集成终端:Terminal -> New Terminal。
2
启动 Claude Code
第一次进入目录可能会询问是否信任项目,选择 Yes。
claude
- 1出现 trust folder 提示时,选择信任。
- 2进入 Claude 交互界面后,先发一个小任务测试。
常用方式
Claude Code 支持交互模式和一次性 print 模式。VS Code 日常开发建议优先用交互模式。
Chat
交互模式
适合连续改代码、跑测试、追问。
先阅读这个项目结构,告诉我主要模块和启动命令。
帮我检查当前代码有没有明显 bug,但先不要修改文件,先给方案。
一次性任务
适合快速问答、脚本化分析。
claude -p "总结这个项目的目录结构和启动方式" --max-turns 3
claude -p "只读模式审查 src 目录里的安全问题" --allowedTools "Read" --max-turns 5
常见问题排查
大部分问题集中在环境变量、Base URL、模型名和 VS Code 没重启。
401
Key 无效
API Key 错误或没有被 VS Code 终端读取。
- 执行 echo $ANTHROPIC_API_KEY 或 PowerShell 的 $env:ANTHROPIC_API_KEY
- 确认 Key 没有多余空格和引号
- 确认中转站后台 Key 状态可用
404
URL 路径不对
Claude Code 不使用 Chat Completions 完整路径。
- ANTHROPIC_BASE_URL 使用 https://ai.aiclick.cc
- 不要写成 /v1/chat/completions
- 如果后台给了专门 Anthropic URL,以后台为准
ENV
环境变量不生效
VS Code 启动时会继承系统环境变量。
- 设置环境变量后关闭所有 VS Code 窗口
- 重新打开项目,再打开新终端
- 在终端里用 env | grep ANTHROPIC 检查