作为一个初学者的 Claude Code 配置踩坑记录

折腾了两天,踩了三个坑,在 AI 辅助下终于把 Claude Code 跑通了。这篇记录了我的完整配置过程和避坑方法,希望能帮到和我一样的初学者。

一、我为什么折腾这个

我是一名建筑室内设计专业的大专生,对电脑数码很感兴趣。最近在学习用 AI 辅助设计,听说 Claude Code 能让 AI 直接改代码、分析文件,就想试试。虽然全程有 AI 辅助,但中间也踩了不少坑,所以写篇文章记录一下,也希望能够帮到和我一样的人。

二、我的环境

  • Windows 10/11
  • 已安装 Node.js 和 Python
  • API 来源:DeepSeek 官方

三、踩坑记录与避坑方法

坑1:官方安装脚本报错

  • 现象:用官方的 irm ... | iex 命令安装,出现一堆看不懂的报错

  • 原因:国内网络环境导致下载到了错误的内容

  • 解决办法:改用 npm 安装 npm install -g @anthropic-ai/claude-code

坑2:启动后连不上 Anthropic 服务

  • 现象:安装成功,但运行 claude 后提示 ERR_BAD_REQUEST

  • 原因:需要配置第三方 API 中转

  • 解决办法:在 ~/.claude/settings.json 里配置 DeepSeek 的 API 信息

坑3:用 /v1 地址不兼容

  • 现象:模型报错"不存在或没有权限"

  • 原因:/v1 地址只兼容 OpenAI 协议,Claude Code 说的是 Anthropic 语言

  • 解决办法:把地址改成 https://api.deepseek.com/anthropic

四、我的最终配置文件

json 复制代码
{
  "env": {
      "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
      "ANTHROPIC_AUTH_TOKEN": "你的API-Key",
      "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
      "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
      "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash"
  }
}

|注意|:把你的API-Key 替换成你自己的,千万别把真实 Key 发出来!

五、总结与杂谈

大体看下来配置过程其实并不复杂(我在ai的辅助下),主要是地址要写对,之所以用DeepSeek主要有两点,第一价格很便宜,第二我是学生党嘛>嗯....怎么说呢,作为一个非计算机专业的学生,能在 AI 辅助下完成这件事,挺有成就感的,配了两天,在终于跑通的那一刻我才真正体会到ai的强大之处.之前我只是在对话框里对ai进行询问,让他帮我提资料修改的意见等等 后面呢我打算把我是如何在vscode里用claude插件以及用cc来切换其他模型api的实践过程也写篇文章记录下来

(本文同步自 CSDN,首次发布于一个初学者的 Claude Code 配置踩坑记录-CSDN博客


后记:作为初学者,这篇文章有很多不足之处,在后面的写作与实践中我会不断的去学习和改善,也望各位对我进行指导与批评,我写文章的最大出发点是记录,如果有幸能够帮到您,我会非常开心

相关推荐
码哥字节21 小时前
别再纠结 24 万星 Superpowers 还是 5.8 万星 OpenSpec,有人把他们融合成一个工作流在 Github 开源
ai编程·claude
武子康1 天前
OpenAI Workspace Agents 进入信用计费:Coding Agent 从额度体验走向成本治理
人工智能·openai·claude
LYFlied2 天前
Anthropic Agent隔离架构解读:比权限弹窗更可靠的是限制爆炸半径
人工智能·架构·软件工程·claude·安全架构·ai agent
凌奕2 天前
Claude Code 上线了"一键发网页"功能:报告做完直接甩链接,部署这一步彻底消失
html·claude
ServBay2 天前
你还在手写 Prompt?聪明的人早就用上了循环工程,AI 的自动驾驶时代来了
ai编程·claude·mcp
故乡de云2 天前
gemini-3-pro-preview 调用 generateContent 完整配置与排错:REST / Python SDK / Code0 兼容接入
人工智能·大模型·api·claude
sg_knight2 天前
Claude Code 安装指南(macOS / Linux / Windows WSL)
linux·windows·macos·claude·code·anthropic·claude-code
nuIl3 天前
我把 5 个编码 Agent 塞进了一个 npm 包
前端·agent·claude
kyriewen3 天前
一个看不见的撇号,让Claude Code追踪了中国开发者三个月
前端·ai编程·claude