AxiomCode 文档

主题

3.2 Claude Code 系列 ​

适用于：Claude Code CLI、Claude Code 的 VSCode 插件 / IDE 集成。 两者都通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 两个变量定位 AxiomCode。

一、需要准备的配置 ​

  • Base URL：https://axiomcode.top
  • API Key：sk-你的Key

注意

Claude Code 走 Anthropic 协议，Base URL 不要带 /v1，否则会 404。这与 Codex 是不一样的。

二、Claude Code CLI ​

2.1 安装 CLI ​

bash
# 推荐通过 npm 安装
npm install -g @anthropic-ai/claude-code
# 验证
claude --version

2.2 配置环境变量 ​

macOS / Linux：在 ~/.zshrc / ~/.bashrc 末尾加入：

bash
export ANTHROPIC_API_KEY="sk-axiom-你的Key"
export ANTHROPIC_BASE_URL="https://axiomcode.top"

保存后执行 source ~/.zshrc。

Windows PowerShell（永久生效）：

powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-axiom-你的Key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://axiomcode.top", "User")

执行后关闭并重新打开终端。

2.3 启动并测试 ​

bash
cd path/to/your/project
claude

第一次启动会让你确认目录信任，按提示选 Yes。然后输入：

text
帮我看看 README.md，并给项目目录结构画一个简图

模型能正确读取仓库文件并给出回答，就表示接入成功。

2.4 settings.json 写法（可选） ​

如果你不想动系统环境变量，也可以把配置写进 Claude Code 的用户设置：

  • macOS：~/Library/Application Support/Claude/settings.json
  • Linux：~/.config/claude/settings.json
  • Windows：%APPDATA%\Claude\settings.json
json
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-axiom-你的Key",
    "ANTHROPIC_BASE_URL": "https://axiomcode.top"
  }
}

保存后重启 claude 即可。

三、Claude Code VSCode / IDE 插件 ​

Claude Code 的 IDE 集成（VSCode、JetBrains）是 CLI 的"前端"。一旦上面的 CLI 跑通，IDE 插件自然就能用。

  1. 在 VSCode 扩展商店搜索 Claude Code 安装。
  2. 安装后插件会自动检测系统里的 claude CLI，不需要再单独填 Key 和 URL。
  3. 通过快捷键 Ctrl/⌘+Esc 唤起 Claude Code 面板。

如果插件提示「未找到 Claude CLI」

说明 VSCode 启动时还没拿到环境变量。在 Windows 上常见原因是设过 setx 但没重启 VSCode。解决：

  1. 完全退出 VSCode（包括托盘进程）。
  2. 重新打开。
  3. 仍不行的话，在终端里 which claude / where claude 确认 CLI 在 PATH 里。

四、模型选择 ​

Claude Code 默认会用 claude-sonnet-4-x 之类的型号。如果你想固定使用某个模型，可以在工程目录新建 .claude/config.json：

json
{
  "model": "claude-sonnet-4-6"
}

或者在 settings.json 里加 "model": "..."。账号开放的模型列表见控制台密钥页 → 接入配置弹窗。

五、常见问题 ​

Q：CLI 启动时报 connection refused / SSL error？ 检查 ANTHROPIC_BASE_URL 是否带了多余的 /v1 或者末尾斜杠 —— 应该写成 https://axiomcode.top。

Q：能不能跟 Anthropic 官方账号同时切换使用？ 能。把环境变量改回官方的 https://api.anthropic.com 并换 Key 即可。建议用一个简单的 shell 函数或 direnv 来在不同项目之间切换。

Copyright © 2026 AxiomCode