Windows WSL 环境下配置 Claude Code 非官方账号完整教程

这里的 2233.ai为第三方API账号举例,可以解决国内很多小伙伴无法完成充值的问题。

重要提示 ️

当 Claude Code 在 Windows 环境下通过 WSL 运行时,必须在 WSL 环境中使用 Linux 命令设置环境变量,在 Windows PowerShell 中设置是无效的!


第一步:安装 Claude Code

1. 进入 WSL 环境

wsl

2. 安装 Node.js(如果未安装)

# 检查版本
node --version
npm --version

3. 安装 Claude Code

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

4. 验证安装

claude --version

第二步:配置 API 密钥和服务地址(关键步骤)

方法一:永久配置(推荐)

# 1. 添加环境变量到 ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://aicoding.2233.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc

# 2. 重新加载配置
source ~/.bashrc

方法二:临时配置(仅当前会话)

export ANTHROPIC_BASE_URL="https://aicoding.2233.ai"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

方法三:使用配置文件

# 创建配置目录
mkdir -p ~/.config/claude-code

# 创建配置文件
nano ~/.config/claude-code/config.json

添加内容:

{
  "apiKey": "你的API密钥",
  "baseURL": "https://aicoding.2233.ai"
}

第三步:验证配置是否生效

1. 启动 Claude Code

cd /path/to/your/project
claude

2. 使用 /status 命令检查配置

在 Claude Code 中输入:

> /status

正确配置的输出示例:

────────────────────────────────────────────────────
 Settings:  Status   Config   Usage
 Version: 2.0.14
 Session ID: a64a5f70-9a7c-4d7d-b93c-bc705082876a
 cwd: /mnt/d/PycharmProjects/主力资金
 Auth token: ANTHROPIC_AUTH_TOKEN 
 Anthropic base URL: https://aicoding.2233.ai 
 Model: opus (claude-opus-4-1-20250805)
────────────────────────────────────────────────────

关键检查点:

  • Auth token 显示为 ANTHROPIC_AUTH_TOKEN
  • Anthropic base URL 显示为 https://aicoding.2233.ai

常见错误示例

错误 1:在 PowerShell 中设置环境变量

#  这在 WSL 中无效!
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aicoding.2233.ai", [System.EnvironmentVariableTarget]::User)

错误 2:使用 PowerShell 语法

#  这是 PowerShell 语法,bash 不支持
$env:ANTHROPIC_BASE_URL = "https://aicoding.2233.ai"

完整操作流程

# 1. 从 Windows PowerShell 进入 WSL
wsl

# 2. 配置环境变量
echo 'export ANTHROPIC_BASE_URL="https://aicoding.2233.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-ant-xxxxx"' >> ~/.bashrc
source ~/.bashrc

# 3. 进入项目目录
cd /mnt/d/PycharmProjects/你的项目

# 4. 启动 Claude Code
claude

# 5. 验证配置
> /status

其他有用命令

# 查看当前环境变量
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

# 编辑配置文件
nano ~/.bashrc

# 重新加载配置
source ~/.bashrc

# 查看 Claude Code 帮助
claude --help

注意事项

  1. API 密钥安全:不要将 API 密钥提交到 git 仓库
  2. 路径访问:WSL 可以访问 Windows 文件系统(/mnt/c/, /mnt/d/ 等)
  3. 权限警告/status 中的权限警告通常不影响正常使用
  4. 配置验证:每次配置后都应该用 /status 命令验证

参考资料

  • 官方文档:docs.claude.com/en/docs/cla…
  • 2233.ai 教程:2233.ai/aicoding/cc…
本站提供的所有下载资源均来自互联网,仅提供学习交流使用,版权归原作者所有。如需商业使用,请联系原作者获得授权。 如您发现有涉嫌侵权的内容,请联系我们 邮箱:[email protected]