AiCodeCat Docs

主题

1. 安装 Node.js ​

最低要求：Node.js >=18（建议 LTS）。

方法一：官网下载 ​

访问 Node.js官网 下载 LTS 版本，双击安装包并按向导完成安装。

方法二：Homebrew 安装（推荐） ​

bash
brew install node

验证安装 ​

bash
node --version
npm --version

2. 安装 AiCodeCat ​

bash
npm install -g @anthropic-ai/claude-code

验证安装：

bash
claude --version

3. 配置 API 连接 ​

方法一：配置文件（推荐） ​

在用户目录下创建 .claude 文件夹和 settings.json 配置文件：

配置文件路径：

~/.claude/settings.json

配置内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://aicode.cat"
  }
}

创建步骤

bash
# 创建 .claude 目录（如已存在则跳过）
mkdir -p ~/.claude

# 创建并编辑配置文件
nano ~/.claude/settings.json

将上述配置内容粘贴到文件中并保存（Ctrl+O 保存，Ctrl+X 退出）。

方法二：环境变量 ​

如果不想使用配置文件，也可以通过环境变量配置：

临时设置（当前终端） ​

export ANTHROPIC_BASE_URL="https://aicode.cat"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

永久设置 ​

将以下内容写入 ~/.zshrc（或你的 shell 配置文件）：

export ANTHROPIC_BASE_URL="https://aicode.cat"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

保存后执行：

bash
source ~/.zshrc

WARNING

请将"你的API密钥"替换为用户仪表盘中创建的实际密钥。

重启提示

配置完成后需要重启终端才能生效。如果在 VS Code / Cursor 等 IDE 的集成终端中使用，需要彻底重启整个 IDE（不只是重启终端），否则配置可能不会生效。

VSCode 插件配置（可选） ​

如果使用 VSCode 的 Claude 插件，需要额外配置插件认证文件：

配置文件路径：

~/.claude/config.json

配置内容：

json
{
  "primaryApiKey": "any"
}

创建步骤

bash
# 创建 .claude 目录（如已存在则跳过）
mkdir -p ~/.claude

# 创建并编辑配置文件
nano ~/.claude/config.json

将上述配置内容粘贴到文件中并保存（Ctrl+O 保存，Ctrl+X 退出）。

WARNING

注意：这是 VSCode 插件专用的配置文件（config.json），与 Claude Code 命令行工具的配置文件（settings.json）是两个不同的文件。

4. 开始使用 ​

bash
claude

可运行 claude --help 查看命令说明。

5. 常见问题排查 ​

问题 1：Unable to connect to Anthropic services ​

症状： 启动 Claude Code 后提示无法连接到 Anthropic 服务。

解决方案：

这个问题通常是因为首次启动引导未完成。需要在用户根目录创建 .claude.json 文件并跳过引导流程：

配置文件路径：

~/.claude.json

配置内容：

json
{
  "hasCompletedOnboarding": true
}

创建方法：

bash
cat > ~/.claude.json << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF

验证文件已创建：

bash
cat ~/.claude.json

重启 Claude Code 即可。

调试技巧

如果配置后仍然无法连接，可以：

  1. 检查网络连接是否正常
  2. 重启终端或 IDE 后再次尝试
  3. 确认 API Key 配置正确（参考上面"3. 配置 API 连接"章节）