AIAI Click
Claude Code + VS Code / 中转站接入

VS Code 使用Claude Code

在 VS Code 内通过终端运行 Claude Code,并接入 AI Click 的 Anthropic 兼容网关。适合用 Claude 直接读取项目、改代码、跑测试和做代码审查。

开始前准备

Claude Code 本质是一个命令行工具。VS Code 里的最佳用法,是在项目根目录打开集成终端,然后运行 claude

1

安装 Node.js

Claude Code 通过 npm 安装,建议 Node.js 18+。

Terminal
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 的常用安装方式。

Terminal
npm install -g @anthropic-ai/claude-code
claude --version
claude doctor
Check

确认命令可用

如果找不到 claude,通常是 npm global bin 没进 PATH。

Terminal
which claude
claude --help
Windows PowerShell 可用 where claude 检查。

配置 AI Click 中转站

Claude Code 走 Anthropic 兼容环境变量。把 Key 和 Base URL 写进 shell profile,重开 VS Code 后生效。

mac

macOS / Linux

先在当前终端测试,再写入 zshrc。

Terminal
export ANTHROPIC_API_KEY="这里换成你申请的 KEY"
export ANTHROPIC_BASE_URL="https://ai.aiclick.cc"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
写入 ~/.zshrc
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 后生效。

PowerShell
[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 换成下面任意一个。

Haikuclaude-haiku-4-5
Sonnetclaude-sonnet-4-5 / claude-sonnet-4-6
Opusclaude-opus-4-5 / claude-opus-4-6 / claude-opus-4-7 / claude-opus-4-8
Thinkingclaude-opus-4-6-thinking

在 VS Code 中使用

重点是从项目根目录启动 Claude Code,这样它才能读取当前项目文件、运行命令和理解工程结构。

1

打开项目根目录

不要只打开单个文件。

  1. 1VS Code 选择 File -> Open Folder
  2. 2打开你的项目根目录。
  3. 3打开集成终端:Terminal -> New Terminal
2

启动 Claude Code

第一次进入目录可能会询问是否信任项目,选择 Yes。

VS Code Terminal
claude
  1. 1出现 trust folder 提示时,选择信任。
  2. 2进入 Claude 交互界面后,先发一个小任务测试。

常用方式

Claude Code 支持交互模式和一次性 print 模式。VS Code 日常开发建议优先用交互模式。

Chat

交互模式

适合连续改代码、跑测试、追问。

Claude Code Prompt
先阅读这个项目结构,告诉我主要模块和启动命令。
Claude Code Prompt
帮我检查当前代码有没有明显 bug,但先不要修改文件,先给方案。
Print

一次性任务

适合快速问答、脚本化分析。

VS Code Terminal
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 检查