ハクソク

世界を動かす技術を、日本語で。

クラウドコードSDK

2025年5月20日原文(docs.anthropic.com)

概要

  • Claude Code SDK は、AIコーディングアシスタントをアプリに統合するための開発ツール。
  • CLI操作 をサポートし、TypeScriptとPython SDKは近日公開予定。
  • MCP構成 で外部ツールやリソースの拡張が可能。
  • 出力形式 はテキスト・JSON・ストリーミングJSONに対応。
  • GitHub Actions など、実際の開発フローへの組み込み事例あり。

Claude Code SDKの概要と活用方法

SDKの基本機能

  • Claude Code SDK は、アプリケーションから Claude Code をサブプロセスとして実行し、AIコーディングアシスタント機能を統合することが可能。
  • コマンドライン操作 に対応し、今後 TypeScript および Python SDK の提供を予定。
  • 非対話モード での利用が基本であり、アプリから直接Claude Codeを呼び出すことができるよう設計されていることを確認。

高度な利用法

  • マルチターン会話 ・セッションIDを指定して 会話の再開 や 直近のセッションからの継続 を行うことが可能。

  • カスタムシステムプロンプト ・独自の システムプロンプト を指定し、Claudeの挙動を制御することが可能。 ・デフォルトのプロンプトに 追加指示 を付与することも可能。

  • MCP（Model Context Protocol）構成 ・外部サーバーから 追加ツールやリソース をロードし、Claude Codeの機能を拡張するために利用。 ・--mcp-configフラグでJSON構成ファイルを指定し、 データベースアクセスやAPI連携 などの専門機能を追加。 ・ セキュリティ対策 として、--allowedToolsで利用可能ツールを明示的に許可することが必要。 ・MCPツール名はmcp__<serverName>__<toolName>形式で指定することを確認。

主なCLIオプション

  • --print, -p ：非対話モードで実行すること
  • --output-format ：出力形式（text, json, stream-json）を指定すること
  • --resume, -r ：セッションIDで会話を再開すること
  • --continue, -c ：最新の会話セッションを継続すること
  • --system-prompt ：システムプロンプトを上書きすること（--print時のみ）
  • --append-system-prompt ：システムプロンプトへ追加指示を付与すること（--print時のみ）
  • --allowedTools ：許可するツールをカンマまたはスペース区切りで指定すること（MCPツール含む）
  • --disallowedTools ：禁止するツールを指定すること
  • --mcp-config ：MCPサーバーのJSONファイルを読み込むこと
  • --permission-prompt-tool ：許可プロンプト処理用のMCPツールを指定すること（--print時のみ）
  • --verbose ：詳細ログを有効化すること
  • --max-turns ：非対話モードでのエージェントターン数を制限すること

出力形式とレスポンススキーマ

  • テキスト出力 （デフォルト）：応答テキストのみを返すこと
  • JSON出力 ：メタデータを含む構造化データを返すこと
  • ストリーミングJSON出力 ：各メッセージを受信ごとにJSONオブジェクトとして出力すること ・各会話はinitメッセージで始まり、ユーザー・アシスタントメッセージ、最終結果メッセージで構成されること
  • メッセージスキーマ ：JSON APIのレスポンスは厳密に型定義されており、今後JSONSchema形式で公開予定
  • セマンティックバージョニング を採用し、互換性の変更を明示すること

利用例とベストプラクティス

  • シンプルなスクリプト統合 や ファイル処理、 セッション管理 などの実装例あり
  • JSON出力形式 を利用し、プログラムによるレスポンス解析を推奨
  • エラー処理 （exitコードやstderrの確認）を徹底すること
  • マルチターン会話 ではセッション管理を活用すること
  • 長時間処理 にはタイムアウト設定を検討すること
  • レートリミット への配慮として、複数リクエスト時は遅延を入れること

実際の開発フローへの応用

  • Claude Code SDK は、開発ワークフローへの強力な統合を実現 ・例： Claude Code GitHub Actions による自動コードレビュー、PR作成、Issueトリアージの自動化
  • CLIドキュメント や GitHub Actions連携、 チュートリアル も提供されており、幅広いユースケースに対応

参考情報

  • CLI操作とコントロール ：公式ドキュメントで全オプションを確認すること
  • GitHub Actions統合 ：自動化ワークフローの構築に活用すること
  • チュートリアル ：一般的なユースケースの手順を学習すること

Hackerたちの意見

claude codeチームからのさらなるコンテキスト: http://latent.space/p/claude-code トランスクリプトをざっと読むことができるけど、個人的なハイライトは以下の通り: - アンスロピックの社員は、無制限のclaudeを使って、平均で1日あたり$6の使用量 - ヘッドレスclaudeコードは、CIでどこでも使える「Linux」ユーティリティとしてかなり魅力的 - ユーザー拡張可能なプラットフォームとしてのclaudeコード - claudeコードの今後のロードマップ: サンドボックス、ブランチ、プランニング - ソネット3.7は持続的でエージェント的なモデル

└

もしかしたら使い方が悪いのかもしれないけど、Claude Codeを2時間使うだけで$20以上使っちゃうことがある。個人プロジェクトには高すぎるから、使うのをやめたよ。

└

"- アンスロピックの社員は、無制限のclaudeを使って、平均で1日あたり$6の使用量" リンクから: "どうやら、アンスロピックの中には1日に$1,000以上使ったエンジニアもいるらしい！" 質問は、従業員あたりのP50、P75、P95の支出はどれくらいか？

└

最近のlatent spaceポッドキャストは本当に楽しんでる。あなたの一般的なアウトプットに対して高いSNRを維持しながら近づいている人†/ポッドキャスト（または他のコンテンツ）はないと思う。過去の（半？）10年間で生み出している公の仕事の量と価値に、常に驚かされている。さまざまなビジネスを成長させながら、他の人も同じような生産性の勾配を見つけられることを願っている。あなたが何がうまくいくかを大まかに共有しているのは知っているけど、それを再現するのはそんなに簡単じゃない。† simonw, gwern

└

ポッドキャストは中立的だったのか、それともこれのセールスピッチみたいだったの？

Claude Codeの進化は、まさに僕が求めていたエージェント的なコーディングツールの「Unixツール的」哲学そのもの。最初のパブリックプレビューリリースから使っていて、時間とともに方向性を見てきた。コーディングエージェントの「ゴールデン」な最終形は、機能リクエスト（例えばJiraチケット）を出すと、レビューとフィードバックを求めるPRを返してくれること。Cursorやwindsurfなどは、ローカルエディタでCIには使えないから、その意味では行き止まりだよ。AIを最適に使うためにコードベースを整えるなら（ルール、MCPなど）、ヘッドレス使用への橋渡しができる技術を目指すべき。Claude Codeがツールの一部として自動化に簡単に使えるという事実は、今やコーディングエージェントについて考えるデフォルトの方法になってる（Codex、npmパッケージも同じ）。注意点として、僕は企業がエージェント利用に最適なコードベースを整える手助けをしているから、簡単に設定できるツールに偏りがあるかもしれない。

└

そのゴールデンな最終形についてはよくわからないな。僕の理想は、AIエージェントがコーディング、デザイン、テストなどをしているスクリーンに囲まれた部屋にいること。真ん中にいて、指導したり方向性を示したり、センスを適用したりする…会話だけで、99%の時間はキーボードに触れなくてもいい。それが僕が望んでいることで、いつか実現するのを楽しみにしてる。

└

Anthropicも今日、ベータ版でそんな感じのことを発表したよ: https://docs.anthropic.com/en/docs/claude-code/github-action...

└

もうそれできるんじゃない？Aider CLIをissue作成でトリガーされるGitHubアクションに入れれば、すぐに使えるよ。

└

機能リクエストを提出して、レビュー待ちのPRを受け取るっていうビジョンは、戦略管理の観点から見ると魅力的でもあり、恐ろしいことでもあるね。Anthropicや他の大手テック企業と同じように、彼らは本当に必要になるまで最高のものを見せたくないんだ。以前はクールな機能をストックして、戦略を考える時間があったけど、今はすべてを急いで見せようとしている気がして、経営陣が全体像を考える時間があるのか心配になってる。

└

Jiraチケットの作業をAIにアウトソースできるようになって、実際に合理的なプルリクエストが出せるようになったら、多くの企業の管理者はオフショアチームを残す理由を真剣に考えるだろうね。

└

いや、違う。コーディングエージェントの「ゴールデン」な最終形は、私のマシン（または自分が望むマシン）で動く無料でオープンソースのコーディングエージェントだよ。ターミナルで実行するたびにお金を払うなんて想像できる？lsやps、killのたびに？意味ないよね？LLMsも同じこと。私は「プロプライエタリなLLMsを禁止しろ」と言ってるわけじゃなくて、ハッカー（こういうサイトを昔読んでた人たち）は、主なツールとして無料でオープンソースのものを持つべきだと思うんだ。

Hacker Newsで議論の続きを見る